Financial Modeling Prep

БесплатноНе проверен

A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, compa

автор: imbenrabi

GitHub Embed

Описание

A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.

README

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.

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

from github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server

Установка Financial Modeling Prep

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server

FAQ