{
  "markdown": "# Financial Modeling Prep MCP Server\n\n[![npm version](https://badge.fury.io/js/@houtini%2Ffmp-mcp.svg)](https://badge.fury.io/js/@houtini%2Ffmp-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue?style=flat-square)](https://registry.modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nModel 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.\n\n<p align=\"center\">\n  <a href=\"https://glama.ai/mcp/servers/@houtini-ai/fmp-mcp\">\n    <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@houtini-ai/fmp-mcp/badge\" alt=\"Financial Modeling Prep MCP server\" />\n  </a>\n</p>\n\n> **Quick Navigation**\n>\n> [Features](#features) | [Installation](#installation) | [Tools](#available-tools) | [Usage examples](#usage-examples) | [API rate limits](#api-rate-limits) | [Development](#development) | [Troubleshooting](#troubleshooting)\n\n## Features\n\n- **Real-time Market Data**: Live stock quotes with price, volume, and market metrics\n- **Company Information**: Detailed profiles including industry, sector, and key executives\n- **Financial Statements**: Income statements, balance sheets, and cash flow statements\n- **Market Performance**: Track gainers, losers, most active stocks, and sector performance\n- **Analyst Data**: Price targets, estimates, ratings, and upgrades/downgrades\n- **Insider Trading**: Monitor insider transactions and institutional holdings\n- **Technical Indicators**: RSI, SMA, EMA with multiple timeframes\n- **Economic Data**: GDP, unemployment, inflation, treasury rates, and economic calendar\n- **Historical Charts**: Intraday data from 1-minute to 4-hour intervals\n- **Symbol Search**: Find companies by name or ticker across global exchanges\n\n## Installation\n\n### Prerequisites\n\n- [Claude Desktop](https://claude.ai/download)\n- Node.js 18 or higher\n- Financial Modeling Prep API key ([Get one here](https://financialmodelingprep.com/developer/docs))\n\n### Quick Start with NPX\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"financial-modeling-prep\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@houtini/fmp-mcp\"\n      ],\n      \"env\": {\n        \"FMP_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nReplace `your_api_key_here` with your actual API key from Financial Modeling Prep.\n\n**Important**: Restart Claude Desktop completely after updating the configuration.\n\n### Claude Code (CLI)\n\nClaude Code uses a different registration mechanism -- it doesn't read `claude_desktop_config.json`. Use `claude mcp add` instead:\n\n```bash\nclaude mcp add -e FMP_API_KEY=your_api_key_here -s user financial-modeling-prep -- npx -y @houtini/fmp-mcp\n```\n\nVerify with:\n\n```bash\nclaude mcp get financial-modeling-prep\n```\n\nYou should see `Status: Connected`.\n\n## Available Tools\n\n### Core Market Data\n\n#### `get_quote`\nGet real-time stock quote data.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol (e.g., AAPL, TSLA, MSFT)\n\n**Returns:** Current price, volume, market cap, P/E ratio, day high/low, and more.\n\n#### `search_symbol`\nSearch for stock symbols by company name or ticker.\n\n**Parameters:**\n- `query` (required): Search query (company name or partial ticker)\n\n**Returns:** Matching symbols with company names and exchange information.\n\n### Company Fundamentals\n\n#### `get_company_profile`\nGet detailed company profile and fundamental data.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n\n**Returns:** Company description, industry, sector, CEO, employee count, headquarters, website, and key financial metrics.\n\n#### `get_income_statement`\nRetrieve company income statement data.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `period` (optional): \"annual\" or \"quarter\" (default: \"annual\")\n- `limit` (optional): Number of periods to return (default: 5)\n\n**Returns:** Revenue, expenses, net income, EPS, and other profitability metrics.\n\n#### `get_balance_sheet`\nRetrieve company balance sheet data.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `period` (optional): \"annual\" or \"quarter\" (default: \"annual\")\n- `limit` (optional): Number of periods to return (default: 5)\n\n**Returns:** Assets, liabilities, shareholder equity, and detailed line items.\n\n#### `get_cash_flow`\nRetrieve company cash flow statement data.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `period` (optional): \"annual\" or \"quarter\" (default: \"annual\")\n- `limit` (optional): Number of periods to return (default: 5)\n\n**Returns:** Operating cash flow, investing activities, financing activities, and free cash flow.\n\n#### `get_key_metrics`\nGet key financial metrics and ratios.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `period` (optional): \"annual\" or \"quarter\" (default: \"annual\")\n- `limit` (optional): Number of periods to return (default: 5)\n\n**Returns:** P/E ratio, ROE, ROA, debt ratios, current ratio, and more.\n\n#### `get_financial_ratios`\nGet detailed financial ratios (profitability, liquidity, efficiency).\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `period` (optional): \"annual\" or \"quarter\" (default: \"annual\")\n- `limit` (optional): Number of periods to return (default: 5)\n\n**Returns:** Comprehensive ratio analysis including profitability, liquidity, and efficiency metrics.\n\n### Market Performance\n\n#### `get_market_gainers`\nGet stocks with the largest price increases.\n\n**Parameters:** None\n\n**Returns:** Top gaining stocks with price changes and volume.\n\n#### `get_market_losers`\nGet stocks with the largest price drops.\n\n**Parameters:** None\n\n**Returns:** Top losing stocks with price changes and volume.\n\n#### `get_most_active`\nGet most actively traded stocks by volume.\n\n**Parameters:** None\n\n**Returns:** Stocks with highest trading volume.\n\n#### `get_sector_performance`\nGet current sector performance snapshot.\n\n**Parameters:**\n- `date` (optional): Date in YYYY-MM-DD format (defaults to latest)\n\n**Returns:** Performance metrics for all market sectors.\n\n### Analyst Data\n\n#### `get_analyst_estimates`\nGet analyst financial estimates (revenue, EPS forecasts).\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `period` (optional): \"annual\" or \"quarter\" (default: \"annual\")\n- `limit` (optional): Number of periods to return (default: 10)\n\n**Returns:** Analyst revenue and earnings estimates with consensus figures.\n\n#### `get_price_target`\nGet analyst price target summary.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n\n**Returns:** Average, high, low, and median price targets from analysts.\n\n#### `get_analyst_ratings`\nGet analyst ratings and upgrades/downgrades.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n\n**Returns:** Recent analyst rating changes, upgrades, downgrades, and recommendations.\n\n### Insider Trading & Institutional\n\n#### `get_insider_trading`\nGet recent insider trading activity.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `limit` (optional): Number of transactions to return (default: 100)\n\n**Returns:** Insider buy/sell transactions with names, dates, and amounts.\n\n#### `get_institutional_holders`\nGet institutional ownership (13F filings).\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `limit` (optional): Number of holders to return (default: 100)\n\n**Returns:** Top institutional holders with share counts and filing dates.\n\n### Technical Indicators\n\n#### `get_technical_indicator_rsi`\nGet Relative Strength Index (RSI).\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `timeframe` (required): \"1min\", \"5min\", \"15min\", \"30min\", \"1hour\", \"4hour\", \"1day\"\n- `period` (optional): Period length (default: 14)\n\n**Returns:** RSI values with timestamps for momentum analysis.\n\n#### `get_technical_indicator_sma`\nGet Simple Moving Average (SMA).\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `timeframe` (required): \"1min\", \"5min\", \"15min\", \"30min\", \"1hour\", \"4hour\", \"1day\"\n- `period` (optional): Period length (default: 10)\n\n**Returns:** SMA values with timestamps for trend analysis.\n\n#### `get_technical_indicator_ema`\nGet Exponential Moving Average (EMA).\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `timeframe` (required): \"1min\", \"5min\", \"15min\", \"30min\", \"1hour\", \"4hour\", \"1day\"\n- `period` (optional): Period length (default: 10)\n\n**Returns:** EMA values with timestamps for trend analysis.\n\n### Historical Data\n\n#### `get_historical_chart`\nGet historical price data with flexible time intervals.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `interval` (required): \"1min\", \"5min\", \"15min\", \"30min\", \"1hour\", \"4hour\"\n- `from` (optional): Start date in YYYY-MM-DD format\n- `to` (optional): End date in YYYY-MM-DD format\n\n**Returns:** OHLC price data with volume for the specified interval.\n\n### Economic Data\n\n#### `get_economic_calendar`\nGet upcoming economic data releases calendar.\n\n**Parameters:**\n- `from` (optional): Start date in YYYY-MM-DD format\n- `to` (optional): End date in YYYY-MM-DD format\n\n**Returns:** Scheduled economic announcements with dates and expected impact.\n\n#### `get_economic_indicator`\nGet economic indicator data (GDP, unemployment, inflation, etc.).\n\n**Parameters:**\n- `name` (required): Indicator name (e.g., \"GDP\", \"unemploymentRate\", \"CPI\")\n- `from` (optional): Start date in YYYY-MM-DD format\n- `to` (optional): End date in YYYY-MM-DD format\n\n**Returns:** Historical values for the specified economic indicator.\n\n### Events & Calendars\n\n#### `get_earnings_calendar`\nGet upcoming earnings announcements calendar.\n\n**Parameters:**\n- `from` (optional): Start date in YYYY-MM-DD format\n- `to` (optional): End date in YYYY-MM-DD format\n\n**Returns:** Upcoming earnings dates with EPS estimates.\n\n### Index Data\n\n#### `get_sp500_constituents`\nGet list of S&P 500 index constituents.\n\n**Parameters:** None\n\n**Returns:** All companies in the S&P 500 with symbols and details.\n\n### News (Paid Feature)\n\n#### `get_stock_news`\nGet latest news articles for a stock.\n\n**Parameters:**\n- `symbol` (required): Stock ticker symbol\n- `limit` (optional): Number of articles to return (default: 10)\n\n**Returns:** News headlines, publication dates, URLs, and article summaries.\n\n**Note:** This endpoint requires a paid FMP plan.\n\n## Usage Examples\n\nOnce installed, you can interact with the MCP server directly through Claude Desktop:\n\n```\nGet a quote for Apple stock\n```\n\n```\nShow me Tesla's quarterly income statements for the last 8 quarters\n```\n\n```\nWhat are today's biggest market gainers?\n```\n\n```\nGet analyst price targets for NVIDIA\n```\n\n```\nShow me insider trading activity for Microsoft\n```\n\n```\nCalculate the 14-day RSI for TSLA on the daily timeframe\n```\n\n```\nWhat's the current sector performance?\n```\n\n```\nGet upcoming earnings announcements for this week\n```\n\n```\nShow me institutional holders of Amazon\n```\n\n## API Rate Limits\n\nFinancial Modeling Prep offers different pricing tiers:\n\n- **Free Tier**: 250 requests/day\n- **Starter**: 500 requests/day  \n- **Professional**: 1,000+ requests/day\n\nSee [FMP Pricing](https://financialmodelingprep.com/developer/docs/pricing) for current plans and limits.\n\n## Development\n\n### Local Installation\n\n```bash\ngit clone https://github.com/houtini-ai/fmp-mcp.git\ncd fmp-mcp\nnpm install\nnpm run build\n```\n\n### Claude Desktop Configuration for Local Development\n\n```json\n{\n  \"mcpServers\": {\n    \"financial-modeling-prep\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/absolute/path/to/fmp-mcp/build/index.js\"\n      ],\n      \"env\": {\n        \"FMP_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Building\n\n```bash\nnpm run build\n```\n\nOutput goes to the `build/` directory.\n\n## API Coverage\n\nThis MCP server implements 29 endpoints from the Financial Modeling Prep API:\n\n**Core Market Data** (3)\n- Stock quotes, symbol search, company profiles\n\n**Financial Statements** (6)\n- Income statement, balance sheet, cash flow, key metrics, financial ratios (annual & quarterly)\n\n**Market Performance** (4)\n- Gainers, losers, most active, sector performance\n\n**Analyst Data** (3)\n- Estimates, price targets, ratings\n\n**Insider & Institutional** (2)\n- Insider trading, institutional holders\n\n**Technical Indicators** (3)\n- RSI, SMA, EMA with multiple timeframes\n\n**Historical Data** (1)\n- Intraday charts (1min to 4hour)\n\n**Economic Data** (2)\n- Economic calendar, economic indicators\n\n**Events & Calendars** (1)\n- Earnings calendar\n\n**Index Data** (1)\n- S&P 500 constituents\n\n**News** (1)\n- Stock news (paid feature)\n\nFor the complete API reference, see the [FMP Developer Documentation](https://site.financialmodelingprep.com/developer/docs).\n\n## Troubleshooting\n\n### MCP Server Not Appearing in Claude Desktop\n\n1. Verify your `claude_desktop_config.json` syntax is valid JSON\n2. Check that the `FMP_API_KEY` environment variable is set\n3. Restart Claude Desktop completely (quit from system tray/menu bar)\n4. Check Claude Desktop logs for error messages\n\n### API Authentication Errors\n\nIf you see `403 Forbidden` errors:\n- Verify your API key is correct\n- Check you haven't exceeded your rate limit\n- Ensure your API key has the required permissions\n\n### Tool Execution Failures\n\n- Verify the stock symbol exists (use `search_symbol` first)\n- Check your internet connection\n- Verify FMP API is operational at [status.financialmodelingprep.com](https://financialmodelingprep.com)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Resources\n\n- [Financial Modeling Prep API](https://financialmodelingprep.com)\n- [MCP Documentation](https://modelcontextprotocol.io)\n- [Claude Desktop](https://claude.ai/download)\n\n## Acknowledgments\n\nBuilt with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/sdk) by Anthropic.\n",
  "bytes": 14213,
  "sha": "3eeba3fbfce4a48a0e350a6874f4a2190cde04e2884c54472684e8db51202690",
  "repo_slug": "houtini-ai/fmp-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_houtini_ai_fmp_35c8d9e9/readme"
}