Alpha Vantage MCP Server

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

cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .

• 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

{
  "mcpServers": {
    "alphavantage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPHA_VANTAGE_API_KEY",
        "mcp/alpha-vantage"
      ],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "REPLACE_API_KEY"
      }
    }
  }
}

Installing via Smithery

To install Alpha Vantage MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

{
 "mcpServers": {
  "alpha-vantage-mcp": {
   "args": [
    "--directory",
    "/Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp",
    "run",
    "alpha-vantage-mcp"
   ],
   "command": "uv",
   "env": {
    "ALPHA_VANTAGE_API_KEY": "<insert api key>"
   }
  }
 }
}

Install packages

uv install -e .

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:

uv run src/alpha_vantage_mcp/server.py

with inspector

* npx @modelcontextprotocol/inspector uv --directory /Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp run src/alpha_vantage_mcp/server.py `

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

... View full README on GitHub