Skip to content

Other AI Tools & Frameworks

Any tool that supports the MCP protocol can connect to FinPlan. Below are examples for common frameworks.

FinPlan requires a bearer token. Most frameworks don’t run FinPlan’s browser OAuth flow, so generate a manual API key first:

  1. Sign up at mcp.finplan.tools/auth/signup
  2. Signing up (or clicking the link in your confirmation email) opens a page showing your first key — copy it then. It starts with fp_live_ and lasts 90 days. To get another key later, sign in at /auth/login and click Generate New Token; if you’re at the 5-key limit, revoke an unused key in the list on that page first
  3. Export it so the examples below can pick it up: export FINPLAN_API_KEY=fp_live_...

Pass the token as Authorization: Bearer $FINPLAN_API_KEY on every request.

Install with pip install openai-agents; the package imports as agents. FinPlan’s server speaks Streamable HTTP, so connect with MCPServerStreamableHttp, used as an async context manager. The agent’s model calls go to OpenAI, so also export OPENAI_API_KEY.

import asyncio
import os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main() -> None:
async with MCPServerStreamableHttp(
name="FinPlan",
params={
"url": "https://mcp.finplan.tools/mcp",
"headers": {"Authorization": f"Bearer {os.environ['FINPLAN_API_KEY']}"},
},
) as finplan:
agent = Agent(
name="Financial Planner",
instructions="Help users with financial planning questions.",
mcp_servers=[finplan],
)
result = await Runner.run(
agent, "Calculate federal income tax for $85,000 filing single in 2026"
)
print(result.final_output)
asyncio.run(main())
import os
from langchain_mcp import MCPToolkit
toolkit = MCPToolkit(
server_url="https://mcp.finplan.tools/mcp",
headers={"Authorization": f"Bearer {os.environ['FINPLAN_API_KEY']}"},
)
tools = toolkit.get_tools()
import os
from autogen import AssistantAgent
from autogen.tools import MCPToolWrapper
mcp_tools = MCPToolWrapper(
"https://mcp.finplan.tools/mcp",
headers={"Authorization": f"Bearer {os.environ['FINPLAN_API_KEY']}"},
)
assistant = AssistantAgent(
name="financial_planner", llm_config={"model": "gpt-6-astra"}, tools=mcp_tools.get_tools()
)
import os
from crewai import Agent
from crewai_tools import MCPTool
finplan_tool = MCPTool(
name="finplan",
server_url="https://mcp.finplan.tools/mcp",
headers={"Authorization": f"Bearer {os.environ['FINPLAN_API_KEY']}"},
)
analyst = Agent(
role="Financial Analyst",
goal="Help users understand their financial projections",
tools=[finplan_tool],
)

FinPlan has no plain REST API for tools: its only endpoint is https://mcp.finplan.tools/mcp, which speaks MCP’s JSON-RPC over Streamable HTTP. A client has to open a session before it can list or call tools, so use an MCP client SDK rather than hand-rolled HTTP requests. The official MCP SDKs cover Python, TypeScript and several other languages; point one at the URL above and send Authorization: Bearer $FINPLAN_API_KEY as a header.