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.

Parameters:

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

Returns: Upcoming earnings dates with EPS estimates.

Index Data

`get_sp500_constituents`

Get list of S&P 500 index constituents.

Parameters: None

Returns: All companies in the S&P 500 with symbols and details.

News (Paid Feature)

`get_stock_news`

Get latest news articles for a stock.

Parameters:

symbol (required): Stock ticker symbol
limit (optional): Number of articles to return (default: 10)

Returns: News headlines, publication dates, URLs, and article summaries.

Note: This endpoint requires a paid FMP plan.

Usage Examples

Once installed, you can interact with the MCP server directly through Claude Desktop:

Get a quote for Apple stock

Show me Tesla's quarterly income statements for the last 8 quarters

What are today's biggest market gainers?

Get analyst price targets for NVIDIA

Show me insider trading activity for Microsoft

Calculate the 14-day RSI for TSLA on the daily timeframe

What's the current sector performance?

Get upcoming earnings announcements for this week

Show me institutional holders of Amazon

API Rate Limits

Financial Modeling Prep offers different pricing tiers:

Free Tier: 250 requests/day
Starter: 500 requests/day
Professional: 1,000+ requests/day

See FMP Pricing for current plans and limits.

Development

Local Installation

git clone https://github.com/houtini-ai/fmp-mcp.git
cd fmp-mcp
npm install
npm run build

Claude Desktop Configuration for Local Development

{
  "mcpServers": {
    "financial-modeling-prep": {
      "command": "node",
      "args": [
        "/absolute/path/to/fmp-mcp/build/index.js"
      ],
      "env": {
        "FMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Building

npm run build

Output goes to the build/ directory.

API Coverage

This MCP server implements 29 endpoints from the Financial Modeling Prep API:

Core Market Data (3)

Stock quotes, symbol search, company profiles

Financial Statements (6)

Income statement, balance sheet, cash flow, key metrics, financial ratios (annual & quarterly)

Market Performance (4)

Gainers, losers, most active, sector performance

Analyst Data (3)

Estimates, price targets, ratings

Insider & Institutional (2)

Insider trading, institutional holders

Technical Indicators (3)

RSI, SMA, EMA with multiple timeframes

Historical Data (1)

Intraday charts (1min to 4hour)

Economic Data (2)

Economic calendar, economic indicators

Events & Calendars (1)

Earnings calendar

Index Data (1)

S&P 500 constituents

News (1)

Stock news (paid feature)

For the complete API reference, see the FMP Developer Documentation.

Troubleshooting

MCP Server Not Appearing in Claude Desktop

Verify your claude_desktop_config.json syntax is valid JSON
Check that the FMP_API_KEY environment variable is set
Restart Claude Desktop completely (quit from system tray/menu bar)
Check Claude Desktop logs for error messages

API Authentication Errors

If you see 403 Forbidden errors:

Verify your API key is correct
Check you haven't exceeded your rate limit
Ensure your API key has the required permissions

Tool Execution Failures

Verify the stock symbol exists (use search_symbol first)
Check your internet connection
Verify FMP API is operational at status.financialmodelingprep.com

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Resources

Acknowledgments

Built with the Model Context Protocol SDK by Anthropic.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
src		src
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
houtini-logo.png		houtini-logo.png
package-lock.json		package-lock.json
package.json		package.json
server.json		server.json
tsconfig.json		tsconfig.json

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Financial Modeling Prep MCP Server

Features

Installation

Prerequisites

Quick Start with NPX

Claude Code (CLI)

Available Tools

Core Market Data

get_quote

search_symbol

Company Fundamentals

get_company_profile

get_income_statement

get_balance_sheet

get_cash_flow

get_key_metrics

get_financial_ratios

Market Performance

get_market_gainers

get_market_losers

get_most_active

get_sector_performance

Analyst Data

get_analyst_estimates

get_price_target

get_analyst_ratings

Insider Trading & Institutional

get_insider_trading

get_institutional_holders

Technical Indicators

get_technical_indicator_rsi

get_technical_indicator_sma

get_technical_indicator_ema

Historical Data

get_historical_chart

Economic Data

get_economic_calendar

get_economic_indicator

Events & Calendars

get_earnings_calendar

Index Data

get_sp500_constituents

News (Paid Feature)

get_stock_news

Usage Examples

API Rate Limits

Development

Local Installation

Claude Desktop Configuration for Local Development

Building

API Coverage

Troubleshooting

MCP Server Not Appearing in Claude Desktop

API Authentication Errors

Tool Execution Failures

Contributing

License

Resources

Acknowledgments

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`get_quote`

`search_symbol`

`get_company_profile`

`get_income_statement`

`get_balance_sheet`

`get_cash_flow`

`get_key_metrics`

`get_financial_ratios`

`get_market_gainers`

`get_market_losers`

`get_most_active`

`get_sector_performance`

`get_analyst_estimates`

`get_price_target`

`get_analyst_ratings`

`get_insider_trading`

`get_institutional_holders`

`get_technical_indicator_rsi`

`get_technical_indicator_sma`

`get_technical_indicator_ema`

`get_historical_chart`

`get_economic_calendar`

`get_economic_indicator`

`get_earnings_calendar`

`get_sp500_constituents`

`get_stock_news`