Finance MCP Server

A Model Context Protocol (MCP) server providing real-time financial data for stocks, cryptocurrencies, and market analysis. Seamlessly integrates with Claude and other MCP-compatible AI assistants.

Features

📈 Stock Data (Yahoo Finance)

• Real-time stock quotes with price, change, volume
• Historical OHLCV data with customizable ranges
• Stock search by company name or ticker
• Market indices tracking (S&P 500, DOW, NASDAQ)
• Sector performance analysis

🪙 Cryptocurrency Data (CoinGecko)

• Real-time crypto prices with 24h change
• Top cryptocurrencies by market cap
• Historical price data
• Crypto search functionality

📊 Advanced Analytics (Alpha Vantage)

• Company fundamentals (PE ratio, EPS, dividends)
• Technical indicators (SMA, EMA, RSI, MACD, BBANDS)
• Analyst price targets

🏛️ Economic Data (FRED)

• Federal Reserve economic indicators
• GDP, inflation, unemployment data
• Interest rates and monetary policy

💼 Portfolio Management

• Track stock and crypto holdings
• Real-time portfolio valuation
• Gain/loss calculations
• Cost basis tracking

Installation

# Using npx (recommended)
npx @anthropic/finance-mcp-server

# Or install globally
npm install -g @anthropic/finance-mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["-y", "@anthropic/finance-mcp-server"],
      "env": {
        "ALPHA_VANTAGE_KEY": "your_key_here",
        "FRED_API_KEY": "your_key_here"
      }
    }
  }
}

API Keys (Optional)

The server works out of the box with Yahoo Finance and CoinGecko (no keys required). For advanced features:

| API | Free Tier | Get Key | |-----|-----------|---------| | Alpha Vantage | 25 calls/day | alphavantage.co | | FRED | Unlimited | fred.stlouisfed.org |

Available Tools

Stock Tools

| Tool | Description | |------|-------------| | get_stock_quote | Real-time stock price and metrics | | get_stock_history | Historical OHLCV data | | search_stocks | Search stocks by name/ticker | | get_company_overview | Fundamentals and analyst data | | get_technical_indicator | Technical analysis (SMA, RSI, etc.) |

Crypto Tools

| Tool | Description | |------|-------------| | get_crypto_price | Real-time crypto price | | get_crypto_list | Top cryptos by market cap | | get_crypto_history | Historical price data | | search_crypto | Search cryptocurrencies |

Market Tools

| Tool | Description | |------|-------------| | get_market_overview | Major indices snapshot | | get_sector_performance | S&P 500 sector analysis | | get_economic_indicator | FRED economic data |

Portfolio Tools

| Tool | Description | |------|-------------| | add_to_portfolio | Add position to portfolio | | remove_from_portfolio | Remove position | | get_portfolio_value | Portfolio valuation with P&L |

Usage Examples

Get Stock Quote

"What's the current price of AAPL?"
→ Uses get_stock_quote with symbol: "AAPL"

Crypto Analysis

"Compare Bitcoin and Ethereum prices over the last month"
→ Uses get_crypto_history for both coins

Portfolio Tracking

"Add 10 shares of NVDA at $450 to my portfolio"
→ Uses add_to_portfolio with type: "stock"

Market Overview

"How are the major indices performing today?"
→ Uses get_market_overview

Technical Analysis

"What's the RSI for Tesla?"
→ Uses get_technical_indicator with indicator: "RSI"

Rate Limits

The server implements automatic rate limiting to respect API limits:

| API | Rate Limit | |-----|-----------| | Yahoo Finance | 1 req/sec | | CoinGecko | 10-50 req/min | | Alpha Vantage | 5 req/min | | FRED | 120 req/min |

Development

# Clone and install
git clone https://github.com/anthropics/finance-mcp-server
cd finance-mcp-server
npm install

# Development mode
npm run dev

# Build
npm run build

# Run
npm start

Roadmap

• [ ] Polygon.io integration for premium users
• [ ] Watchlist management
• [ ] Price alerts
• [ ] Options chain data
• [ ] News sentiment analysis
• [ ] Earnings calendar

Support

• 🐛 Report Issues
• 💬 Discussions
• ❤️ Sponsor

License

MIT © Anthropic

Disclaimer: This tool provides financial data for informational purposes only. Not financial advice. Always verify data before making investment decisions.