alphavantage_mcp

alphavantage_mcp

1
finance

Alpha Vantage MCP is a Model Context Protocol server designed to access extensive stock and financial data from Alpha Vantage. It supports a wide range of API endpoints and is organized efficiently to reduce context window usage, making it a powerful tool for financial analysis.

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
  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