Financial APIs MCP Server

MCP Server connecting Claude/AI agents to real-time financial data. Stock quotes, crypto prices, historical data, forex rates, and AI-powered market analysis.

Features

• Real-time Stock Quotes - Get current price, change, volume, and key metrics
• Historical Stock Data - OHLCV data with multiple intervals (1min to monthly)
• Crypto Quotes - Real-time prices for 50+ cryptocurrencies via CoinGecko
• Crypto History - Historical price, market cap, and volume data
• Market Summary - Major indices (S&P 500, NASDAQ, DOW) and top crypto
• Forex Rates - Currency exchange rates for 150+ currencies
• AI Analysis - GPT-4 powered market analysis (technical, fundamental, sentiment)

Data Sources

Source	Data Types	Rate Limits
Alpha Vantage	Stocks, Forex	25/day (free), 75/min (premium)
CoinGecko	Crypto	10-30/min (free)

Tools

finance.stock_quote

Get real-time stock price and key metrics.

{
  "tool": "finance.stock_quote",
  "symbol": "AAPL",
  "alphaVantageApiKey": "your-api-key"
}

finance.stock_history

Get historical OHLCV data.

{
  "tool": "finance.stock_history",
  "symbol": "AAPL",
  "interval": "daily",
  "outputSize": "compact",
  "alphaVantageApiKey": "your-api-key"
}

Intervals: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly

finance.crypto_quote

Get real-time crypto price from CoinGecko (no API key required).

{
  "tool": "finance.crypto_quote",
  "symbol": "BTC"
}

Supported symbols: BTC, ETH, SOL, XRP, DOGE, ADA, AVAX, DOT, MATIC, LINK, UNI, ATOM, LTC, and 40+ more.

finance.crypto_history

Get historical crypto data.

{
  "tool": "finance.crypto_history",
  "symbol": "ETH",
  "days": 30
}

finance.market_summary

Get major market indices and top crypto.

{
  "tool": "finance.market_summary",
  "alphaVantageApiKey": "your-api-key"
}

finance.currency_rate

Get forex exchange rates.

{
  "tool": "finance.currency_rate",
  "fromCurrency": "USD",
  "toCurrency": "EUR",
  "alphaVantageApiKey": "your-api-key"
}

finance.ai_analyze

AI-powered market analysis using GPT-4.

{
  "tool": "finance.ai_analyze",
  "symbol": "AAPL",
  "assetType": "stock",
  "analysisType": "comprehensive",
  "alphaVantageApiKey": "your-api-key",
  "openaiApiKey": "your-openai-key"
}

Analysis types:

• summary - Quick overview
• technical - Chart patterns and indicators
• fundamental - Valuation and financials
• sentiment - Market sentiment analysis
• comprehensive - Full analysis

API Keys

Alpha Vantage (Required for stocks/forex)

1. Get a free API key at https://www.alphavantage.co/support/#api-key
2. Free tier: 25 API calls/day, 5 calls/minute
3. Premium plans available for higher limits

OpenAI (Required for AI analysis)

1. Get your API key from https://platform.openai.com/api-keys
2. Uses GPT-4o by default (configurable)

CoinGecko (No key required)

• Crypto data works without an API key
• Free tier: 10-30 calls/minute

Response Format

All tools return a consistent response structure:

{
  "status": "ok",
  "errors": [],
  "warnings": [],
  "artifacts": [],
  ...data
}

Error Codes

Code	Description
INVALID_SYMBOL	Stock/crypto symbol not found
RATE_LIMITED	API rate limit exceeded
NO_API_KEY	Required API key not provided
INVALID_INPUT	Missing or malformed parameters
AI_ERROR	OpenAI API error
API_ERROR	External API error

Local Development

# Install dependencies
npm install

# Run tests (mocked)
npm test

# Run tests (live - requires API keys)
ALPHA_VANTAGE_API_KEY=xxx npm run test:live

Deployment to Apify

# Using Apify CLI
apify login
apify push

Pricing

This actor is designed for PPE (Pay Per Event) pricing on Apify:

• Each tool call = 1 event
• Minimal compute usage
• No browser/Playwright required (unlike PDF server)

MCP Integration

Works with any MCP-compatible client:

• Claude Desktop
• VS Code with Continue
• Custom AI agents

License

MIT