AlphaVantage-MCP
Alpha Vantage MCP Server
A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
Features
- Real-time stock quotes with price, volume, and change data
- Detailed company information including sector, industry, and market cap
- Real-time cryptocurrency exchange rates with bid/ask prices
- Built-in error handling and rate limit management
Installation
Claude Desktop
- On MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json
- On Windows:
%APPDATA%/Claude/claude_desktop_config.json
Install packages
Running
After connecting Claude client with the MCP tool via json file and installing the packages, Claude should see the server's mcp tools:
You can run the sever yourself via: In alpha-vantage-mcp repo:
with inspector
Available Tools
The server implements four tools:
get-stock-quote
: Get the latest stock quote for a specific companyget-company-info
: Get stock-related information for a specific companyget-crypto-exchange-rate
: Get current cryptocurrency exchange ratesget-time-series
: Get historical daily price data for a stock
get-stock-quote
Input Schema:
Example Response:
get-company-info
Retrieves detailed company information for a given symbol.
Input Schema:
Example Response:
get-crypto-exchange-rate
Retrieves real-time cryptocurrency exchange rates with additional market data.
Input Schema:
Example Response:
get-time-series
Retrieves daily time series (OHLCV) data.
Input Schema:
Example Response:
Error Handling
The server includes comprehensive error handling for various scenarios:
- Rate limit exceeded
- Invalid API key
- Network connectivity issues
- Timeout handling
- Malformed responses
Error messages are returned in a clear, human-readable format.
Prerequisites
- Python 3.12 or higher
- httpx
- mcp
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
You must be authenticated.
A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.