Happy slice of mcp pizzaMCP.pizza

Financial-Modeling-Prep-MCP-Server

MCP.Pizza Chef: imbenrabi

Ask about a company's earnings, share price history, market news, insider trades, government trading activity, currencies, or crypto, and the answer comes from live financial records rather than the model's memory. There is a hosted address you can add to Claude.ai or Claude Desktop as a connector, or you can run it yourself with a single command. A Financial Modeling Prep account token is required before any data comes back.

Data
Web/Research

Use This MCP server To

Check a company's latest earnings before a meeting Compare share price history for two companies I am watching Pull today's market news for the stocks I own Look up recent insider buying and selling at a company Get current exchange rates or crypto prices mid-conversation Read a company's recent regulatory filings without hunting for them

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
  • Configuration
  • Usage
  • API Reference
  • Registries
  • Contributing
  • 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 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 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 FAQ

Which apps does it work in?
Claude.ai and Claude Desktop can add the hosted address as a connector, and it also works with other assistants that accept remote MCP servers.
Do I need an account key?
Yes, a Financial Modeling Prep token, which you paste into the connection settings. You sign up on their site to get one.
How hard is setup?
The hosted version needs no install at all, just an address and your token. Running it on your own computer takes one command.
Can I use this to research a company before I invest?
Yes. You can ask for fundamentals, price history, news, and filings in plain language, though what comes back is data, not advice.
Does it cover anything besides stocks?
Yes. Funds, currencies, crypto, commodities, market indexes, earnings calendars, and economic figures are all included.
Is there a limit on how much I can pull?
That depends on the Financial Modeling Prep plan attached to your token, not on this connector.