Financial Modeling Prep MCP Server

io.github.imbenrabiPublished by GitHub account imbenrabiv2.9.0Updated Nov 5, 2026

MCP server for Financial Modeling Prep API with 250+ financial data tools

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

MCP server for the Financial Modeling Prep API, giving assistants 267 financial data tools across stocks, crypto, forex, economics and more.

What you can do
  • Search and browse symbols, company profiles and directory lists
  • Read financial statements, metrics, ratios and analysis
  • Fetch quotes, price data, technical indicators and market indexes
  • Retrieve news, press releases and SEC filings
  • Look up insider, institutional and government trading, ETFs and funds
  • Pull crypto, forex, commodities, earnings and economic data
When to use it
Useful when an assistant needs to answer questions about public companies, markets, filings or macro data and you already have (or are willing to get) a Financial Modeling Prep API key. The hosted instance is the quickest way to try it; self-hosting suits teams that want control over tool loading.
Requirements
A Financial Modeling Prep API access token, supplied as FMP_ACCESS_TOKEN (or the --fmp-token CLI argument). Either the hosted remote endpoint or a local install via npm/npx, which needs Node.js 25.3.0 or higher for v2.6.0+ (Node.js 20+ for v2.5.x and below). Optional settings: DYNAMIC_TOOL_DISCOVERY, FMP_TOOL_SETS and PORT. Network access to the FMP API.
Before you install
The FMP_ACCESS_TOKEN is a paid third-party API credential; a session config token can override the server's own token, so keep it out of shared links. Queries and the token are sent to Financial Modeling Prep, and the hosted instance is a third-party endpoint. The default mode loads all 267 tools at once, which can crowd an assistant's context; dynamic mode avoids that.

Installation

In SourceWeft

  1. Open Financial Modeling Prep MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.imbenrabi%2Ffinancial-modeling-prep-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "financial-modeling-prep": {
      "type": "http",
      "url": "https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp"
    }
  }
}

README

Financial Modeling Prep MCP Server

[npm version] [license]

A Model Context Protocol (MCP) server for the Financial Modeling Prep API, exposing 267 financial data tools to AI assistants.

Features

  • 267 Financial Tools across 24 toolsets — 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 (5 meta-tools), Static (pre-loaded toolsets), or All Tools (default)
  • Flexible Deployment — use the hosted instance or self-host via npm, Docker (built from source), or source
  • Streamable HTTP 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

The hosted instance runs in Dynamic mode: it starts with 5 meta-tools that load toolsets on demand. Pass your FMP API key as FMP_ACCESS_TOKEN in the ?config= session configuration (see Usage).

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-serverfmp-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 the image from source (no pre-built image is published)
  • 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 267 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 over streamable HTTP:

  • Claude.ai / Claude Desktop — add as a remote connector (Settings > Connectors)
  • Custom clients — POST to /mcp: send initialize first, then the mcp-session-id it returns on every later request
  • MCP registries — Glama.ai and the official MCP Registry

See docs/USAGE.md for client-specific setup, session headers, and request examples.

Available Tools

24 toolsets 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

Source: README.md at commit 47dc8f1

Tools

5

enable_toolset

Enable a toolset by name

Parametersnamerequired

disable_toolset

Disable a toolset by name and remove its tools

Parametersnamerequired

list_toolsets

List available toolsets with active status and definitions

Takes no parameters.

describe_toolset

Describe a toolset with definition, active status and tools

Parametersnamerequired

list_tools

List currently registered tool names (best effort)

Takes no parameters.

Version history

4
  1. v2.9.0LatestNov 5, 2026
  2. v2.8.0Oct 14, 2026
  3. v2.7.0Oct 10, 2026
  4. v2.6.12Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts