Alpha Vantage MCP Server

📋 Overview:

This webpage is a GitHub repository for a Model Context Protocol (MCP) server named "alpha-vantage-mcp" developed by berlinbra, designed to provide access to financial market data via the Alpha Vantage API. It is intended for use with the Claude Desktop application. The repository contains code, installation instructions, tool descriptions, and licensing information.

⭐ Key Points:

• The server provides real-time financial data via the Alpha Vantage API.


• It is designed to integrate with Claude Desktop, an application that supports MCP servers.


• The repository includes instructions for manual installation and automatic installation via Smithery.


• The server offers tools to retrieve stock quotes, company information, cryptocurrency exchange rates, time series data, and historical options chain data.


• The project is licensed under the MIT License, offering broad permissions for use, modification, and distribution.


🔍 Main Findings:

• The primary purpose is to enable access to financial market data within the Claude Desktop environment.


• The server implements five specific tools for retrieving various types of financial data.


• Installation requires setting up an API key from Alpha Vantage and configuring Claude Desktop to recognize the server.


• The project uses Python 3.12 or higher and depends on httpx and mcp libraries.


• Error handling is included to manage rate limits, API key issues, and network problems.


📊 Details:

• Tools Implemented:


• `get-stock-quote`: Retrieves the latest stock quote for a specified company, including price, change, volume, high, and low.


• Input Schema: {symbol: {type: string, description: Stock symbol (e.g., AAPL, MSFT)}}


• `get-company-info`: Retrieves stock-related information for a specified company, including name, sector, industry, market cap, description, exchange, and currency.


• Input Schema: {symbol: {type: string, description: Stock symbol (e.g., AAPL, MSFT)}}


• `get-crypto-exchange-rate`: Retrieves real-time cryptocurrency exchange rates with bid/ask prices.


• Input Schema: {crypto_symbol: {type: string, description: Cryptocurrency symbol (e.g., BTC, ETH)}, market: {type: string, description: Market currency (e.g., USD, EUR), default: USD}}


• `get-time-series`: Retrieves historical daily price data for a stock.


• Input Schema: {symbol: {type: string, description: Stock symbol (e.g., AAPL, MSFT)}, outputsize: {type: string, description: compact or full, default: compact}}


• `get-historical-options`: Retrieves historical options chain data with sorting capabilities.


• Input Schema: {symbol: {type: string, description: Stock symbol (e.g., AAPL, MSFT)}, date: {type: string, description: Trading date (YYYY-MM-DD)}, limit: {type: integer, description: Number of contracts}, sortby: {type: string, description: Field to sort by}, sortorder: {type: string, description: Sort order (asc, desc)}}


• Installation:


• Via Smithery: `npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude`


• Manual: Requires configuring Claude Desktop to recognize the MCP server by editing a JSON file (location varies by OS). Also requires installing necessary packages.


• Dependencies:


• Python 3.12+


• httpx


• mcp

🎯 Conclusion:
The "alpha-vantage-mcp" repository provides an MCP server for accessing Alpha Vantage API data within Claude Desktop. It offers a range of tools for retrieving financial data, with instructions for installation and configuration. The project is open-source under the MIT license, encouraging community contributions.