Pricing

Rating

Developer

Actor stats

Categories

Share

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

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. No API key required.

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

finance.market_summary

Get major market indices and top crypto. Works without an API key (crypto only). Add Alpha Vantage key to include stock indices.

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

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
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

Local Development

# Install dependencies
npminstall
# Run tests (mocked)
npmtest
# 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