FMP SDK MCP
The fmpsdk-mcp MCP server gives an agent Financial Modeling Prep data: quotes, statements, ratios and news
- 214 ★ on the repository
- Last commit
- BSD-3-Clause
Extended access
Why this level
- The FMP API key goes to the server in an environment variable and opens paid data under your plan
- The server only reads data, but requests use up your FMP plan limits
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/fmp-sdk-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The FMP API key goes to the server in an environment variable and opens paid data under your plan
- The server only reads data, but requests use up your FMP plan limits
This is third-party code. Review the repository files before installing.
What it does
fmpsdk-mcp is an MCP server over the fmpsdk library, which covers the whole Financial Modeling Prep API. Every tool only reads data with GET requests. The agent gets ten core tools: a quote, a company profile, the income statement, balance sheet, cash flow, key metrics, financial ratios, historical prices, ticker search and stock news. The other roughly 228 API methods are reachable through three tools: `list_fmp_endpoints` lists them, `describe_fmp_endpoint` describes one and `call_fmp_endpoint` calls it. Long lists arrive in pages of 50 rows. Bulk downloads and whole-asset-class batch quotes are refused, and the library itself is used for such work. The `fmpsdk://llms.txt` resource describes the package for the agent.
Who it is for. Financial analysts and developers who review company statements and quotes in a chat with an agent using their own FMP key.
Good fit when
- The agent compares income statements and ratios of two companies over recent years
- Price history and fresh news for a ticker are needed before discussing a model
- The agent finds the right method among hundreds of endpoints through `list_fmp_endpoints` and calls it
- Key metrics and a company profile are pulled into a table for review
Not a fit when
- You need whole-market dumps: the server refuses bulk and batch methods
- You have no FMP key: the server does not work without it and some data needs a paid plan
- You need orders and trades: the server only reads data
Example request
Compare Apple and Microsoft by income statements and ratios over the last three years and add fresh news on bothMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
FMP_API_KEYrequired, secret- FMP API key from the Financial Modeling Prep account
Limitations
An FMP API key in `FMP_API_KEY` is required, and some endpoints are open only on the Starter, Premium or Ultimate paid plans. Running needs uv. Bulk downloads and whole-asset-class batch quotes are refused, and result lists are paged at 50 rows. The seven TipRanks methods are implemented and unit-tested but untested against a real response. The server lives in the `mcp/` folder of the fmpsdk repository and is published as a separate package under the BSD-3-Clause license. Version 20250102.0 and earlier uses dead FMP methods.
How to disable. Remove the server from the client (`claude mcp remove fmpsdk`) and revoke the key in the Financial Modeling Prep account.
FAQ
How do I install fmpsdk-mcp in Claude Code?
With `claude mcp add fmpsdk -s user -e FMP_API_KEY=key -- uvx fmpsdk-mcp`. uv and an FMP key are required.
Does the server change any data?
No, every tool only makes a GET request. There are no trades and no writes to the FMP service.
How do I reach the other API methods?
Through `list_fmp_endpoints`, `describe_fmp_endpoint` and `call_fmp_endpoint`: listing, describing and calling about 228 methods at runtime.
Which FMP plan do I need?
It depends on the method: each docstring names Free, Starter, Premium or Ultimate. When the plan is too low the library raises `FMPPlanLimitError`.
How do I pin a version?
With `uvx fmpsdk-mcp@20260829.0`, using the version you need. An unreleased revision can be taken straight from a repository branch.
Discussion
No questions or reviews yet.
Related
MCP serversMarket data in a dialogue with the agent: hosted server or local run, three modes and tool sets loaded on demand
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
A financial analysis MCP server: 500+ methods from company statements, ratios, indicators, risk metrics and macro data
Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
A hosted MCP server for financial data: quotes, filings, macro statistics and FTShare's own factors, read-only
MCP server that gives an agent Yahoo Finance data by ticker: price history, financial statements and option chains
README in short
The main text describes the fmpsdk library: 29 data groups and about 240 methods, example code, pricing tiers and the upgrade from an old version. A separate `mcp/README.md` covers the MCP server, tools and install.