fmpsdk-mcp
A Model Context Protocol server that exposes
the fmpsdk library — the full Financial
Modeling Prep API — to an MCP client such as Claude Desktop or Claude Code.
Published to PyPI as fmpsdk-mcp; it
lives in the fmpsdk repo under mcp/. It is a
separate package so pip install fmpsdk never pulls in fastmcp.
What it exposes
| Layer | Tools |
|---|---|
| Curated (use first) | get_quote, get_company_profile, get_income_statement, get_balance_sheet, get_cash_flow, get_key_metrics, get_financial_ratios, get_historical_prices, search_symbol, get_stock_news |
| Discovery (the other ~228 endpoints, at runtime) | list_fmp_endpoints, describe_fmp_endpoint, call_fmp_endpoint |
| Resource | fmpsdk://llms.txt — orientation for the underlying package |
Every tool is a read-only GET. Large list results from call_fmp_endpoint
are paged (50 rows) with page / total / more; the bulk group and the
whole-asset-class batch_*_quotes endpoints are refused — use the fmpsdk
library directly for dataset-scale work.
Install
Needs uv (for uvx) and an
FMP API key.
Claude Code:
claude mcp add fmpsdk -s user -e FMP_API_KEY=your-fmp-api-key -- uvx fmpsdk-mcp
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"fmpsdk": {
"command": "uvx",
"args": ["fmpsdk-mcp"],
"env": { "FMP_API_KEY": "your-fmp-api-key" }
}
}
}
uvx fetches and caches the package on first launch (a few seconds). Pin a
version with uvx fmpsdk-mcp@20260829.0.
To run an unreleased revision straight from a branch instead:
uvx --from git+https://github.com/daxm/fmpsdk@master#subdirectory=mcp fmpsdk-mcp
Develop
cd mcp
uv sync
uv run fastmcp dev fmpsdk_mcp/server.py # opens the MCP Inspector
FMP_API_KEY=... uv run fmpsdk-mcp # run the stdio server directly
uv run --extra test pytest # the test suite
Cut a release with mcp/deploy_a_release.sh after bumping __version__ in
fmpsdk_mcp/__init__.py — it runs the gate, then tags mcp-v<version> and
pushes, which triggers .github/workflows/publish-mcp.yml.
Related: openapi.json
The repo root ships an openapi.json describing this same API surface,
generated by python tools/gen_openapi.py. It is introspected from the
fmpsdk source — FMP publishes no OpenAPI/Swagger document, and this file
is not fetched from or endorsed by FMP.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fmpsdk_mcp-20260829.0.tar.gz.
File metadata
- Download URL: fmpsdk_mcp-20260829.0.tar.gz
- Upload date:
- Size: 19.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
130c98dbe65f1db73f969b7c130881c72be484921b73c5862459040137da131a
|
|
| MD5 |
399f2bf436fc4ff4149af53aa7b04873
|
|
| BLAKE2b-256 |
ac216e2775abd1d9c61dd2516db883632905f58fef47aa4e2faed25a6c4f829e
|
Provenance
The following attestation bundles were made for fmpsdk_mcp-20260829.0.tar.gz:
Publisher:
publish-mcp.yml on daxm/fmpsdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fmpsdk_mcp-20260829.0.tar.gz -
Subject digest:
130c98dbe65f1db73f969b7c130881c72be484921b73c5862459040137da131a - Sigstore transparency entry: 2639114326
- Sigstore integration time:
-
Permalink:
daxm/fmpsdk@c47b96e2f64678d8b946dd2991215e0bf20eba10 -
Branch / Tag:
refs/tags/mcp-v20260829.0 - Owner: https://github.com/daxm
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-mcp.yml@c47b96e2f64678d8b946dd2991215e0bf20eba10 -
Trigger Event:
push
-
Statement type:
File details
Details for the file fmpsdk_mcp-20260829.0-py3-none-any.whl.
File metadata
- Download URL: fmpsdk_mcp-20260829.0-py3-none-any.whl
- Upload date:
- Size: 17.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c5ba3fced9af8942d81d6fe1b539fb15f1dad4d7f438ff722b3a716b2987b682
|
|
| MD5 |
40bd710adbf4f3ca06a163e20c2ee18e
|
|
| BLAKE2b-256 |
da2b530712853d91ceb9aed6cc7af5896fb25e4809e516c16a9e32270c0e2e08
|
Provenance
The following attestation bundles were made for fmpsdk_mcp-20260829.0-py3-none-any.whl:
Publisher:
publish-mcp.yml on daxm/fmpsdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fmpsdk_mcp-20260829.0-py3-none-any.whl -
Subject digest:
c5ba3fced9af8942d81d6fe1b539fb15f1dad4d7f438ff722b3a716b2987b682 - Sigstore transparency entry: 2639114354
- Sigstore integration time:
-
Permalink:
daxm/fmpsdk@c47b96e2f64678d8b946dd2991215e0bf20eba10 -
Branch / Tag:
refs/tags/mcp-v20260829.0 - Owner: https://github.com/daxm
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-mcp.yml@c47b96e2f64678d8b946dd2991215e0bf20eba10 -
Trigger Event:
push
-
Statement type:
