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.
<a href="https://glama.ai/mcp/servers/0wues5td08"><img width="380" height="200" src="https://glama.ai/mcp/servers/0wues5td08/badge" alt="AlphaVantage-MCP MCP server" /></a>
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
- Daily, weekly, and monthly cryptocurrency time series data
- Historical options chain data with advanced filtering and sorting
- Built-in error handling and rate limit management
Installation
Using Claude Desktop
Installing via Docker
- Clone the repository and build a local image to be utilized by your Claude desktop client
- Change your
claude_desktop_config.jsonto match the following, replacingREPLACE_API_KEYwith your actual key:
claude_desktop_config.jsonpath
Installing via Smithery
To install Alpha Vantage MCP Server for Claude Desktop automatically via Smithery:
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 eight tools:
get-stock-quote: Get the latest stock quote for a specific company
get-company-info: Get stock-related information for a specific company
get-crypto-exchange-rate: Get current cryptocurrency exchange rates
get-time-series: Get historical daily price data for a stock
get-historical-options: Get historical options chain data with sorting capabilities
get-crypto-daily: Get daily time series data for a cryptocurrency
get-crypto-weekly: Get weekly time series data for a cryptocurrency
get-crypto-monthly: Get monthly time series data for a cryptocurrency
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:
get-historical-options
Retrieves historical options chain data with advanced sorting and filtering capabilities.
Input Schema:
Example Response:
get-crypto-daily
Retrieves daily time series data for a cryptocurrency.
Input Schema:
Example Response:
get-crypto-weekly
Retrieves weekly time series data for a cryptocurrency.
Input Schema:
Example Response:
get-crypto-monthly
Retrieves monthly time series data for a cryptocurrency.
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
Contributors
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.
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.
<a href="https://glama.ai/mcp/servers/0wues5td08"><img width="380" height="200" src="https://glama.ai/mcp/servers/0wues5td08/badge" alt="AlphaVantage-MCP MCP server" /></a>
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
- Daily, weekly, and monthly cryptocurrency time series data
- Historical options chain data with advanced filtering and sorting
- Built-in error handling and rate limit management
Installation
Using Claude Desktop
Installing via Docker
- Clone the repository and build a local image to be utilized by your Claude desktop client
- Change your
claude_desktop_config.jsonto match the following, replacingREPLACE_API_KEYwith your actual key:
claude_desktop_config.jsonpath
Installing via Smithery
To install Alpha Vantage MCP Server for Claude Desktop automatically via Smithery:
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 eight tools:
get-stock-quote: Get the latest stock quote for a specific company
get-company-info: Get stock-related information for a specific company
get-crypto-exchange-rate: Get current cryptocurrency exchange rates
get-time-series: Get historical daily price data for a stock
get-historical-options: Get historical options chain data with sorting capabilities
get-crypto-daily: Get daily time series data for a cryptocurrency
get-crypto-weekly: Get weekly time series data for a cryptocurrency
get-crypto-monthly: Get monthly time series data for a cryptocurrency
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:
get-historical-options
Retrieves historical options chain data with advanced sorting and filtering capabilities.
Input Schema:
Example Response:
get-crypto-daily
Retrieves daily time series data for a cryptocurrency.
Input Schema:
Example Response:
get-crypto-weekly
Retrieves weekly time series data for a cryptocurrency.
Input Schema:
Example Response:
get-crypto-monthly
Retrieves monthly time series data for a cryptocurrency.
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
Contributors
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.