Alpha Vantage MCP Server is a Model Context Protocol (MCP) server designed to provide real-time access to financial market data through the free Alpha Vantage API. It implements a standardized interface for retrieving stock quotes and company information.
Key capabilities include:
- Real-time stock quotes with price, volume, and change data
- Detailed company information, including sector, industry, and market capitalization
- Real-time cryptocurrency exchange rates with bid/ask prices
- Daily, weekly, and monthly cryptocurrency time series data
- Real-time options chain data with Greeks and implied volatility
- Historical options chain data with advanced filtering and sorting
- Comprehensive ETF profile data, including holdings, sector allocation, and key metrics
- Upcoming earnings calendar with customizable time ranges
- Historical earnings data, including annual and quarterly reports
- Built-in error handling and rate limit management
Usage: Using via Claude Desktop:
- Clone the repository and build a local image for use with the Claude desktop client.
- Modify the claude_desktop_config.json file, replacing REPLACE_API_KEY with your actual key.
- MacOS path: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows path: %APPDATA%/Claude/claude_desktop_config.json
- Alpha Vantage MCP Server can be automatically installed into Claude Desktop via Smithery.
- After connecting the Claude client via the JSON file and installing the package, Claude should be able to see the server's MCP tools.
- You can run the server yourself in the alpha-vantage-mcp repository.
Available tools (twelve in total):
- get-stock-quote: Get the latest stock quote for a specific company
- get-company-info: Get stock-related information for a specific company
- get-crypto-exchange-rate: Get the current cryptocurrency exchange rate
- get-time-series: Get historical daily price data for a stock
- get-realtime-options: Get real-time options chain data, including Greeks and implied volatility
- get-historical-options: Get historical options chain data with advanced filtering and sorting
- get-etf-profile: Get comprehensive ETF profile information, including holdings and sector allocation
- get-crypto-daily: Get daily time series data for a cryptocurrency
- get-crypto-weekly: Get weekly time series data for a cryptocurrency
- get-crypto-monthly: Get monthly time series data for a cryptocurrency
- get-earnings-calendar: Get upcoming earnings calendar data for companies
- get-historical-earnings: Get historical earnings data for a specific company
Note: The get-realtime-options endpoint requires an Alpha Vantage Premium subscription (600 requests/minute or 1200 requests/minute plan). The standard 75 requests/minute plan and free accounts will receive placeholder/demo data rather than real market data. For most use cases, get-historical-options is recommended, as it works with all API key tiers.
Error handling: The server includes comprehensive error handling for various scenarios, including rate limit exceeded, invalid API key, network connection issues, timeout handling, and malformed responses. Error messages are returned in a clear, human-readable format.
System requirements: Python 3.12 or higher.
This MCP server is licensed under the MIT License.
