FMP MCP Server
MCP server for Financial Modeling Prep API. Enables Claude to access real-time stock data, financial statements, cryptocurrency information, and market data.
Features
Company (9 tools): Profile, search, screening, CIK/CUSIP/ISIN lookup, stock list, news search
Market (7 tools): Real-time quotes, historical prices, P/E ratios, sector/industry performance
Crypto (6 tools): Quotes, list, intraday data, daily historical data, news, search news
Financials (4 tools): Income statement, balance sheet, cash flow, growth metrics
Installation
git clone https://github.com/yourusername/fmp-mcp.git
cd fmp-mcp
pip install -e .
# Setup API key
cp .env.example .env
# Edit .env and add your FMP_API_KEYPrerequisites: Python 3.10+, FMP API key
Usage
Add to Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"fmp": {
"command": "python",
"args": ["-m", "fmp_mcp.server"],
"env": {
"FMP_API_KEY": "your_api_key_here"
}
}
}
}Example Prompts
- "What's Apple's current stock price and market cap?"
- "Find technology companies with market cap over $100B"
- "Show me Tesla's income statement for the last 3 years"
- "What's the current Bitcoin price?"
- "Get historical prices for NVDA over the last 30 days"
- "Search for recent news about Apple and Tesla stocks"
- "Get daily Bitcoin historical prices for the last month"
Development
pytest # Run tests
black src/ tests/ # Format code
ruff check src/ tests/ # Lint codeTroubleshooting
API Key Issues: Verify key in .env or Claude config
Connection Issues: Check path in claude_desktop_config.json
Debug: Use MCP Inspector ``bash npx @modelcontextprotocol/inspector python -m fmp_mcp.server ``
Links
License
MIT
