# Financial Modeling Prep MCP Server

Connects models to Financial Modeling Prep API data, covering stocks, SEC filings, and macro metrics. It brings corporate financial research directly into developer chats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 150
- Author: imbenrabi
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/financial-modeling-prep-mcp-server

## What it does

This server connects AI assistants to Financial Modeling Prep API endpoints. It provides 250+ tools across 24 categories. The tools cover stocks, ETF metrics, forex pairs, crypto, and commodities. Models can also inspect corporate balance sheets, SEC filings, and insider trades.

Three execution modes exist. The default mode exposes all tools immediately, which risks crowding context. Setting `DYNAMIC_TOOL_DISCOVERY=true` boots 5 meta-tools built on `toolception` to activate toolsets when requested. You can also specify toolsets directly with `FMP_TOOL_SETS`.

Self-hosting version 2.6.0+ requires Node.js 25.3.0 or higher. Without an `FMP_ACCESS_TOKEN`, calls fail. Using the hosted Railway URL over HTTP avoids updating local runtimes.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp`
- Environment variables: `FMP_ACCESS_TOKEN`, `PORT`, `DYNAMIC_TOOL_DISCOVERY`, `FMP_TOOL_SETS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http financial-modeling-prep-mcp-server https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env FMP_ACCESS_TOKEN=<FMP_ACCESS_TOKEN> --env PORT=<PORT> --env DYNAMIC_TOOL_DISCOVERY=<DYNAMIC_TOOL_DISCOVERY> --env FMP_TOOL_SETS=<FMP_TOOL_SETS> --transport stdio financial-modeling-prep-mcp-server -- npx -y financial-modeling-prep-mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add financial-modeling-prep-mcp-server --url https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
```

2. **Platform CLI**
```bash
codex mcp add financial-modeling-prep-mcp-server --env FMP_ACCESS_TOKEN=<FMP_ACCESS_TOKEN> --env PORT=<PORT> --env DYNAMIC_TOOL_DISCOVERY=<DYNAMIC_TOOL_DISCOVERY> --env FMP_TOOL_SETS=<FMP_TOOL_SETS> -- npx -y financial-modeling-prep-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "financial-modeling-prep-mcp-server": {
            "url": "https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "financial-modeling-prep-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "financial-modeling-prep-mcp-server"
            ],
            "env": {
                "FMP_ACCESS_TOKEN": "<FMP_ACCESS_TOKEN>",
                "PORT": "<PORT>",
                "DYNAMIC_TOOL_DISCOVERY": "<DYNAMIC_TOOL_DISCOVERY>",
                "FMP_TOOL_SETS": "<FMP_TOOL_SETS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "financial-modeling-prep-mcp-server": {
            "type": "http",
            "url": "https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "financial-modeling-prep-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "financial-modeling-prep-mcp-server"
            ],
            "env": {
                "FMP_ACCESS_TOKEN": "<FMP_ACCESS_TOKEN>",
                "PORT": "<PORT>",
                "DYNAMIC_TOOL_DISCOVERY": "<DYNAMIC_TOOL_DISCOVERY>",
                "FMP_TOOL_SETS": "<FMP_TOOL_SETS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http financial-modeling-prep-mcp-server https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e FMP_ACCESS_TOKEN=<FMP_ACCESS_TOKEN> -e PORT=<PORT> -e DYNAMIC_TOOL_DISCOVERY=<DYNAMIC_TOOL_DISCOVERY> -e FMP_TOOL_SETS=<FMP_TOOL_SETS> financial-modeling-prep-mcp-server npx -y financial-modeling-prep-mcp-server
```
Replace <…> with your own values

## When to use it
- fetch balance sheets and valuation multiples by company ticker
- inspect insider transactions and SEC filings for public firms
- pull price series across stocks, cryptocurrencies, and commodities
- prevent context bloat by loading financial toolsets dynamically

## Example prompts
- Show the recent SEC filings and insider trades for MSFT
- Fetch valuation ratios and quarterly revenue numbers for AAPL
- Check spot prices for crude oil and the USD/EUR exchange rate

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md