Alpha Vantage MCP Server

Overview

The official Alpha Vantage MCP server exposes Alpha Vantage market data functions directly as MCP tools. MCP clients discover the tools with tools/list and call them with tools/call.

Hosted Remote Connection

Recommended remote endpoint: https://mcp.alphavantage.co/mcp. The hosted server supports OAuth; users authorize by entering an Alpha Vantage API key on the consent page. The protected resource metadata is available at https://mcp.alphavantage.co/.well-known/oauth-protected-resource/mcp, and the authorization server metadata advertises authorization, token, and dynamic registration endpoints on https://mcp.alphavantage.co. Legacy API-key-in-URL usage is documented as deprecated: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY.

Local Stdio Connection

Install uv, then run the local package with uvx marketdata-mcp-server YOUR_API_KEY, uvx marketdata-mcp-server --api-key YOUR_API_KEY, or set ALPHA_VANTAGE_API_KEY and run uvx marketdata-mcp-server. The PyPI package is marketdata-mcp-server version 0.3.1 and requires Python >=3.13.

Configuration

For local stdio usage, provide an Alpha Vantage API key as a positional argument, via --api-key, or via ALPHA_VANTAGE_API_KEY. Use --verbose or -v to enable verbose logging.

Deployment/runtime configuration observed in the official source includes MAX_RESPONSE_TOKENS for large response preview limits, CDN/S3 settings for large response upload URLs, OAuth signing/encryption keys for hosted OAuth, and DOMAIN_NAME for OAuth metadata URLs.

Capabilities

The server exposes Alpha Vantage data tools across these categories: core stock APIs, options data, Alpha Intelligence/news and sentiment, fundamental data, forex, cryptocurrencies, commodities, economic indicators, technical indicators, plus health/example tools such as PING and ADD_TWO_NUMBERS. Examples documented by Alpha Vantage include fetching OHLCV data, computing RSI, visualizing earnings surprise trends, and comparing asset-class performance.

Limitations

An Alpha Vantage API key is required. Hosted legacy API-key-in-URL authentication is deprecated in favor of OAuth. The Lambda-hosted remote endpoint rejects unauthenticated requests and does not support GET/SSE streaming; use POST streamable HTTP. Large responses may be previewed when they exceed MAX_RESPONSE_TOKENS; tools support return_full_data=true when the client can handle full results or file offload. Alpha Vantage rate limits and invalid API keys are surfaced as structured errors. Some client-specific setup paths require paid tiers or beta/developer features, such as Claude Pro, ChatGPT Plus developer mode, SuperGrok, OpenAI Agent Builder access, Azure AI Foundry access, or Codex CLI v0.34+ depending on the integration.