Financial Modeling Prep MCP Server

Model Context Protocol (MCP) server providing access to Financial Modeling Prep's comprehensive financial data API. Get real-time stock quotes, company fundamentals, financial statements, market insights, analyst data, and technical indicators directly in Claude Desktop.

Quick Navigation

Features | Installation | Tools | Usage examples | API rate limits | Development | Troubleshooting

Features

• Real-time Market Data: Live stock quotes with price, volume, and market metrics
• Company Information: Detailed profiles including industry, sector, and key executives
• Financial Statements: Income statements, balance sheets, and cash flow statements
• Market Performance: Track gainers, losers, most active stocks, and sector performance
• Analyst Data: Price targets, estimates, ratings, and upgrades/downgrades
• Insider Trading: Monitor insider transactions and institutional holdings
• Technical Indicators: RSI, SMA, EMA with multiple timeframes
• Economic Data: GDP, unemployment, inflation, treasury rates, and economic calendar
• Historical Charts: Intraday data from 1-minute to 4-hour intervals
• Symbol Search: Find companies by name or ticker across global exchanges

Installation

Prerequisites

• Claude Desktop
• Node.js 18 or higher
• Financial Modeling Prep API key (Get one here)

Quick Start with NPX

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "financial-modeling-prep": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/fmp-mcp"
      ],
      "env": {
        "FMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with your actual API key from Financial Modeling Prep.

Important: Restart Claude Desktop completely after updating the configuration.

Claude Code (CLI)

Claude Code uses a different registration mechanism -- it doesn't read claude_desktop_config.json. Use claude mcp add instead:

claude mcp add -e FMP_API_KEY=your_api_key_here -s user financial-modeling-prep -- npx -y @houtini/fmp-mcp

Verify with:

claude mcp get financial-modeling-prep

You should see Status: Connected.

Available Tools

Core Market Data

get_quote

Get real-time stock quote data.

Parameters:

• symbol (required): Stock ticker symbol (e.g., AAPL, TSLA, MSFT)

Returns: Current price, volume, market cap, P/E ratio, day high/low, and more.

search_symbol

Search for stock symbols by company name or ticker.

Parameters:

• query (required): Search query (company name or partial ticker)

Returns: Matching symbols with company names and exchange information.

Company Fundamentals

get_company_profile

Get detailed company profile and fundamental data.

Parameters:

• symbol (required): Stock ticker symbol

Returns: Company description, industry, sector, CEO, employee count, headquarters, website, and key financial metrics.

get_income_statement

Retrieve company income statement data.

Parameters:

• symbol (required): Stock ticker symbol
• period (optional): "annual" or "quarter" (default: "annual")
• limit (optional): Number of periods to return (default: 5)

Returns: Revenue, expenses, net income, EPS, and other profitability metrics.

get_balance_sheet

Retrieve company balance sheet data.

Parameters:

• symbol (required): Stock ticker symbol
• period (optional): "annual" or "quarter" (default: "annual")
• limit (optional): Number of periods to return (default: 5)

Returns: Assets, liabilities, shareholder equity, and detailed line items.

get_cash_flow

Retrieve company cash flow statement data.

Parameters:

• symbol (required): Stock ticker symbol
• period (optional): "annual" or "quarter" (default: "annual")
• limit (optional): Number of periods to return (default: 5)

Returns: Operating cash flow, investing activities, financing activities, and free cash flow.

get_key_metrics

Get key financial metrics and ratios.

Parameters:

• symbol (required): Stock ticker symbol
• period (optional): "annual" or "quarter" (default: "annual")
• limit (optional): Number of periods to return (default: 5)

Returns: P/E ratio, ROE, ROA, debt ratios, current ratio, and more.

get_financial_ratios

Get detailed financial ratios (profitability, liquidity, efficiency).

Parameters:

• symbol (required): Stock ticker symbol
• period (optional): "annual" or "quarter" (default: "annual")
• limit (optional): Number of periods to return (default: 5)

Returns: Comprehensive ratio analysis including profitability, liquidity, and efficiency metrics.

Market Performance

get_market_gainers

Get stocks with the largest price increases.

Parameters: None

Returns: Top gaining stocks with price changes and volume.

get_market_losers

Get stocks with the largest price drops.

Parameters: None

Returns: Top losing stocks with price changes and volume.

get_most_active

Get most actively traded stocks by volume.

Parameters: None

Returns: Stocks with highest trading volume.

get_sector_performance

Get current sector performance snapshot.

Parameters:

• date (optional): Date in YYYY-MM-DD format (defaults to latest)

Returns: Performance metrics for all market sectors.

Analyst Data

get_analyst_estimates

Get analyst financial estimates (revenue, EPS forecasts).

Parameters:

• symbol (required): Stock ticker symbol
• period (optional): "annual" or "quarter" (default: "annual")
• limit (optional): Number of periods to return (default: 10)

Returns: Analyst revenue and earnings estimates with consensus figures.

get_price_target

Get analyst price target summary.

Parameters:

• symbol (required): Stock ticker symbol

Returns: Average, high, low, and median price targets from analysts.

get_analyst_ratings

Get analyst ratings and upgrades/downgrades.

Parameters:

• symbol (required): Stock ticker symbol

Returns: Recent analyst rating changes, upgrades, downgrades, and recommendations.

Insider Trading & Institutional

get_insider_trading

Get recent insider trading activity.

Parameters:

• symbol (required): Stock ticker symbol
• limit (optional): Number of transactions to return (default: 100)

Returns: Insider buy/sell transactions with names, dates, and amounts.

get_institutional_holders

Get institutional ownership (13F filings).

Parameters:

• symbol (required): Stock ticker symbol
• limit (optional): Number of holders to return (default: 100)

Returns: Top institutional holders with share counts and filing dates.

Technical Indicators

get_technical_indicator_rsi

Get Relative Strength Index (RSI).

Parameters:

• symbol (required): Stock ticker symbol
• timeframe (required): "1min", "5min", "15min", "30min", "1hour", "4hour", "1day"
• period (optional): Period length (default: 14)

Returns: RSI values with timestamps for momentum analysis.

get_technical_indicator_sma

Get Simple Moving Average (SMA).

Parameters:

• symbol (required): Stock ticker symbol
• timeframe (required): "1min", "5min", "15min", "30min", "1hour", "4hour", "1day"
• period (optional): Period length (default: 10)

Returns: SMA values with timestamps for trend analysis.

get_technical_indicator_ema

Get Exponential Moving Average (EMA).

Parameters:

• symbol (required): Stock ticker symbol
• timeframe (required): "1min", "5min", "15min", "30min", "1hour", "4hour", "1day"
• period (optional): Period length (default: 10)

Returns: EMA values with timestamps for trend analysis.

Historical Data

get_historical_chart

Get historical price data with flexible time intervals.

Parameters:

• symbol (required): Stock ticker symbol
• interval (required): "1min", "5min", "15min", "30min", "1hour", "4hour"
• from (optional): Start date in YYYY-MM-DD format
• to (optional): End date in YYYY-MM-DD format

Returns: OHLC price data with volume for the specified interval.

Economic Data

get_economic_calendar

Get upcoming economic data releases calendar.

Parameters:

• from (optional): Start date in YYYY-MM-DD format
• to (optional): End date in YYYY-MM-DD format

Returns: Scheduled economic announcements with dates and expected impact.

get_economic_indicator

Get economic indicator data (GDP, unemployment, inflation, etc.).

Parameters:

• name (required): Indicator name (e.g., "GDP", "unemploymentRate", "CPI")
• from (optional): Start date in YYYY-MM-DD format
• to (optional): End date in YYYY-MM-DD format

Returns: Historical values for the specified economic indicator.

Events & Calendars

get_earnings_calendar

Get upcoming earnings announcements calendar.