Access financial data and market information via Financial Modeling Prep API
npm install @houtini/fmp-mcp



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.
- 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
- Claude Desktop
- Node.js 18 or higher
- Financial Modeling Prep API key (Get one here)
Add to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
``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.
#### 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.
#### 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 symbolperiod
- (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 symbolperiod
- (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 symbolperiod
- (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 symbolperiod
- (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 symbolperiod
- (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.
#### 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.
#### get_analyst_estimates
Get analyst financial estimates (revenue, EPS forecasts).
Parameters:
- symbol (required): Stock ticker symbolperiod
- (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.
#### get_insider_trading
Get recent insider trading activity.
Parameters:
- symbol (required): Stock ticker symbollimit
- (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 symbollimit
- (optional): Number of holders to return (default: 100)
Returns: Top institutional holders with share counts and filing dates.
#### get_technical_indicator_rsi
Get Relative Strength Index (RSI).
Parameters:
- symbol (required): Stock ticker symboltimeframe
- (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 symboltimeframe
- (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 symboltimeframe
- (required): "1min", "5min", "15min", "30min", "1hour", "4hour", "1day"period
- (optional): Period length (default: 10)
Returns: EMA values with timestamps for trend analysis.
#### get_historical_chart
Get historical price data with flexible time intervals.
Parameters:
- symbol (required): Stock ticker symbolinterval
- (required): "1min", "5min", "15min", "30min", "1hour", "4hour"from
- (optional): Start date in YYYY-MM-DD formatto
- (optional): End date in YYYY-MM-DD format
Returns: OHLC price data with volume for the specified interval.
#### get_economic_calendar
Get upcoming economic data releases calendar.
Parameters:
- from (optional): Start date in YYYY-MM-DD formatto
- (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 formatto
- (optional): End date in YYYY-MM-DD format
Returns: Historical values for the specified economic indicator.
#### get_earnings_calendar
Get upcoming earnings announcements calendar.
Parameters:
- from (optional): Start date in YYYY-MM-DD formatto
- (optional): End date in YYYY-MM-DD format
Returns: Upcoming earnings dates with EPS estimates.
#### 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.
#### get_stock_news
Get latest news articles for a stock.
Parameters:
- symbol (required): Stock ticker symbollimit
- (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.
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
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.
`bash`
git clone https://github.com/houtini-ai/fmp-mcp.git
cd fmp-mcp
npm install
npm run build
`json`
{
"mcpServers": {
"financial-modeling-prep": {
"command": "node",
"args": [
"/absolute/path/to/fmp-mcp/build/index.js"
],
"env": {
"FMP_API_KEY": "your_api_key_here"
}
}
}
}
`bash`
npm run build
Output goes to the build/ directory.
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.
1. Verify your claude_desktop_config.json syntax is valid JSONFMP_API_KEY
2. Check that the environment variable is set
3. Restart Claude Desktop completely (quit from system tray/menu bar)
4. Check Claude Desktop logs for error messages
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
- Verify the stock symbol exists (use search_symbol` first)
- Check your internet connection
- Verify FMP API is operational at status.financialmodelingprep.com
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see LICENSE file for details.
- Financial Modeling Prep API
- MCP Documentation
- Claude Desktop
Built with the Model Context Protocol SDK by Anthropic.