Alpha Vantage MCP Server

Overview

Alpha Vantage MCP Server provides access to financial market data through the Alpha Vantage API. This server allows you to retrieve stock quotes, company information, cryptocurrency exchange rates, and historical price data.

Prerequisites

Before using this MCP server, you'll need:

1. An Alpha Vantage API key (available for free at alphavantage.co)
2. Docker installed (for Docker installation method)
3. Claude Desktop or another compatible MCP client

Installation Options

Option 1: Using Docker (Recommended)

1. Clone the repository:

   git clone https://github.com/berlinbra/alpha-vantage-mcp.git
   cd alpha-vantage-mcp
   

2. Build the Docker image:

   docker build -t mcp/alpha-vantage .
   

3. Update your Claude Desktop configuration file (claude_desktop_config.json):

   • On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%/Claude/claude_desktop_config.json

   Add the following configuration, replacing REPLACE_API_KEY with your actual Alpha Vantage API key:

   {
     "mcpServers": {
       "alphavantage": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "-e",
           "ALPHA_VANTAGE_API_KEY",
           "mcp/alpha-vantage"
         ],
         "env": {
           "ALPHA_VANTAGE_API_KEY": "REPLACE_API_KEY"
         }
       }
     }
   }
   

Option 2: Using Smithery

For automatic installation via Smithery:

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

Option 3: Development Setup

1. Clone the repository:

   git clone https://github.com/berlinbra/alpha-vantage-mcp.git
   cd alpha-vantage-mcp
   

2. Install packages:

   uv install -e .
   

3. Update your Claude Desktop configuration file:

   {
     "mcpServers": {
       "alpha-vantage-mcp": {
         "args": [
           "--directory",
           "/path/to/alpha-vantage-mcp",
           "run",
           "alpha-vantage-mcp"
         ],
         "command": "uv",
         "env": {
           "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }
   

4. Run the server manually (optional):

   uv run src/alpha_vantage_mcp/server.py
   

Usage

Once installed, you can use the Alpha Vantage MCP server in Claude Desktop or other compatible clients. The server provides several tools for accessing financial data:

• Use get-stock-quote to retrieve current stock prices and trading information
• Use get-company-info to get detailed information about companies
• Use get-crypto-exchange-rate to check cryptocurrency exchange rates
• Use get-time-series to retrieve historical stock price data
• Use get-historical-options to access options chain data
• Use get-crypto-daily, get-crypto-weekly, and get-crypto-monthly to retrieve cryptocurrency time series data

Rate Limits

The free Alpha Vantage API has rate limits (typically 5 API calls per minute and 500 calls per day). The server includes built-in error handling for rate limit issues, but be mindful of these limitations when making requests.

Troubleshooting

If you encounter issues:

1. Verify your API key is correct
2. Check that your configuration file is properly formatted
3. Ensure Docker is running (if using the Docker installation method)
4. Check the Alpha Vantage API status at alphavantage.co

For more detailed information, visit the GitHub repository.