mcpField
F
Financial Modeling Prep MCP (Model Context Protocol)

Financial Modeling Prep MCP (Model Context Protocol)

Remote
github.comFinance150Updated 2w ago

About Financial Modeling Prep MCP (Model Context Protocol)

Financial Modeling Prep MCP is a server that exposes Financial Modeling Prep financial data through more than 250 tools in 24 categories. It offers dynamic, static, and all-tools modes, with hosted or self-hosted deployment options.

Key features

  1. 01250+ tools across 24 categories
  2. 02Stocks, funds, crypto, forex, and economics data
  3. 03Dynamic, static, and all-tools modes
  4. 04HTTP/SSE transport
  5. 05Hosted or self-hosted deployment

Use cases

  1. 01Retrieve company fundamentals and financial statements
  2. 02Explore quotes, market data, and technical indicators
  3. 03Query ETF, crypto, forex, or economic data

MCP support

Exposes Financial Modeling Prep data tools to MCP clients over HTTP/SSE. Toolsets can be loaded dynamically, selected at startup, or all made available; access requires an FMP access token.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Packages
npmfinancial-modeling-prep-mcp-server2.8.0

Tools

5
ParameterTypeRequiredDescription
namestringYesToolset name

Details

From the project README

Financial Modeling Prep MCP Server

npm version license

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.