Alphavantage Stock Mcp
@xweety
A TypeScript/Node.js implementation of the Model Context Protocol (MCP) server for accessing historical stock market data through the Alpha Vantage API. This server enables LLMs and agentic workflows to seamlessly interact with financial data.
Overview
What is Alphavantage Stock Mcp?
A TypeScript/Node.js implementation of the Model Context Protocol (MCP) server for accessing historical stock market data through the Alpha Vantage API. It enables LLMs and agentic workflows to seamlessly interact with financial data.
How to use Alphavantage Stock Mcp?
Configure the MCP client with a JSON entry using command npx alphavantage-stock-mcp and set the ALPHAVANTAGE_API_KEY environment variable. Then invoke the available tools (e.g., get-stock-data, get-daily-stock-data, get-stock-alerts) with parameters like symbol and interval.
Key features of Alphavantage Stock Mcp
- Provides daily stock data with configurable output sizes
- Offers intraday stock data with multiple time intervals
- Generates price movement alerts based on percentage thresholds
- Full TypeScript support with type definitions
- Compatible with MCP-enabled applications (Claude Desktop, VS Code, etc.)
Use cases of Alphavantage Stock Mcp
- Retrieve daily closing prices for a stock over the last 20 years
- Monitor intraday price movements at 5-minute intervals
- Set up automatic alerts when a stock moves beyond a certain threshold
- Integrate real-time financial data into LLM-based analysis tools
FAQ from Alphavantage Stock Mcp
What API key is required?
An Alpha Vantage API key is required; a free tier is available by signing up at Alpha Vantage.
What intraday intervals are supported?
Supported intervals: 1min, 5min, 15min, 30min, and 60min (default is 5min).
What output sizes are available for stock data?
Two output sizes: "compact" returns the latest 100 data points, and "full" returns up to 20 years of data.
How do I configure the server for my MCP client?
Add a JSON configuration with command: "npx", args: ["alphavantage-stock-mcp"], and an env object setting ALPHAVANTAGE_API_KEY to your key.
What transport does this server use?
The README does not specify a transport; it uses the standard MCP protocol via a command-line invocation (stdio-based by convention).
