financial-modeling-prep-mcp-server
Model Context Protocol server for Financial Modeling Prep (FMP) API, exposing 250+ tools for financial data, market insights, and analysis.
pinned to #cef864eupdated last month
Ask your AI client: “install mcps/financial-modeling-prep-mcp-server”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install mcps/financial-modeling-prep-mcp-servermetahub onboarded this repo on the author's behalf.
If you own github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
137
Last commit
last month
Latest release
published
- #ai
- #ai tools
- #assistant
- #commodities
- #crypto
- #earnings
- #economics
- #esg
- #etf-investments
- #exchange
- #exchanges
- #financial analysis
- #financial data
- #financial modeling prep
- #financial news
- #financial planning
- #financial reporting
- #financial-modeling-prep
- #fmp
- #fmp api
- #forex
- #indexes
- #llm
- #market data
- #mcp
- #mcp-server
- #mcp-tools
- #model context protocol
- #news
- #node
- #quotes
- #sec-filings
- #server
- #smithery-ai
- #statements
- #stock
- #stock analysis
- #stock data
- #stock market
- #stock market analysis
- #stock market data
- #stock market news
- #stock market planning
- #stock market quotes
- #stock market reporting
- #stock market symbols
- #stock news
- #stock planning
- #stock prices
- #stock quotes
- #stock reporting
- #stock symbols
- #stock-data
- #stock-market
- #stocks
- #symbols
- #technical indicators
- #ticker
- #ticker symbols
- #typescript
What this server exposes
Surfaces parsed from this server's source at publish time.
Launches: fmp-mcp
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.cef864e· last month
Safety
21Dependencies: known vulnerabilitieswarn
13 high/critical advisories — [email protected] (HIGH: GHSA-35jp-ww65-95wh) · [email protected] (HIGH: GHSA-3g43-6gmg-66jw) (+11)
Update the affected packages, then re-publish. (`npm audit` shows the same data locally.)
LICENSE file at repo root
LICENSE
No sensitive files in the repo
scanned for .env, credentials.json, *.pem, .ssh/, AWS / GCP configs — none found
Release history
1- releasecurrentcef864ewarnlast month
Contents
A Model Context Protocol (MCP) server for the Financial Modeling Prep API, exposing 250+ financial data tools to AI assistants.
Features
- 250+ Financial Tools across 24 categories — stocks, ETFs, crypto, forex, commodities, economics, and more
- Dynamic Tool Management — built on toolception for runtime enable/disable of toolsets via meta-tools
- Three Server Modes — Dynamic (meta-tools), Static (pre-loaded toolsets), or All Tools (default)
- Flexible Deployment — use the hosted instance or self-host via npm, Docker, or source
- HTTP/SSE Transport — compatible with Claude.ai, Claude Desktop, and MCP registries
Quick Start
Hosted Instance (Fastest)
No installation required. Connect directly:
https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
Provide your FMP_ACCESS_TOKEN in session configuration and start using 5 meta-tools to load toolsets on demand.
Self-Hosted (One-Liner)
npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY
Or install globally:
npm install -g financial-modeling-prep-mcp-server
fmp-mcp --fmp-token=YOUR_FMP_API_KEY
Get your API key at financialmodelingprep.com.
Table of Contents
Installation
Prerequisites: Node.js 25.3.0 or higher (for v2.6.0+). For older versions (v2.5.x and below), Node.js 20+ is required.
Choose the method that fits your workflow:
- NPM —
npm install -g financial-modeling-prep-mcp-server - Docker — build from source or pull a pre-built image
- Source — clone and run with
npm install && npm run build
See docs/INSTALLATION.md for detailed steps per method.
Configuration
The server supports three operational modes controlled via CLI arguments, environment variables, or session configuration:
| Mode | How to Enable | Description |
|---|---|---|
| Dynamic | DYNAMIC_TOOL_DISCOVERY=true | Starts with 5 meta-tools; load toolsets at runtime |
| Static | FMP_TOOL_SETS=search,company | Pre-loads specified toolsets on session creation |
| All Tools (default) | (default) | Loads all 250+ tools immediately |
Precedence: CLI args > Environment variables > Session config > Defaults.
See docs/CONFIGURATION.md for the full configuration reference.
Usage
Connect to the server via HTTP/SSE transport:
- Claude.ai / Claude Desktop — add as a remote connector (Settings > Connectors)
- Custom clients — POST to
/mcpwithmcp-client-idheader - MCP registries — Smithery.ai, Glama.ai, and others
See docs/USAGE.md for client-specific setup, session headers, and request examples.
Available Tools
24 categories covering:
Search · Directory & Symbol Lists · Company Information · Financial Statements · Financial Metrics & Analysis · Technical Indicators · Quotes & Price Data · Market Indexes & Performance · Market Data · News & Press Releases · SEC Filings · Insider & Institutional Trading · ETFs & Funds · Government Trading · Cryptocurrency & Forex · Earnings · Special Data Sets · Commodities · Economics · Bulk Data Tools
See docs/API_REFERENCE.md for the complete tool catalog.
Registries
This server is listed on multiple MCP registries for easy discovery:
See docs/REGISTRIES.md for registry-specific setup instructions.
Contributing
Contributions are welcome. Please see CONTRIBUTING.md for development setup, testing, and pull request guidelines.
License
Reviews
No reviews yet. Be the first.
Related
@remote-mcp/example
@remote-mcp/example MCP server
excel-mcp-server
Excel MCP Server for manipulating Excel files
brainstorm-mcp
MCP server for multi-round AI brainstorming debates across multiple models
mh install mcps/financial-modeling-prep-mcp-server