Alpha Vantage MCP Server

Name: Alpha Vantage MCP Server
Author: berlinbra

@berlinbra

Repository

About Alpha Vantage MCP Server

MCP Server for Alpha Advantage API

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "alpha-vantage-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp/alpha-vantage",
        "."
      ]
    }
  }
}

Tools

Get the latest stock quote for a specific company

Get stock-related information for a specific company

Get current cryptocurrency exchange rates

Get historical daily price data for a stock

Get real-time options chain data with Greeks and implied volatility

Get historical options chain data with advanced filtering and sorting capabilities

Get comprehensive ETF profile information including holdings and sector allocation

Get daily time series data for a cryptocurrency

Get weekly time series data for a cryptocurrency

Get monthly time series data for a cryptocurrency

Get upcoming earnings calendar data for companies

Get historical earnings data for a specific company

Overview

What is Alpha Vantage MCP Server?

Alpha Vantage MCP Server is a Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. It is designed for AI assistants and developers who need stock quotes, company information, cryptocurrency exchange rates, options chains, ETF profiles, and earnings data.

How to use Alpha Vantage MCP Server?

Install via Docker or Smithery, configure your Claude Desktop client with the ALPHA_VANTAGE_API_KEY environment variable in claude_desktop_config.json, or run with uv. The server exposes twelve tools including get-stock-quote, get-company-info, and get-crypto-exchange-rate.

Key features of Alpha Vantage MCP Server

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
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 and sector allocation
Upcoming earnings calendar with customizable time horizons
Built-in error handling and rate limit management

Use cases of Alpha Vantage MCP Server

Build a stock monitoring assistant that fetches latest quotes and company fundamentals
Analyze cryptocurrency price trends across daily, weekly, and monthly periods
Research options strategies by filtering and sorting historical contracts
Retrieve ETF profiles for portfolio analysis and holdings breakdown
Access upcoming earnings announcements for fundamental research

FAQ from Alpha Vantage MCP Server

What API key is required?

An Alpha Vantage API key is required; set it as the ALPHA_VANTAGE_API_KEY environment variable. A free API key is available from the Alpha Vantage website.

Does real-time options data require a premium plan?

Yes, the get-realtime-options tool requires an Alpha Vantage Premium subscription (600 or 1200 requests/minute). Free and 75 requests/minute plans receive placeholder data instead of real market data.

What are the runtime requirements?

The server runs on Python using uv. Docker is also supported for containerized deployment.

Where does the financial data come from?

All data is sourced from the free Alpha Vantage API, which provides stock quotes, company information, cryptocurrency rates, options chains, ETF profiles, and earnings data.