What is Alphavantage

The Alpha Vantage MCP Server is an application that allows users to fetch and interact with stock market data using the Alpha Vantage API. It provides a convenient interface for accessing various financial data, such as historical stock prices, company information, and market technical indicators.

Use cases

Users can utilize the Alpha Vantage MCP Server for multiple purposes, including tracking stock performance, analyzing market trends, developing trading algorithms, and building financial dashboards. It’s ideal for traders, investors, and developers seeking to integrate real-time stock market data into their applications.

How to use

To utilize the server, sign up for a free Alpha Vantage API key and add it to your environment variables. Clone the project from GitHub, and configure it in your Claude Desktop by specifying the command parameters and providing the API key. This setup enables seamless access to the Alpha Vantage services.

Key features

Key features of the Alpha Vantage MCP Server include real-time stock data retrieval, historical data access, support for various financial indicators, and ease of integration with applications. The server is designed for performance and accessibility, making it user-friendly for both novice and experienced developers.

Where to use

The server can be used in various environments, including personal and enterprise applications where real-time stock market data is needed. It is suited for use in financial analysis tools, trading platforms, research applications, and educational projects for learning about stock markets.

✅ Official Alpha Vantage MCP Server

A MCP server for the stock market data API, Alphavantage API.

Configuration

Getting an API Key

1. Sign up for a Free Alphavantage API key
2. Add the API key to your environment variables as ALPHAVANTAGE_API_KEY

Clone the project

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

Server Modes

The AlphaVantage server can run in two different modes:

Stdio Server (Default)

This is the standard MCP server mode used for tools like Claude Desktop.

alphavantage
# or explicitly:
alphavantage --server stdio

Streamable HTTP Server

This mode provides real-time updates via HTTP streaming.

alphavantage --server http --port 8080

Options:

• --server: Choose between stdio (default) or http server mode
• --port: Specify the port for the Streamable HTTP server (default: 8080)

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NOTE Make sure you replace the <DIRECTORY-OF-CLONED-PROJECT> with the directory of the cloned project.

{
  "mcpServers": {
    "alphavantage": {
      "command": "uv",
      "args": [
        "--directory",
        "<DIRECTORY-OF-CLONED-PROJECT>/alphavantage",
        "run",
        "alphavantage"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Running the Server in Streamable HTTP Mode

{
  "mcpServers": {
    "alphavantage": {
      "command": "uv",
      "args": [
        "--directory",
        "<DIRECTORY-OF-CLONED-PROJECT>/alphavantage",
        "run",
        "alphavantage",
        "--server",
        "http",
        "--port",
        "8080"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

📺 Demo Video

Watch a quick demonstration of the Alpha Vantage MCP Server in action:

🤝 Contributing

We welcome contributions from the community! To get started, check out our contribution guide for setup instructions,
development tips, and guidelines.