@imbenrabi/Financial-Modeling-Prep-MCP-ServerPublic

Connectors#Any agent#Research #Data #Product

MCP server for Financial Modeling Prep market data

This is an MCP connector that lets agent clients access Financial Modeling Prep data through a tool server. It supports hosted use, self-hosted use, and multiple server modes for loading all tools or only selected toolsets.

143 stars•51 forks•TypeScript•Updated 2mo ago

Who it's for

Builders who want their agent to look up market data, fundamentals, and financial statements from Financial Modeling Prep.

What it delivers

You can let your agent fetch and analyze live financial data without wiring up the API yourself.

What it does

250+ financial tools

Exposes tools across stocks, ETFs, crypto, forex, commodities, economics, filings, and more.

Dynamic tool management

Uses toolception meta-tools to enable or disable toolsets at runtime.

Multiple server modes

Supports dynamic, static, and all-tools startup modes.

HTTP/SSE transport

Works with Claude.ai, Claude Desktop, and other MCP clients over remote transport.

Hosted and self-hosted setup

Can be used from the hosted endpoint or run locally with npm, Docker, or source.

How to get it

1No installation required. Connect directly

https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp

2Run

npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY

3Or install globally

npm install -g financial-modeling-prep-mcp-server
fmp-mcp --fmp-token=YOUR_FMP_API_KEY

README

Financial Modeling Prep MCP Server

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.

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

Files in the repo

Repository payload•26 top-level entries

__tests__— Tests
.claude— Claude Code skills, agents, commands, hooks
.github— GitHub workflows and templates
.sentrux— 1 item
docs— Documentation
scripts— Helper scripts
src— Source code
.gitignore
.npmrc
.oxlintrc.json
AGENTS.md— Instructions for Codex and other agents
CHANGELOG.md
CLAUDE.md— Instructions Claude Code reads every session
CONTRIBUTING.md
Dockerfile— Runs in Docker
FMP_API_Tools_Documentation.md
glama.json— Glama registry metadata.
knip.json
LICENSE— License
package-lock.json
package.json— Package entry points, scripts, and dependencies.
README.md— The README
server.json— Server metadata and configuration.
smithery.yaml— Smithery registry configuration.
tsconfig.json
vitest.config.ts

Discussion (0)

Ask about usage, or say what you built with it

No comments yet. Be the first to say what this is good for.

More connectors

koala73/worldmonitorConnectors

Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface

86k

DeusData/codebase-memory-mcpConnectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

lidge-jun/opencodexConnectors

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k

okf-memory/

okf-agent-memory

okf-memory/okf-agent-memoryConnectors

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547

2akouwu/

reverify

2akouwu/reverifyConnectors

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k

t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具，支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库，提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k