Financial Modeling Prep

Provides access to real-time market data, company fundamentals, financial statements, market insights, and more via MCP.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "houtini-ai-fmp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/fmp-mcp"
      ],
      "env": {
        "FMP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You set up a Model Context Protocol (MCP) server to access Financial Modeling Prep’s comprehensive financial data through Claude Desktop. This enables you to query real-time quotes, company fundamentals, financial statements, market insights, and more, directly from your conversational assistant for quick, informed decisions.

How to use

You will connect Claude Desktop to the MCP server that runs locally or remotely. Once connected, you can issue natural language requests to retrieve stock quotes, company profiles, financial statements, market performance data, and technical indicators. Use simple prompts like asking for a quote, viewing a company’s income statement, checking market gainers, or fetching analyst targets. If you ever need to change the API key, update the environment variable used to authenticate with Financial Modeling Prep and restart Claude Desktop.

How to install

Prerequisites you must prepare before installing the MCP server include the following:

Choose one of the supported installation approaches below and follow the steps exactly to enable the MCP server in Claude Desktop.

Option A: Quick Start with NPX (recommended for quick testing)

{
  "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 Financial Modeling Prep API key. After saving, completely restart Claude Desktop to apply the changes.

Option B: Local development with Claude Desktop (direct Node.js runtime)

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

Note: For Option B, ensure the path to the built server script is accurate after you run the build step.

Additional sections

Configuration details and usage tips help you maximize the MCP server experience.

Notes on installation and usage

Restart Claude Desktop completely after updating the MCP configuration to ensure the server is loaded properly.
If you encounter authentication errors, verify that your FMP_API_KEY is correct and that your plan permits the requested data. Monitor for rate limits based on your subscription tier.

Troubleshooting

If the MCP server does not appear in Claude Desktop, verify the JSON syntax of your configuration, confirm the API key environment variable is set, and restart Claude Desktop fully. Check for error messages in Claude Desktop logs.

Available tools

get_quote

Fetches real-time stock quote data including price, volume, market metrics, and key indicators.

search_symbol

Searches for stock symbols by company name or ticker and returns matching results with exchange information.

get_company_profile

Returns a detailed company profile with sector, industry, CEO, headquarters, and core financial metrics.

get_income_statement

Retrieves income statement data for a given symbol, with annual or quarterly periods and a customizable limit.

get_balance_sheet

Retrieves balance sheet data for a given symbol, with annual or quarterly periods and a customizable limit.

get_cash_flow

Retrieves cash flow statement data for a given symbol, with annual or quarterly periods and a customizable limit.

get_key_metrics

Provides key financial metrics and ratios for a symbol across time periods.

get_financial_ratios

Delivers detailed financial ratios including profitability, liquidity, and efficiency metrics.

get_market_gainers

Lists top stocks showing the largest price gains.

get_market_losers

Lists top stocks showing the largest price declines.

get_most_active

Lists the most actively traded stocks by volume.

get_sector_performance

Returns current performance metrics for market sectors.

get_analyst_estimates

Fetches analyst revenue and earnings estimates with consensus figures.

get_price_target

Returns analyst price target summaries including averages and ranges.

get_analyst_ratings

Provides recent analyst ratings and recommendations.

get_insider_trading

Retrieves insider trading activity with details like dates and volumes.

get_institutional_holders

Provides top institutional holders and related share data.

get_technical_indicator_rsi

Returns RSI values for momentum analysis across timeframes.

get_technical_indicator_sma

Returns SMA values for trend analysis across timeframes.

get_technical_indicator_ema

Returns EMA values for trend analysis across timeframes.

get_historical_chart

Provides historical OHLC data with volume for specified intervals.

get_economic_calendar

Returns upcoming economic releases with dates and impact.

get_economic_indicator

Fetches historical values for specified economic indicators.

get_earnings_calendar

Provides upcoming earnings dates with estimates.

get_sp500_constituents

Returns the list of S&P 500 constituents with symbols.

get_stock_news

Fetches latest stock news headlines and summaries (paid feature).