home / mcp / alpha vantage mcp server

Alpha Vantage MCP Server

MCP Server for Alpha Advantage API

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can access real-time and historical financial data through a dedicated MCP server that wraps the Alpha Vantage API. This server exposes a set of tools to fetch stock quotes, company info, crypto data, options, earnings calendars, ETFs, and time series data, all through the MCP protocol so you can integrate it into your preferred client workflows.

How to use

Connect an MCP client to the Alpha Vantage MCP Server to retrieve data across stock quotes, company info, crypto prices, time series, options, earnings, and ETF profiles. Use the available tools to request specific symbols, time ranges, and data formats. If you are using a Claude Desktop or similar MCP client, ensure your MCP server is running and reachable before you issue requests. Each tool returns structured results you can display in dashboards, alerts, or analytics pipelines.

How to install

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

If you are developing locally with the MCP framework, you can run the server using UVX after installing the package. This flow uses a development path shown for local setup with an explicit API key placeholder.

Additional steps and options

Prerequisites: Ensure you have Python 3.12 or higher and the required MCP tooling installed on your system. The server depends on httpx and mcp as dependencies. If you prefer to run a local instance rather than a container, follow the development path below.

{
  "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>"
      }
    }
  }
}

Running locally with MCP tooling

uv install -e .
uv run src/alpha_vantage_mcp/server.py

How to connect your Claude Desktop client

If you are using Claude Desktop, you can connect to the MCP server by configuring your MCP server entry in the client settings. Use the docker-based or local UV run configuration shown above to point Claude to the running MCP server and supply your Alpha Vantage API key.

Available tools

get-stock-quote

Fetches the latest stock quote for a specified symbol, including price, volume, and daily change.

get-company-info

Retrieves detailed information about a company such as name, sector, industry, market cap, and description.

get-crypto-exchange-rate

Returns real-time cryptocurrency exchange rates with bid/ask data.

get-time-series

Provides daily OHLCV time series for a stock with optional date filtering.

get-realtime-options

Returns real-time options chain data with Greeks and implied volatility (premium access required).

get-historical-options

Retrieves historical options with filtering, sorting, and contract details.

get-etf-profile

Fetches ETF profiles including basic metrics, sector allocation, and top holdings.

get-crypto-daily

Gets daily time series data for a cryptocurrency in a specified market.

get-crypto-weekly

Gets weekly time series data for a cryptocurrency.

get-crypto-monthly

Gets monthly time series data for a cryptocurrency.

get-earnings-calendar

Provides upcoming earnings calendar data with horizon and sorting options.

get-historical-earnings

Returns historical earnings data including annual and quarterly reports.