Alpha Vantage MCP

What berlinbra/alpha-vantage-mcp MCP server does

The berlinbra/alpha-vantage-mcp MCP server exposes twelve Alpha Vantage operations through the Model Context Protocol. Its tools cover current stock quotes, company metadata, cryptocurrency rates and time series, historical stock prices, options chains, ETF profiles, and earnings information.

Stock tools return quote fields such as price, change, volume, high, and low. Company information can include the company name, sector, industry, market capitalization, exchange, currency, and description. The crypto tools support exchange-rate lookups plus daily, weekly, and monthly time series.

For broader market research, the server provides real-time and historical options data, ETF profile information with holdings and sector allocation, upcoming earnings calendars, and historical annual or quarterly earnings reports.

How it works

The server translates MCP tool calls into requests to the Alpha Vantage API and formats the returned market data for the client. Most tools use a symbol or currency pair as their main input. The stock time-series tool also accepts compact or full output sizing, optional start and end dates in YYYY-MM-DD form, and a result limit when date filtering is not used.

The crypto exchange-rate tool accepts a cryptocurrency symbol and a market currency, defaulting to USD. Options requests can specify a contract, choose JSON or CSV output, and request Greeks and implied volatility. Historical options requests support filtering and sorting according to the tool schema. The README also describes built-in error handling and rate-limit management.

Setup and configuration

An Alpha Vantage API key must be supplied through the ALPHA_VANTAGE_API_KEY environment variable. For Claude Desktop, the documented Docker approach builds the repository image with docker build -t mcp/alpha-vantage ., then starts it with Docker while passing the environment variable into the container.

The repository also documents a local Python workflow using uv install -e . followed by uv run src/alpha_vantage_mcp/server.py. Claude Desktop configuration can invoke that local server through uv, provided the repository path and API key are set in the configuration. Smithery installation is also documented for Claude Desktop.

Tools and capabilities

• get-stock-quote retrieves the latest quote for a stock symbol.
• get-company-info returns company and market details.
• get-time-series retrieves historical daily OHLCV data with optional date filtering.
• get-crypto-exchange-rate returns a crypto-to-fiat or crypto-to-market-currency rate with bid and ask data.
• get-crypto-daily, get-crypto-weekly, and get-crypto-monthly retrieve crypto time series at different intervals.
• get-realtime-options returns current options-chain data and can include Greeks and implied volatility.
• get-historical-options retrieves historical options chains with filtering and sorting.
• get-etf-profile returns ETF holdings, sector allocation, and related profile data.
• get-earnings-calendar returns upcoming earnings information with configurable time horizons.
• get-historical-earnings returns historical earnings reports.

Limitations and notes

The berlinbra/alpha-vantage-mcp MCP server depends on Alpha Vantage availability, API limits, and the permissions associated with the supplied key. Real-time options data requires an Alpha Vantage Premium subscription with either the 600- or 1,200-requests-per-minute plan. Free accounts and the standard 75-requests-per-minute plan return placeholder or demo data for that endpoint; the README identifies historical options as an alternative available across API key tiers.

The documentation provides client setup instructions for Claude Desktop. It does not establish compatibility with other MCP clients. The server supplies market data; the material does not describe trading, order execution, portfolio management, or investment advice features.