FMP MCP Server

MCP server exposing the Financial Modeling Prep API through the Model Context Protocol. Built on @financialmodelingprep/tools — all ~90 tools (stock data, financials, SEC filings, insider trades, etc.) are available to any MCP client.

Installation

bun add -g @financialmodelingprep/mcp

Or run directly without installing:

bunx @financialmodelingprep/mcp

Setup

After a global install, the fmp-mcp binary is on your PATH. Configure it in your AI client (e.g., Claude Desktop, VS Code settings, opencode.json):

{
	"mcpServers": {
		"fmp": {
			"command": "fmp-mcp",
			"env": {
				"FMP_KEY": "<your-api-key>",
				"REDIS_URL": "redis://...",
				"SEC_USER_AGENT": "YourName [email protected]"
			}
		}
	}
}

Or, without a global install, run it on demand:

{
	"mcpServers": {
		"fmp": {
			"command": "bunx",
			"args": ["@financialmodelingprep/mcp"],
			"env": {
				"FMP_KEY": "<your-api-key>",
				"REDIS_URL": "redis://...",
				"SEC_USER_AGENT": "YourName [email protected]"
			}
		}
	}
}

FMP_KEY is required in env or config. REDIS_URL enables shared caching and rate limiting (optional — without it, the SDK uses an in-process cache/limiter). SEC_USER_AGENT (format "YourName [email protected]") is required only for SEC filing tools.

Development

bun test        # integration tests (skipped without FMP_KEY)
bun run typecheck