berlinbra/alpha-vantage-mcp

A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
Features
- Real-time stock quotes with price, volume, and change data
- Detailed company information including sector, industry, and market cap
- 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 with holdings, sector allocation, and key metrics
- Upcoming earnings calendar with customizable time horizons
- Historical earnings data with annual and quarterly reports
- Built-in error handling and rate limit management
Installation
Using Claude Desktop
Installing via Docker
- Clone the repository and build a local image to be utilized by your Claude desktop client
- Change your claude_desktop_config.json to match the following, replacing REPLACE_API_KEY with your actual key:
> claude_desktop_config.json path
>
> - On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
> - On Windows: %APPDATA%/Claude/claude_desktop_config.json
Installing via Smithery
To install Alpha Vantage MCP Server for Claude Desktop automatically via Smithery:
Development/Unpublished Servers Configuration
Install packages
Running
After connecting Claude client with the MCP tool via json file and installing the packages, Claude should see the server's mcp tools:
You can run the sever yourself via:
In alpha-vantage-mcp repo:
with inspector
Available Tools
The server implements twelve tools:
- 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 current cryptocurrency exchange rates
- get-time-series: Get historical daily price data for a stock
- get-realtime-options: Get real-time options chain data with Greeks and implied volatility
- get-historical-options: Get historical options chain data with advanced filtering and sorting capabilities
- 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
get-stock-quote
**Input Schema:**
**Example Response:**
get-company-info
Retrieves detailed company information for a given symbol.
**Input Schema:**
**Example Response:**
get-crypto-exchange-rate
Retrieves real-time cryptocurrency exchange rates with additional market data.
**Input Schema:**
**Example Response:**
get-time-series
Retrieves daily time series (OHLCV) data with optional date filtering.
**Input Schema:**
**Example Response (Recent Data):**
**Example Response (Date Range Filtering):**