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