berlinbra/alpha-vantage-mcp

Overview

An MCP server that wraps the Alpha Vantage API, exposing financial data endpoints through the Model Context Protocol. It allows AI agents and MCP-compatible clients to query stock prices, forex rates, and other market data using natural language or structured requests.

Best for

Best for
Developers building AI agents or MCP-based tools that need straightforward access to financial market data

Use cases

• Fetch real-time stock quotes for portfolio monitoring in an AI assistant
• Retrieve historical price data for backtesting trading strategies
• Integrate currency exchange rates into a financial planning chatbot

How to use

Install

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

Tools exposed

• get-stock-quote
• get-company-info
• get-crypto-exchange-rate
• get-time-series
• get-realtime-options
• get-historical-options
• get-etf-profile
• get-crypto-daily
• get-crypto-weekly
• get-crypto-monthly
• get-earnings-calendar
• get-historical-earnings

Tested with

Claude Desktop

Example client config

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

Notes

An MCP server that wraps the Alpha Vantage API, exposing financial data endpoints through the Model Context Protocol. It allows AI agents and MCP-compatible clients to query stock prices, forex rates, and other market data using natural language or structured requests.

97 stars on GitHub. Last updated 2025-10-22. Licensed MIT.

Use cases

• Fetch real-time stock quotes for portfolio monitoring in an AI assistant
• Retrieve historical price data for backtesting trading strategies
• Integrate currency exchange rates into a financial planning chatbot

Pros

• Open source and written in Python, easy to extend or customize
• Leverages the widely used MCP standard for seamless integration with AI tools
• Provides access to a broad range of Alpha Vantage endpoints through a single server

Cons

• Requires a free Alpha Vantage API key, which has rate limits (5 calls per minute)
• Limited to the data available via Alpha Vantage’s free tier; premium data requires paid plans
• No built-in caching or error handling for API outages beyond basic MCP error responses

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.