Alpha Vantage MCP Server

Finance & FintechPython

Access stock market data through the Alpha Vantage API

Available Tools

get_stock_quote

Retrieves current stock quote information for a specified symbol

get_stock_history

Retrieves historical stock data for a specified symbol and time period

get_technical_indicators

Retrieves technical indicators for a specified stock symbol

get_trending_stocks

Retrieves currently trending stocks in the market

search_stocks

Searches for stocks by keywords or company names

Alpha Vantage MCP Server provides a seamless interface to access comprehensive stock market data through the Alpha Vantage API. This server enables AI assistants to retrieve real-time and historical financial data, including stock quotes, technical indicators, and market trends. With this integration, you can analyze market performance, track specific stocks, and get detailed financial information directly within your AI assistant conversations. The server handles all API communication and data formatting, making financial data instantly accessible for research and decision-making.

Overview

The Alpha Vantage MCP Server allows AI assistants to access stock market data through the Alpha Vantage API. This integration enables you to retrieve financial information, analyze market trends, and track stock performance directly in your conversations.

Prerequisites

Before using the Alpha Vantage MCP Server, you need to:

Sign up for a free Alpha Vantage API key at alphavantage.co/support/#api-key
Clone the repository to your local machine

Installation

Step 1: Clone the repository

git clone https://github.com/calvernaz/alphavantage.git

Step 2: Configure your AI assistant

Add the MCP server configuration to your AI assistant's configuration file. For Claude Desktop, edit your claude_desktop_config.json:

{
  "mcpServers": {
    "alphavantage": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_YOUR_CLONED_PROJECT/alphavantage",
        "run",
        "alphavantage"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Make sure to replace:

PATH_TO_YOUR_CLONED_PROJECT with the actual path where you cloned the repository
YOUR_API_KEY_HERE with your Alpha Vantage API key

Usage

Once configured, you can ask your AI assistant to retrieve financial data using natural language. For example:

"Show me the current price of Apple stock"
"What's the historical performance of Tesla over the past month?"
"Compare the stock prices of Microsoft and Google"
"What are the trending stocks today?"

The MCP server will handle the API requests and return formatted data that your AI assistant can interpret and present to you.

Development

If you want to contribute to the project or modify it for your needs, check out the CONTRIBUTING.md file in the repository for setup instructions and development guidelines.

Limitations

The free Alpha Vantage API key has rate limits (typically 5 API calls per minute and 500 calls per day)
For higher usage limits, you may need to upgrade to a paid Alpha Vantage plan