About Alpha Vantage MCP
Alpha Vantage MCP exposes Alpha Vantage financial data through an MCP server. It covers market and economic data, while grouping related endpoints into fewer tools to reduce context usage.
Key features
- 01Stock and economic data
- 02Technical indicators
- 03Forex and cryptocurrency data
- 04Commodity data
- 05Grouped endpoints reduce tool count
Use cases
- 01Retrieve a stock quote or price series
- 02Check a technical indicator
- 03Look up currency exchange rates
- 04Access cryptocurrency or commodity prices
MCP support
The server exposes Alpha Vantage API endpoints as tools for MCP-compatible clients. It requires an Alpha Vantage API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEAlpha 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
- Clone this repository
- Install dependencies:
npm install - Copy the example environment file:
cp .env.example .env - Edit the
.envfile and add your Alpha Vantage API key- Get a free API key at Alpha Vantage
- 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.