The official Alpha Vantage API MCP server enables LLMs and agentic workflows to seamlessly interact with real-time and historical stock market data through the Model Context Protocol (MCP). Add this server to your favorite apps such as Claude, Claude Code, Cursor, VS Code, and many more to give them access to comprehensive financial data.

Quickstart

To use the server, get your free Alpha Vantage API key, copy it to your clipboard, then follow the instructions below for the agentic tool/platform of your interest.

👉 Any questions? Please contact [email protected]

⭐ View MCP source code on Github

Connection URL

Connect to the MCP server using:

https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

Setup Instructions by Platform

• Claude (Web & Desktop)
• OpenAI Agents SDK
• ChatGPT
• Visual Studio Code
• Cursor
• Claude Code
• Codex
• Gemini CLI

Claude

To connect Claude (Web or Desktop) to this MCP server:

📺 Watch the setup tutorial - Click the image below to watch a step-by-step video guide:

📺 Already have your Alpha Vantage MCP server set up? Below are a few examples of Claude performing various stock analysis & charting tasks:

Query Param Option (Recommended):

1. Go to claude.ai/settings/connectors (Web) or Settings → Connectors (Desktop)
2. Click "Add Custom Connector"
3. Add the MCP server URL with your API key: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY (replace YOUR_API_KEY with your actual Alpha Vantage API key)
4. Click "Connect"

OAuth Option:

1. Go to claude.ai/settings/connectors (Web) or Settings → Connectors (Desktop)
2. Click "Add Custom Connector"
3. Add the MCP server URL: https://mcp.alphavantage.co/mcp
4. Click "Connect"
5. Enter your Alpha Vantage API token
6. Click "Authorize Access"

OpenAI Agents SDK

To use the Alpha Vantage MCP server with OpenAI Agents SDK, see our example agent that demonstrates:

• Interactive financial analysis agent
• Session management for conversation continuity
• Real-time tool execution with Alpha Vantage data
• Support for both HTTP and stdio MCP connections

The example includes a complete setup guide and configuration templates.

ChatGPT

To connect ChatGPT to this MCP server using ChatGPT Developer mode:

Requirements:

• ChatGPT Pro or Plus account
• Developer mode enabled (beta feature) - see OpenAI's Developer Mode documentation

Setup:

1. Go to ChatGPT Settings → Connectors
2. Enable Advanced → Developer mode
3. Add a remote MCP server with URL: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY (replace YOUR_API_KEY with your actual Alpha Vantage API key)
4. In conversations, choose Developer mode from the Plus menu and select the Alpha Vantage connector

Note: While Developer mode is available for both Pro and Plus accounts, MCP tool execution is currently most reliable with Pro accounts. We're monitoring Plus plan functionality and will update this guide as improvements are made.

Visual Studio Code

To connect VS Code with GitHub Copilot to this MCP server:

1. Create a .vscode/mcp.json file in your workspace
2. Add this configuration (replace YOUR_API_KEY with your actual Alpha Vantage API key):

{
  "servers": {
    "alphavantage": {
      "type": "http",
      "url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

Open the Chat view and select Agent mode

Cursor

Configure Cursor by editing ~/.cursor/mcp.json (replace YOUR_API_KEY with your actual Alpha Vantage API key):

{
  "mcpServers": {
    "alphavantage": {
      "url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

Claude Code

To install and configure (replace YOUR_API_KEY with your actual Alpha Vantage API key):

claude mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

Run claude in your terminal from your project directory

Then connect with:

/mcp

Codex

To connect Codex CLI to this MCP server:

Install mcp-proxy (required because our server supports streamable HTTP only while Codex only supports stdio - mcp-proxy bridges this gap). See installation methods:

uv tool install mcp-proxy

Configure Codex by editing ~/.codex/config.toml (replace YOUR_API_KEY with your actual Alpha Vantage API key):

[mcp_servers.alphavantage]
command = "mcp-proxy"
args = ["--transport", "streamablehttp", "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"]

Run codex in your terminal from your project directory

Then connect with:

/mcp

Gemini CLI

To use Alpha Vantage's MCP server in Gemini CLI:

CLI Command (Recommended):

gemini mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

Manual Configuration:

1. Edit ~/.gemini/settings.json
2. Add this config (replace YOUR_API_KEY with your actual Alpha Vantage API key):

{
  "mcpServers": {
    "alphavantage": {
      "httpUrl": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

Then (for both methods):

Run gemini in your terminal from your project directory

Then connect with:

/mcp

Category Filtering

Optionally filter available tools by category using:

• Query parameter: ?categories=core_stock_apis,alpha_intelligence

Available categories:

• core_stock_apis - Core stock market data APIs
• options_data_apis - Options data APIs
• alpha_intelligence - News sentiment and intelligence APIs
• fundamental_data - Company fundamentals and financial data
• forex - Foreign exchange rates and data
• cryptocurrencies - Digital and crypto currencies data
• commodities - Commodities and precious metals data
• economic_indicators - Economic indicators and market data
• technical_indicators - Technical analysis indicators and calculations
• ping - Health check and utility tools

If no categories are specified, all tools will be available.

Tools Reference

Table of Contents - API Tools

• core_stock_apis
• options_data_apis
• alpha_intelligence
• fundamental_data
• forex
• cryptocurrencies
• commodities
• economic_indicators
• technical_indicators
• ping

💡 Each of these MCP tools maps to a corresponding Alpha Vantage API endpoint. If you are interested in the full API specs (in addition to the brief tool descriptions below), please refer to the Alpha Vantage API documentation.

CORE_STOCK_APIS

OPTIONS_DATA_APIS

ALPHA_INTELLIGENCE

FUNDAMENTAL_DATA

FOREX

CRYPTOCURRENCIES

COMMODITIES

ECONOMIC_INDICATORS

TECHNICAL_INDICATORS

PING