English Français العربية

Financial Modeling Prep MCP Server

السجل الرسمي الذكاء الاصطناعي والوكلاء

MCP server for Financial Modeling Prep API with 250+ financial data tools

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Financial Modeling Prep MCP Server؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http financial-modeling-prep-mcp-server 'https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "financial-modeling-prep-mcp-server": {
            "type": "http",
            "url": "https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp"
        }
    }
}
NPM package financial-modeling-prep-mcp-server
Claude Code 
claude mcp add financial-modeling-prep-mcp-server -e 'FMP_ACCESS_TOKEN=<your fmp_access_token>' -e 'PORT=<PORT>' -e 'DYNAMIC_TOOL_DISCOVERY=<DYNAMIC_TOOL_DISCOVERY>' -e 'FMP_TOOL_SETS=<FMP_TOOL_SETS>' -- npx -y financial-modeling-prep-mcp-server@2.8.0 --fmp-token --port --dynamic-tool-discovery --fmp-tool-sets
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "financial-modeling-prep-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "financial-modeling-prep-mcp-server@2.8.0",
                "--fmp-token",
                "--port",
                "--dynamic-tool-discovery",
                "--fmp-tool-sets"
            ],
            "env": {
                "FMP_ACCESS_TOKEN": "<your fmp_access_token>",
                "PORT": "<PORT>",
                "DYNAMIC_TOOL_DISCOVERY": "<DYNAMIC_TOOL_DISCOVERY>",
                "FMP_TOOL_SETS": "<FMP_TOOL_SETS>"
            }
        }
    }
}

متغيرات البيئة

  • FMP_ACCESS_TOKEN سري Financial Modeling Prep API access token
  • PORT Port number for HTTP server mode
  • DYNAMIC_TOOL_DISCOVERY Enable dynamic tool discovery mode
  • FMP_TOOL_SETS Comma-separated list of tool sets to load

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Financial Modeling Prep MCP Server
  2. Features
  3. Quick Start
  4. Table of Contents
  5. Installation
  6. Configuration
  7. Usage
  8. Available Tools
  9. Registries
  10. Contributing
  11. License

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 or environment variables:

ModeHow to EnableDescription
DynamicDYNAMIC_TOOL_DISCOVERY=trueStarts with 5 meta-tools; load toolsets at runtime
StaticFMP_TOOL_SETS=search,companyPre-loads specified toolsets on session creation
All Tools (default)(default)Loads all 250+ tools immediately

Precedence: for mode and tool sets, CLI args > Environment variables > Defaults. A session ?config= token overrides the server's FMP_ACCESS_TOKEN for that session.

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 /mcp with mcp-client-id header
  • 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

Apache-2.0

الأسئلة الشائعة

ما هو Financial Modeling Prep MCP Server؟

MCP server for Financial Modeling Prep API with 250+ financial data tools

كيف أثبّت Financial Modeling Prep MCP Server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http financial-modeling-prep-mcp-server 'https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Financial Modeling Prep MCP Server إلى مفتاح API؟

نعم. يتطلب FMP_ACCESS_TOKEN، وتضبطها في إعداداته.

هل Financial Modeling Prep MCP Server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Financial Modeling Prep MCP Server؟

ينشره imbenrabi. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.