Alpha Vantage MCP
A Model Context Protocol (MCP) server for accessing Alpha Vantage stock and financial data.
what is Alpha Vantage MCP?
Alpha Vantage MCP is a Model Context Protocol (MCP) server designed for accessing stock and financial data from Alpha Vantage.
how to use Alpha Vantage MCP?
To use Alpha Vantage MCP, clone the repository, install dependencies, set up your environment with an Alpha Vantage API key, and connect it to an MCP-compatible client like Claude to make queries.
key features of Alpha Vantage MCP?
- Complete support for all Alpha Vantage API endpoints including stocks, economic indicators, technical indicators, forex, cryptocurrencies, and commodities.
- Efficient organization of API endpoints to reduce context window usage.
use cases of Alpha Vantage MCP?
- Retrieving stock quotes for various companies.
- Accessing technical indicators for stock analysis.
- Fetching forex exchange rates.
- Obtaining historical price data for cryptocurrencies.
FAQ from Alpha Vantage MCP?
- What is the purpose of Alpha Vantage MCP?
It serves as a server to access various financial data from Alpha Vantage efficiently.
- How do I get an API key?
You can obtain a free API key by signing up at Alpha Vantage's website.
- Is there a limit on API usage?
Yes, Alpha Vantage has usage limits based on the type of API key you have.
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
- 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
