npm financial-modeling-prep-mcp-serverstdioApache-2.0updated 2mo ago
A Model Context Protocol (MCP) server for the Financial Modeling Prep API, exposing 250+ financial data tools to AI assistants.
¿Qué puedes hacer con Financial Modeling Prep MCP Server?
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
Instalación
Añade Financial Modeling Prep MCP Server a tu cliente. Elige el que uses.
claude mcp add financial-modeling-prep-mcp-server -- npx -y financial-modeling-prep-mcp-servercodex mcp add financial-modeling-prep-mcp-server -- npx -y financial-modeling-prep-mcp-serveramp mcp add financial-modeling-prep-mcp-server -- npx -y financial-modeling-prep-mcp-server{
"mcpServers": {
"financial-modeling-prep-mcp-server": {
"command": "npx",
"args": [
"-y",
"financial-modeling-prep-mcp-server"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"financial-modeling-prep-mcp-server": {
"command": "npx",
"args": [
"-y",
"financial-modeling-prep-mcp-server"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"financial-modeling-prep-mcp-server","command":"npx","args":["-y","financial-modeling-prep-mcp-server"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"financial-modeling-prep-mcp-server": {
"command": "npx",
"args": [
"-y",
"financial-modeling-prep-mcp-server"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"financial-modeling-prep-mcp-server": {
"command": "npx",
"args": [
"-y",
"financial-modeling-prep-mcp-server"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"financial-modeling-prep-mcp-server": {
"command": "npx",
"args": [
"-y",
"financial-modeling-prep-mcp-server"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"financial-modeling-prep-mcp-server": {
"type": "local",
"command": "npx",
"args": [
"-y",
"financial-modeling-prep-mcp-server"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"financial-modeling-prep-mcp-server": {
"command": {
"path": "npx",
"args": [
"-y",
"financial-modeling-prep-mcp-server"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y financial-modeling-prep-mcp-serverRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Puntuación
39 / 100
Incompleta
- Documentación25/25
- Mantenimiento22/25
- Confianza13/20
- Capacidad0/15
- Instalación12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 60 days ago
- Has a release history
- Repository is not archived
- Licensed Apache-2.0
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Historial de versiones
| Versiones | Publicada |
|---|---|
| 2.6.12Última | 2 jul 2026 |
| 2.6.11 | 26 jun 2026 |
| 2.6.10 | 2 may 2026 |
| 2.6.9 | 24 abr 2026 |
| 2.6.8 | 3 feb 2026 |
| 2.6.7 | 2 feb 2026 |
| 2.6.6 | 1 feb 2026 |
| 2.6.5 | 1 feb 2026 |
| 2.6.4 | 31 ene 2026 |
| 2.6.3 | 29 ene 2026 |
| 2.6.2 | 15 ene 2026 |
| 2.6.1 | 15 ene 2026 |
| 2.5.3 | 6 dic 2025 |
| 2.5.1 | 11 sept 2025 |
| 2.4.0 | 11 sept 2025 |