PluginBench
MCP Server
Maintained
Apache-2.0

Financial Modeling Prep MCP Server MCP Server

io.github.imbenrabi/financial-modeling-prep-mcp-server

Access 250+ financial data tools via MCP for stocks, ETFs, crypto, forex, and economic analysis.

What is the Financial Modeling Prep MCP Server MCP server?

The Financial Modeling Prep MCP Server is a Model Context Protocol server that exposes 250+ financial data tools from the Financial Modeling Prep API across 24 categories including stocks, ETFs, crypto, forex, commodities, and economics. It supports three operational modes—Dynamic (meta-tools for on-demand loading), Static (pre-loaded toolsets), or All Tools (default)—and can be deployed as a hosted instance or self-hosted via npm, Docker, or source.

This server integrates the Financial Modeling Prep API with AI assistants like Claude, providing access to comprehensive financial data across multiple asset classes and market segments. Use it to retrieve stock quotes, financial statements, technical indicators, SEC filings, earnings data, cryptocurrency prices, forex rates, commodity data, and economic indicators—all through a unified MCP interface.

How to install Financial Modeling Prep MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • 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

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "financial-modeling-prep-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "financial-modeling-prep-mcp-server",
        "--fmp-token",
        "--port",
        "--dynamic-tool-discovery",
        "--fmp-tool-sets"
      ],
      "env": {
        "FMP_ACCESS_TOKEN": "<YOUR_FMP_ACCESS_TOKEN>",
        "PORT": "<YOUR_PORT>",
        "DYNAMIC_TOOL_DISCOVERY": "<YOUR_DYNAMIC_TOOL_DISCOVERY>",
        "FMP_TOOL_SETS": "<YOUR_FMP_TOOL_SETS>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • Search Tools — Search functionality across financial data
  • Directory & Symbol Lists — Access to company symbols and directory listings
  • Company Information — Retrieve detailed company profiles and information
  • Financial Statements — Access income statements, balance sheets, and cash flow statements
  • Financial Metrics & Analysis — Ratios, valuations, and financial analysis metrics
  • Technical Indicators — Technical analysis indicators for price data
  • Quotes & Price Data — Real-time and historical stock quotes
  • Market Indexes & Performance — Index data and market performance metrics
  • Market Data — General market data and statistics
  • News & Press Releases — Financial news and company press releases
  • SEC Filings — Access to SEC filing documents and data
  • Insider & Institutional Trading — Insider trading and institutional ownership data
  • ETFs & Funds — ETF and mutual fund information
  • Government Trading — Government trading activity data
  • Cryptocurrency & Forex — Cryptocurrency prices and forex exchange rates
  • Earnings — Earnings reports and earnings-related data
  • Special Data Sets — Specialized financial datasets
  • Commodities — Commodity prices and data
  • Economics — Economic indicators and data
  • Bulk Data Tools — Tools for bulk data retrieval

Use cases

  • Retrieve real-time stock quotes and historical price data for portfolio analysis
  • Access financial statements and metrics to compare companies or perform valuation analysis
  • Monitor technical indicators and market indexes for trading or investment decisions
  • Fetch SEC filings, insider trading data, and earnings reports for fundamental research
  • Analyze cryptocurrency prices, forex rates, and commodity data for multi-asset portfolio management

Financial Modeling Prep MCP Server MCP server FAQ

What is the Financial Modeling Prep MCP Server?

It is an MCP server that exposes 250+ financial data tools from the Financial Modeling Prep API, covering stocks, ETFs, crypto, forex, commodities, and economic data across 24 categories.

Is it free to use?

The server itself is free and open-source (Apache-2.0 license). However, you need a Financial Modeling Prep API key (free tier available at financialmodelingprep.com) to access the underlying financial data.

How do I install it in Claude Desktop or Cursor?

You can use the hosted instance at https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp by adding it as a remote connector in Claude Desktop settings, or self-host via npm with: npx financial-modeling-prep-mcp-server --fmp-token=YOUR_API_KEY

What authentication is required?

You need a Financial Modeling Prep API key (FMP_ACCESS_TOKEN), which you can obtain for free at financialmodelingprep.com. Provide it during server configuration.

What are the three server modes?

Dynamic mode uses 5 meta-tools to load toolsets on demand; Static mode pre-loads specified toolsets; All Tools mode (default) loads all 250+ tools immediately.

What are the system requirements?

Node.js 25.3.0 or higher is required for v2.6.0+. For older versions (v2.5.x and below), Node.js 20+ is sufficient.

README (reference)

Source of truth, from the repository.

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, environment variables, or session configuration:

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: 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

Related MCP servers

Full-coverage FTS5 body search for Apple Mail — reliable on large mailboxes.

56
Python
GPL-3.0
View repository →

MCP server for img-src.io Image CDN - upload, transform, and deliver images through AI assistants

0
JavaScript
MIT
View repository →

U.S. federal contract opportunities from SAM.gov. Daily updates. Public Domain.

0
TypeScript
MIT
View repository →

Wine matching, pricing, auctions, exchange, merchant, critic, portfolio, and cellar intelligence.

Notes, files, GitHub, and Drive through one MCP connection.

View repository →

Notes, files, GitHub, and Drive through one MCP connection.

View repository →