mcp-registry/alpha-vantage-mcp

    ==================
      
       /// MCP ///
      /// ALP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

alpha-vantage-mcp

by berlinbra

MCP server exposing Alpha Vantage real-time & historical market data (stocks, crypto, options) via a standardized Model Context Protocol interface.

60
27
Open Source
GitHub

01

get-stock-quote

Get the latest stock quote for a specific company

02

get-company-info

Get stock-related information for a specific company

03

get-crypto-exchange-rate

Get current cryptocurrency exchange rates

04

get-time-series

Get historical daily price data for a stock

05

get-historical-options

Get historical options chain data with advanced sorting and filtering capabilities

06

get-crypto-daily

Get daily time series data for a cryptocurrency

07

get-crypto-weekly

Get weekly time series data for a cryptocurrency

08

get-crypto-monthly

Get monthly time series data for a cryptocurrency

Installation

1. Prerequisites
• Python 3.8 or newer
• A valid Alpha-Vantage API key (free keys available at https://www.alphavantage.co/support/#api-key)
2. Clone the repository
git clone https://github.com/berlinbra/alpha-vantage-mcp.git cd alpha-vantage-mcp
3. Create/activate a virtual environment (recommended)
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
4. Install Python dependencies
pip install -r requirements.txt
5. Configure the server
# The server expects your Alpha-Vantage key in an environment variable export ALPHA_VANTAGE_API_KEY="<YOUR_KEY>" # Windows: set ALPHA_VANTAGE_API_KEY=<YOUR_KEY> # Optional common settings (if available in config.yml or .env) # MCP_PORT – TCP port to bind (default 8080) # MCP_HOST – Bind address (default 0.0.0.0)
6. Run the MCP server
python -m alpha_vantage_mcp # or: python server.py / uvicorn app:app --reload (check repo entrypoint)
7. Verify
curl http://localhost:8080/healthz # should return a health OK JSON response.
8. Containerised deployment (optional)
docker build -t alpha-vantage-mcp . docker run -e ALPHA_VANTAGE_API_KEY=<YOUR_KEY> -p 8080:8080 alpha-vantage-mcp

Documentation

License: MIT License
Updated 7/30/2025
alpha-vantage-mcp - MCP Server Registry - Augment Code