fmp-mcp
Use fmp-mcp as an AI-facing financial-intelligence server for live market, fundamental, ownership, screening, technical, and analyst-sentiment analysis.
Fetch and discover 60+ FMP data endpoints directly, including endpoint lists, parameter docs, company search, and company profiles.
Get market context: index moves, sector/industry performance, gainers/losers, most-active names, news, economic indicators/events, and corporate event calendars.
Analyze fundamentals: financial statements, key metrics, market-cap checks, peer ratio comparisons, benchmark-relative price performance, and parsed earnings-call transcripts.
Screen stocks/ETFs by sector, market cap, beta, dividend, volume, price, exchange, country, and industry.
Inspect institutional ownership, insider trading activity, ETF/fund holdings, sector/country exposures, and fund metadata.
Run composite technical analysis using SMA, EMA, RSI, MACD, Bollinger Bands, ADX, and Williams %R with buy/sell scoring.
Track historical analyst estimate revisions and screen ticker universes for estimate momentum.
Control outputs with summary/full formats, inline/file output, date/symbol filters, caching, and transcript section/speaker/role filters.
Supports estimate-revision tools by requiring a PostgreSQL database to store and retrieve historical EPS and revenue estimate revision data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fmp-mcp compare Apple with its peers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fmp-mcp
Financial intelligence for your AI agent — powered by live market data.
Give Claude (or any MCP-compatible AI) the ability to analyze stocks, screen markets, compare peers, read earnings calls, and track sector rotations — all grounded in real financial data from Financial Modeling Prep.
This isn't a raw API wrapper. Each tool is purpose-built for a specific analytical task, composing multiple data sources into structured, analysis-ready outputs designed for AI consumption.
The source server registers 22 MCP tools (including imported tool registrations).
The estimate-revision tools read the hosted estimates API; the estimates extra
and PostgreSQL are needed for local estimate storage, not hosted MCP reads.
What your AI can do
Market Intelligence
get_market_context— One-call market snapshot: indices, sectors, gainers/losers, economic eventsget_sector_overview— Sector and industry performance with P/E valuationsget_news— Stock-specific or broad market newsget_events_calendar— Earnings, dividends, splits, and IPO calendarsget_economic_data— Economic indicators and high-impact event tracking
Fundamental Analysis
fmp_fetch— Direct access to 60+ financial data endpoints (income statements, balance sheets, cash flows, key metrics, and more)fmp_market_cap_check— Compare current market cap against the latest annual filing valuecompare_peers— Side-by-side peer comparison across 12 financial ratiosget_earnings_transcript— Parsed earnings calls with speaker attribution and Q&A sectionsget_stock_fundamentals— Enriched stock lookup with financials, valuation, quality, and technicalsget_price_performance_windows— Compact benchmark-relative return windows
Stock Screening & Discovery
screen_stocks— Screen by sector, market cap, beta, dividend, volume, and moreget_institutional_ownership— Institutional holder analytics and ownership trendsget_insider_trades— Insider transaction flow and statisticsget_etf_holdings— ETF/fund holdings, sector and country allocation
Technical Analysis
get_technical_analysis— Composite signals from 7 indicators (SMA, EMA, RSI, MACD, Bollinger, ADX, Williams %R) with buy/sell scoring
Analyst Sentiment
get_estimate_revisions— Historical EPS/revenue estimate revision trendsscreen_estimate_revisions— Screen for estimate momentum across a universe of stocks
Data Discovery
fmp_list_endpoints— Browse all 60+ available data endpoints by categoryfmp_describe— Get parameter documentation for any endpointfmp_search— Search for companies by name or tickerfmp_profile— Company profile with sector, industry, and key stats
Related MCP server: Financial Modeling Prep MCP Server
Install
pip install fmp-mcpOptional local estimate storage (requires PostgreSQL; hosted MCP reads do not):
pip install "fmp-mcp[estimates]"Configuration
Set your API key:
export FMP_API_KEY="your_key"Optional settings:
FMP_CACHE_DIR— Custom cache directory (default:~/.cache/fmp-mcp/)FMP_CACHE_MAXSIZE— Max in-memory cache entries (default: 200)
Application integration
The installed fmp-mcp distribution owns the fmp import. It does not search
for a Risk checkout, load a checkout .env, or import application policy.
The source package lives at Risk's fmp-mcp/. Install it from the Risk root
with the single editable list, .venv/bin/python -m pip install --no-deps -r requirements-local.txt,
which also installs brokerage-connect. Dev tools come from requirements-dev.txt.
Applications must explicitly configure the client once at startup before any
network fetch. An unconfigured client refuses dispatch and names the required
configure_client(...) call. Applications can bind these callbacks:
fmp.client.configure_client(budget_guard=..., event_observer=...). The guard acceptsfn,args,kwargsplus provider/operation/budget metadata. The observer receives(event, endpoint, **details), where event issuccess(duration_ms,status),rate_limit,error(error),plan_limit(error), orcache_hit(params). Explicitconfigure_client()selects the public default:fmp.spendwrites one machine-wide API spend-ledger row per network call and a zero-callcache_hitrow per cache-answered request (hank-model-authority), refuses a call whose spend ceiling is already met withSpendCeilingExceeded, and rate limits and errors go to native Python logging. A host that passes its ownbudget_guardowns metering and nothing infmp.spendruns. The publicfmp-mcp/python -m fmp.serverentrypoint selects the default policy before serving tools.fmp.tools.peers.configure_peer_tools(metric_resolver=..., peer_discovery=..., spot_fx_rate=...). Metric resolvers return the existing structuralpeers/source/to_dict()result; discovery returns ticker strings. Expected policy failures raisePeerSelectionError. Standalone discovery uses FMPstock_peers; metric-context selection without application policy asks for explicit peers. Standalone non-USD conversion reads the latest daily close of FMP's<currency>USDpair. The optional FX callback returns a currency-to-USD rate.
Risk process entrypoints call fmp_runtime.configure() after environment
hydration to bind all five callbacks; logging, billing, peer selection, and
exchange-mapping policy remain application code. bootstrap_env.bootstrap()
only hydrates environment and never imports FMP or application policy.
scripts/run_fmp_server.py owns Risk credential hydration and policy setup
before invoking the installed fmp.server.run() (which preserves the
caller's policy). Risk-only wrappers live in utils/fmp_compat.py and
utils/fmp_fx.py. The former local estimates collector was
deleted in fee0d9403;
see estimate operations for the hosted
API and production collector.
The source retains the Hank-only transcript_kpi_fetcher.py and
manifest_source_dispatcher.py; public distribution sync excludes them.
Their application consumers require the separately installed named industry
and value-semantics libraries. Sync copies source bytes without vendoring or
rewriting imports.
Run
fmp-mcpOr register the installed package with Claude Code from any directory:
claude mcp add fmp-mcp --scope user \
-- python3 -m fmp.serverYou can also use a generic MCP config:
{
"mcpServers": {
"fmp-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["fmp-mcp"],
"env": { "FMP_API_KEY": "your_key" }
}
}
}How it's different
Raw API wrapper | fmp-mcp | |
Approach | Expose every endpoint 1:1 | Purpose-built analytical tools |
Output | Raw JSON, dozens of fields | Structured, summarized, analysis-ready |
Composition | One API call per tool | Multiple sources stitched together |
AI-optimized | Generic descriptions | Tool descriptions and schemas designed for LLM tool selection |
Caching | None | Per-endpoint disk caching with configurable refresh strategies |
Requirements
Python 3.11+
FMP API key (get one here)
Related Docs
FMP_ENDPOINTS.md— registered endpoint catalogMCP_SERVERS.md— server registration and troubleshooting
Available Tools
21 toolscompare_peersA
Compare a stock against its peers on key financial ratios.
Fetches the peer group for a stock and builds a side-by-side comparison of financial ratios including valuation, profitability, margins, and leverage. By default, auto-discovery is operating-peer oriented. For dividend payout, buyback, and shareholder-return questions, pass peer_context="capital_allocation" or metric="dividend_payout" so the peer set favors mature dividend-paying capital-allocation comps over no-dividend growth operating peers.
Inputs: symbol (required), limit, peers, format, +3 more. Returns: object
fmp_describeA
Get detailed documentation for an FMP endpoint.
Discovery tool to understand what parameters an endpoint accepts. Use this before calling fmp_fetch to know required vs optional params.
Inputs: endpoint (required). Returns: object
fmp_fetchA
Fetch data from any registered FMP endpoint.
This is the primary data fetching tool. Use fmp_list_endpoints to discover available endpoints, and fmp_describe to see required parameters.
Inputs: endpoint (required), type, year, limit, +9 more. Returns: object
fmp_list_endpointsA
List available FMP data endpoints.
Discovery tool to see what data is available. Use this first to understand what endpoints exist before fetching data.
Inputs: category. Returns: object
fmp_market_cap_checkA
Compare current profile market cap against latest annual key_metrics market cap.
Use this when fmp_profile.mktCap and fmp_fetch(endpoint="key_metrics") marketCap values appear to disagree. The profile value is a current snapshot; the latest annual key_metrics value is aligned to that row's period-end date.
Inputs: symbol (required). Returns: object
fmp_profileA
Get detailed company profile information as a current FMP /profile snapshot.
Returns comprehensive company data including sector, industry,
description, CEO, employees, website, and key financial metrics.
The profile mktCap field is price times shares as of the API call time,
or up to 1 week stale when served from cache. FMP does not include a
snapshot timestamp on this endpoint. For historical period-aligned market
cap, use fmp_fetch(endpoint="key_metrics", period="annual") and read the
date field on each row.
Inputs: symbol, ticker. Returns: object
fmp_searchB
Search for companies by name or ticker.
Convenience wrapper for company search. Returns matching companies with their symbols, names, and exchange information.
Inputs: query (required), limit, exchange. Returns: object
get_earnings_transcriptA
Parse and navigate an earnings call transcript.
Splits the raw transcript into structured sections: prepared remarks and Q&A with per-speaker segments and grouped Q&A exchanges.
IMPORTANT — default mode is summary (metadata only). This protects your context window. Full text is returned only when you explicitly request format="full".
Recommended workflow:
Call with default format="summary" to see the speaker list, word counts, and exchange count (costs ~1 KB of context)
Identify the section or speaker you need
Call again with format="full" and specific filters (section, filter_role, filter_speaker) to read only that content
Each text field is capped at max_words (default 3000). Set max_words=None to remove the cap (use with caution). Note: If format="full" is used WITHOUT any filters (no section, filter_role, or filter_speaker), a bounded preview is returned instead (first 3 segments per section, 500 words each, 2 exchanges). Add at least one filter to get full content with max_words control.
Inputs: year (required), symbol (required), quarter (required), format, +5 more. Returns: object
get_economic_dataA
Get economic indicators or upcoming economic events.
Fetches macroeconomic data from FRED via FMP. Use indicator mode for time series data (GDP, CPI, unemployment, etc.) or calendar mode for upcoming/recent economic releases.
Inputs: mode, limit, format, output, +5 more. Returns: object
get_estimate_revisionsA
Get estimate revision history for one ticker and fiscal period.
Reads snapshots through the hosted estimates API backed by the monthly
collection job. If fiscal_date is omitted, defaults to the nearest
available upcoming fiscal period for the ticker.
Inputs: ticker (required), period, fiscal_date. Returns: object
get_etf_holdingsC
Get ETF/fund composition across holdings, sector/country weights, and metadata.
Inputs: symbol (required), limit, format, output, +2 more. Returns: object
get_events_calendarA
Fetch upcoming corporate events: earnings, dividends, splits, or IPOs.
Can show market-wide calendars or filter to specific symbols. Useful for tracking upcoming catalysts and corporate actions. Date ranges wider than 90 days are split into FMP-compatible windows internally. Note: For portfolio-aware auto-fill, use get_portfolio_events_calendar on portfolio-reads-mcp.
Inputs: limit, format, symbols, to_date, +2 more. Returns: object
get_insider_tradesB
Get insider buying/selling activity and summary statistics for a stock.
Fetches recent insider transactions and aggregate insider trading stats.
Inputs: symbol (required), limit, format, use_cache. Returns: object
get_institutional_ownershipA
Get institutional ownership analytics for a stock.
Combines institutional holder-level data with aggregate ownership summary metrics to show which institutions are accumulating or reducing positions.
Inputs: symbol (required), year, limit, format, +2 more. Returns: object
get_market_contextA
Get a one-call market snapshot across indices, sectors, movers, and events.
Useful for quick "what's happening in the market?" checks. Fetches major index moves, sector heatmap, top gainers/losers, most active names, and upcoming high-impact economic events.
Inputs: format, include, use_cache. Returns: object
get_newsA
Fetch news articles for stocks or the broad market.
Three modes: stock-specific news, general market news, and company press releases. Requires symbols for stock and press modes. Note: For portfolio-aware auto-fill, use get_portfolio_news on portfolio-reads-mcp.
Inputs: mode, limit, format, quality, +3 more. Returns: object
get_price_performance_windowsA
Get compact benchmark-relative price-performance windows.
Use this for historical-coincidence evidence when a workflow needs 3-5 outperformance/underperformance periods. It fetches adjusted historical prices for the stock and benchmark, aligns common trading dates, computes rolling returns, and returns only the largest non-overlapping windows. This avoids raw historical-price CSV parsing for ordinary stock-move analysis.
Inputs: symbol (required), to_date, direction, from_date, +5 more. Returns: object
get_sector_overviewA
Get sector or industry performance and valuation overview.
Combines daily performance snapshot and P/E ratio snapshot into a unified heatmap view. Supports both sector-level and industry-level granularity.
Inputs: date, level, format, sector, +2 more. Returns: object
get_technical_analysisA
Get composite technical analysis for a single stock or ETF.
Fetches multiple technical indicators and provides trend direction, momentum signals, volatility analysis, and support/resistance levels with an overall buy/sell signal.
Inputs: symbol (required), format, last_n, output, +4 more. Returns: object
screen_estimate_revisionsA
Screen a ticker universe for material estimate momentum.
Compares latest estimates against a lookback snapshot (days ago) and
returns per-ticker deltas/direction. By default, trivial revisions are
filtered out unless either EPS changed by at least 1% of baseline consensus
or revenue changed by at least 0.5% of baseline consensus. If tickers is
omitted, screens the full stored universe.
Inputs: days, period, tickers, direction, +3 more. Returns: object
screen_stocksA
Screen stocks by fundamental criteria (sector, market cap, beta, dividend, etc.).
Searches the full universe of stocks and ETFs using financial filters. Combine multiple criteria to narrow results.
Inputs: limit, format, is_etf, sector, +14 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool has a clearly distinct purpose, covering specific financial data domains (e.g., profile, transcripts, insider trades, economics, screening). Even overlapping areas like fmp_profile and fmp_fetch are differentiated by description.
Tool names are inconsistent: some use the 'fmp_' prefix (fmp_fetch, fmp_describe) while others use 'get_' (get_news, get_earnings_transcript) or 'screen_' (screen_stocks). This mixed convention may confuse an agent.
With 21 tools covering a broad range of financial data (company, market, technical, events, ownership, etc.), the count is well-scoped for a comprehensive financial data MCP server.
The tool surface covers major financial analysis areas: profile, peers, market context, price performance, technical, sector, news, events, earnings transcripts, insider trades, institutional ownership, ETF holdings, economic data, and screening. The generic fmp_fetch endpoint fills any remaining gaps.
Maintenance
Related MCP Connectors
Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.
SEC-filed company financials with filing citations, plus market data, for AI agents
SEC filings and financial data for AI agents: 59 tools for statements, valuation and supply chains.
US stock market data for AI agents: SEC filings, financials, insider trades, 13F, options, macro.
Related MCP Servers
- AlicenseCqualityBmaintenanceEnables AI assistants to access and analyze financial data including stock information, company fundamentals, and market insights through the Financial Modeling Prep API.267360 npm149TypeScriptApache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants access to comprehensive financial data including real-time stock quotes, company fundamentals, financial statements, market analysis, economic indicators, and 250+ financial tools across 24 categories from Financial Modeling Prep API.Apache 2.0
- FlicenseAqualityFmaintenanceProvides financial data from Financial Modeling Prep for AI-assisted investment research, including company profiles, financial statements, and analyst ratings. It features high-level workflow tools for market analysis and atomic tools for deep dives into valuation and institutional ownership.21-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to access real-time stock data, financial statements, cryptocurrency information, and market data via the Financial Modeling Prep API.4MIT