AlphaVantage

What is AlphaVantage MCP Server?

The AlphaVantage MCP Server provides a bridge to the AlphaVantage API, allowing users to access a wide range of financial market data through natural language queries in compatible clients. It supports fetching stock prices, fundamental data, and more.

Key Features

• Extensive Data Access: Connect to over 100 APIs for financial data.
• Multiple Server Modes: Can be run as a standard stdio server or a streamable HTTP server for real-time updates.
• Easy Configuration: Requires a free API key from AlphaVantage and can be configured with environment variables.

How to use AlphaVantage MCP Server?

To get started, you need to obtain a free API key from the AlphaVantage website. After cloning the repository, you can run the server in either stdio or HTTP mode. For desktop clients like Claude, you need to add the server configuration to the claude_desktop_config.json file, including your API key.

Use Cases

1. Market Research: Quickly retrieve stock prices and other market data for analysis.
2. Financial Application Development: Integrate financial data into custom applications and tools.
3. Automated Data Retrieval: Set up scripts to fetch financial data periodically.

FAQ

• **Is the AlphaVantage API free? **> Yes, you can get a free API key from their website, which is sufficient for many use cases.
• **What kind of data can I get? **> You can access a wide variety of data, including stock prices, fundamentals, economic indicators, and more.

✅ 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.