English Français العربية

Financial Modeling Prep MCP Server

Official registry AI and agents

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

Source code Website Documentation

What can you do with 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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 configuration (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>"
            }
        }
    }
}

Environment variables

  • FMP_ACCESS_TOKEN secret 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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is Financial Modeling Prep MCP Server?

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

How do I install Financial Modeling Prep MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http financial-modeling-prep-mcp-server 'https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Financial Modeling Prep MCP Server need an API key?

Yes. It expects FMP_ACCESS_TOKEN, which you set in its configuration.

Is Financial Modeling Prep MCP Server open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains Financial Modeling Prep MCP Server?

It is published by imbenrabi. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.