Financial Modeling Prep MCP Server v2.0

A modern Model Context Protocol (MCP) server for accessing financial data from Financial Modeling Prep (FMP) API. Built with the latest MCP SDK features including tools, resources, and prompts.

Features

🔧 Tools (25 Total)

Market Data

• get_quote - Real-time stock quotes
• search_symbol - Search stocks by name or ticker
• get_market_gainers - Top performing stocks
• get_market_losers - Worst performing stocks
• get_most_active - Most actively traded stocks
• get_sector_performance - Sector performance data
• get_sp500_constituents - S&P 500 constituents

Financial Statements

• get_company_profile - Detailed company information
• get_income_statement - Income statements (annual/quarterly)
• get_balance_sheet - Balance sheets (annual/quarterly)
• get_cash_flow - Cash flow statements (annual/quarterly)
• get_stock_news - Latest stock news
• get_key_metrics - Key financial metrics (P/E, ROE, etc.)
• get_financial_ratios - Detailed financial ratios

Analyst Data

• get_analyst_estimates - Revenue and EPS forecasts
• get_price_target - Analyst price targets
• get_analyst_ratings - Upgrades/downgrades
• get_insider_trading - Insider trading activity
• get_institutional_holders - 13F institutional ownership

Technical Indicators

• get_technical_indicator_rsi - Relative Strength Index
• get_technical_indicator_sma - Simple Moving Average
• get_technical_indicator_ema - Exponential Moving Average
• get_historical_chart - Historical price data

Calendar Data

• get_earnings_calendar - Earnings announcement calendar
• get_economic_calendar - Economic data releases
• get_economic_indicator - GDP, unemployment, CPI, etc.

📚 Resources (5 Total)

Resources provide direct data access via URIs:

• fmp://company/{symbol}/profile - Company profile
• fmp://company/{symbol}/quote - Real-time quote
• fmp://company/{symbol}/financials/{statement}/{period} - Financial statements
• fmp://market/overview - Market overview (gainers, losers, active)
• fmp://market/sectors/{date} - Sector performance

💬 Prompts (3 Total)

Prompt templates for common analysis tasks:

• stock_analysis - Comprehensive stock analysis
• portfolio_evaluation - Portfolio diversification and risk analysis
• earnings_preview - Upcoming earnings preview

Installation

npm install
npm run build

Configuration

Set your FMP API key as an environment variable:

export FMP_API_KEY="your-api-key"

Get your API key from Financial Modeling Prep

Usage

Stdio Mode (Default)

# Set environment variable and run
export FMP_API_KEY="your-api-key"
npm start

# Or
FMP_API_KEY="your-api-key" node build/index.js

HTTP Mode

# Start HTTP server
npm run start:http

# Or with custom port
node build/index.js --http --port=8080

The HTTP server provides:

• POST /mcp - MCP protocol endpoint
• GET /health - Health check
• GET / - Server info

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "fmp": {
      "command": "node",
      "args": ["/path/to/aigroup-fmp-mcp/build/index.js"],
      "env": {
        "FMP_API_KEY": "your-api-key"
      }
    }
  }
}

Project Structure

aigroup-fmp-mcp/
├── src/
│   ├── index.ts          # Entry point
│   ├── server.ts         # McpServer and transport setup
│   ├── tools/            # Tool definitions
│   │   ├── index.ts      # Tool registration
│   │   ├── market.ts     # Market data tools
│   │   ├── financials.ts # Financial statement tools
│   │   ├── analysis.ts   # Analyst data tools
│   │   ├── technical.ts  # Technical indicator tools
│   │   └── calendar.ts   # Calendar data tools
│   ├── resources/        # Resource definitions
│   │   ├── index.ts      # Resource registration
│   │   └── company.ts    # Company-related resources
│   ├── prompts/          # Prompt templates
│   │   ├── index.ts      # Prompt registration
│   │   └── analysis.ts   # Analysis prompts
│   ├── types/            # TypeScript types
│   │   └── index.ts
│   └── utils/
│       └── fmp.ts        # FMP API utilities
├── package.json
├── tsconfig.json
└── README.md

API Reference

All tools use FMP's stable API endpoints. See FMP Documentation for more details.

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

What's New in v2.0

• MCP SDK v1.27.1: Uses latest McpServer class with registerTool(), registerResource(), and registerPrompt() APIs
• Zod Schema Validation: Type-safe parameter validation with Zod
• Resources: Direct data access via resource URIs
• Prompts: Reusable analysis templates
• Dual Transport: Support for both stdio and HTTP transports
• Better TypeScript: Full type definitions for all data structures

License

MIT