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.
Was kannst du mit Financial Modeling Prep MCP Server machen?
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
Installation
Financial Modeling Prep MCP Server zu deinem Client hinzufügen. Wähl den, den du nutzt.
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.
Score
39 / 100
Unvollständig
- Dokumentation25/25
- Pflege22/25
- Vertrauen13/20
- Funktionsumfang0/15
- Installation12/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
Versionsverlauf
| Versionen | Veröffentlicht |
|---|---|
| 2.6.12Aktuell | 2. Juli 2026 |
| 2.6.11 | 26. Juni 2026 |
| 2.6.10 | 2. Mai 2026 |
| 2.6.9 | 24. Apr. 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. Jan. 2026 |
| 2.6.3 | 29. Jan. 2026 |
| 2.6.2 | 15. Jan. 2026 |
| 2.6.1 | 15. Jan. 2026 |
| 2.5.3 | 6. Dez. 2025 |
| 2.5.1 | 11. Sept. 2025 |
| 2.4.0 | 11. Sept. 2025 |