Skip to main content
Glama
ecemendoza702

Financial Modeling Prep MCP Server

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

Related MCP server: Financial Modeling Prep MCP Server

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

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

  • Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

  • Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.

  • Your agent needs markets — prices and fundamentals for listed companies, the filings behind them, crypto, and what the prediction markets put the odds at. **What you can ask for** • "Pull this company's income statement, cash flow and balance sheet for the last 8 quarters." • "What did insiders buy or sell, and when?" • "Snapshot prices for these 50 tickers, then the OHLC history for the three that moved." • "What are the current odds on this event across Kalshi and Polymarket?" • "Screen for companies matching these financial criteria." **How to use it** Point any MCP client at https://mcp.aisa.one/finance/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: prices and snapshots, income statements, balance sheets and cash flows, metrics and ratios, earnings and analyst estimates, filings and line-item search, insider trades, macro interest rates, news, a screener; CoinGecko spot prices, market tables, OHLC, per-venue tickers and trending; Kalshi and Polymarket markets and trades; plus EDINET filings for Japan. **Why this rather than the source** Equities, crypto and event markets behind one account, so a cross-asset question is one conversation. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the number here, then ask the same agent what X is saying about the ticker today — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/marketpulse/mcp · /crypto-market-data/mcp · /prediction-market-data/mcp · /stock-pulse/mcp for one slice each.

  • 315 finance tools, 35 prompts: quant, SEC and EU filings, fact checks, rates, odds, DeFi, macro.

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Exposes 250+ tools across 24 categories spanning stocks, ETFs, crypto, forex, commodities, and economics, letting AI assistants query quotes, financial statements, company fundamentals, technical indicators, SEC filings, and market news. Supports dynamic runtime toolset loading, pre-loaded static toolsets, or all tools at once over HTTP/SSE, either via a hosted instance or self-hosting.
    436 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering equities, ETFs, crypto, forex, commodities, and economics. It supports dynamic toolset loading and can be hosted or self-hosted over HTTP/SSE.
    436 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Exposes 250+ financial data tools across 24 categories to AI assistants, covering stocks, ETFs, crypto, forex, commodities, economics, company fundamentals, financial statements, quotes, and market news. It supports dynamic, static, or full toolset loading over HTTP/SSE for hosted or self-hosted deployment.
    436 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering equities, ETFs, crypto, forex, commodities, economics, and more. Supports dynamic or static toolsets over HTTP/SSE for integration with MCP clients.
    436 npm
    Apache 2.0