Financial Modeling Prep MCP Server MCP Server
io.github.imbenrabi/financial-modeling-prep-mcp-server
Access 250+ financial data tools via MCP for stocks, ETFs, crypto, forex, and economic analysis.
What is the Financial Modeling Prep MCP Server MCP server?
The Financial Modeling Prep MCP Server is a Model Context Protocol server that exposes 250+ financial data tools from the Financial Modeling Prep API across 24 categories including stocks, ETFs, crypto, forex, commodities, and economics. It supports three operational modes—Dynamic (meta-tools for on-demand loading), Static (pre-loaded toolsets), or All Tools (default)—and can be deployed as a hosted instance or self-hosted via npm, Docker, or source.
This server integrates the Financial Modeling Prep API with AI assistants like Claude, providing access to comprehensive financial data across multiple asset classes and market segments. Use it to retrieve stock quotes, financial statements, technical indicators, SEC filings, earnings data, cryptocurrency prices, forex rates, commodity data, and economic indicators—all through a unified MCP interface.
How to install Financial Modeling Prep MCP Server
Copy-paste configuration for popular MCP clients.
FMP_ACCESS_TOKENsecretFinancial Modeling Prep API access token
PORTPort number for HTTP server mode
DYNAMIC_TOOL_DISCOVERYEnable dynamic tool discovery mode
FMP_TOOL_SETSComma-separated list of tool sets to load
Tools & capabilities
Tools this server exposes to the agent.
Search Tools— Search functionality across financial dataDirectory & Symbol Lists— Access to company symbols and directory listingsCompany Information— Retrieve detailed company profiles and informationFinancial Statements— Access income statements, balance sheets, and cash flow statementsFinancial Metrics & Analysis— Ratios, valuations, and financial analysis metricsTechnical Indicators— Technical analysis indicators for price dataQuotes & Price Data— Real-time and historical stock quotesMarket Indexes & Performance— Index data and market performance metricsMarket Data— General market data and statisticsNews & Press Releases— Financial news and company press releasesSEC Filings— Access to SEC filing documents and dataInsider & Institutional Trading— Insider trading and institutional ownership dataETFs & Funds— ETF and mutual fund informationGovernment Trading— Government trading activity dataCryptocurrency & Forex— Cryptocurrency prices and forex exchange ratesEarnings— Earnings reports and earnings-related dataSpecial Data Sets— Specialized financial datasetsCommodities— Commodity prices and dataEconomics— Economic indicators and dataBulk Data Tools— Tools for bulk data retrieval
Use cases
- Retrieve real-time stock quotes and historical price data for portfolio analysis
- Access financial statements and metrics to compare companies or perform valuation analysis
- Monitor technical indicators and market indexes for trading or investment decisions
- Fetch SEC filings, insider trading data, and earnings reports for fundamental research
- Analyze cryptocurrency prices, forex rates, and commodity data for multi-asset portfolio management
Financial Modeling Prep MCP Server MCP server FAQ
It is an MCP server that exposes 250+ financial data tools from the Financial Modeling Prep API, covering stocks, ETFs, crypto, forex, commodities, and economic data across 24 categories.
The server itself is free and open-source (Apache-2.0 license). However, you need a Financial Modeling Prep API key (free tier available at financialmodelingprep.com) to access the underlying financial data.
You can use the hosted instance at https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp by adding it as a remote connector in Claude Desktop settings, or self-host via npm with: npx financial-modeling-prep-mcp-server --fmp-token=YOUR_API_KEY
You need a Financial Modeling Prep API key (FMP_ACCESS_TOKEN), which you can obtain for free at financialmodelingprep.com. Provide it during server configuration.
Dynamic mode uses 5 meta-tools to load toolsets on demand; Static mode pre-loads specified toolsets; All Tools mode (default) loads all 250+ tools immediately.
Node.js 25.3.0 or higher is required for v2.6.0+. For older versions (v2.5.x and below), Node.js 20+ is sufficient.
README (reference)
Source of truth, from the repository.
Financial Modeling Prep MCP Server
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
Related MCP servers

Apple Mail MCP
Full-coverage FTS5 body search for Apple Mail — reliable on large mailboxes.

io.github.img-src-io/mcp
MCP server for img-src.io Image CDN - upload, transform, and deliver images through AI assistants
U.S. federal contract opportunities from SAM.gov. Daily updates. Public Domain.
Wine matching, pricing, auctions, exchange, merchant, critic, portfolio, and cellar intelligence.

