Alpha Vantage MCP

A Model Context Protocol (MCP) server for accessing Alpha Vantage stock and financial data.

Features

• Complete support for all Alpha Vantage API endpoints including stocks, economic indicators, technical indicators, forex, cryptocurrencies, and commodities

• For reduced context window usage, certain endpoints are organized under same tool (technical indicators, forex, commodities, and cryptocurrencies)

API Organization

To provide a more efficient experience and reduce context window usage:

• Technical Indicators: Consolidated into 5 unified endpoints (moving averages, momentum, volatility, volume, cycle) with type parameters

• Commodities: Unified into a single endpoint with commodity_type parameter

• Forex: Time series endpoints consolidated with a series_type parameter

• Cryptocurrencies: Time series endpoints consolidated with a series_type parameter

This organization maintains full functionality while significantly reducing the number of tools required.

Setup

1. Clone this repository

2. Install dependencies: npm install

3. Copy the example environment file: cp .env.example .env

4. Edit the .env file and add your Alpha Vantage API key

   • Get a free API key at Alpha Vantage

5. Build the project: npm run build

Usage

Connect to a Claude client

This MCP server can be used with any MCP-compatible client, such as Claude.

Example queries:

• "Get a stock quote for MSFT"

• "Show me the RSI momentum indicator for AAPL with a 14-day period"

• "What's the exchange rate between USD and EUR?"

• "Get the monthly price data for Bitcoin in USD"

• "Show me crude oil prices for the last quarter"

License

MIT