Financial Modeling Prep MCP (Model Context Protocol)

by imbenrabi

139 stars

594 downloads

Not rated

GitHub

Finance
AI

About

A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.

Details

Author: imbenrabi
GitHub stars: 139
Downloads: 594
Categories: Finance, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Financial Modeling Prep MCP (Model Context Protocol)

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

From the repository

Use the hosted instance at https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp and provide your FMP_ACCESS_TOKEN. Alternatively, self-host with one command: npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY. The server supports three modes: Dynamic (load toolsets via meta-tools), Static (pre-load specified tool sets), and All Tools (default, loads everything).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "financial modeling prep mcp (model context protocol)": {
            "Financial-Modeling-Prep-MCP-Server": {
                "command": "npx",
                "args": [
                    "financial-modeling-prep-mcp-server",
                    "--fmp-token=YOUR_FMP_API_KEY"
                ]
            }
        }
    }
}

McpServers

{
    "Financial-Modeling-Prep-MCP-Server": {
        "command": "npx",
        "args": [
            "financial-modeling-prep-mcp-server",
            "--fmp-token=YOUR_FMP_API_KEY"
        ]
    }
}

# Financial Modeling Prep MCP Server [![npm version](https://img.shields.io/npm/v/financial-modeling-prep-mcp-server.svg)](https://www.npmjs.com/package/financial-modeling-prep-mcp-server) [![license](https://img.shields.io/npm/l/financial-modeling-prep-mcp-server.svg)](LICENSE) A Model Context Protocol (MCP) server for the [Financial Modeling Prep](https://financialmodelingprep.com/) 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](https://www.npmjs.com/package/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) ```bash npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY ``` Or install globally: ```bash npm install -g financial-modeling-prep-mcp-server fmp-mcp --fmp-token=YOUR_FMP_API_KEY ``` > Get your API key at [financialmodelingprep.com](https://site.financialmodelingprep.com/). ## Table of Contents - [Installation](docs/INSTALLATION.md) - [Configuration](docs/CONFIGURATION.md) - [Usage](docs/USAGE.md) - [API Reference](docs/API_REFERENCE.md) - [Registries](docs/REGISTRIES.md) - [Contributing](CONTRIBUTING.md) - [License](LICENSE) ## 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](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](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](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](docs/API_REFERENCE.md) for the complete tool catalog. ## Registries This server is listed on multiple MCP registries for easy discovery: - [Smithery.ai](https://smithery.ai/server/@imbenrabi/financial-modeling-prep-mcp-server) - [Glama.ai](https://glama.ai/mcp/servers/@imbenrabi/financial-modeling-prep-mcp-server) See [docs/REGISTRIES.md](docs/REGISTRIES.md) for registry-specific setup instructions. ## Contributing Contributions are welcome. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and pull request guidelines. ## License [Apache-2.0](LICENSE)

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Context 7

Sequential Thinking

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀