Alpha Vantage

🚀 Alpha Vantage Data Service MCP Server

This MCP server provides access to Alpha Vantage financial data. It includes tools for retrieving OHLCV data (Open, High, Low, Close, and Volume), dividend data, and ETF holdings information.

🚀 Quick Start

✨ Features

• Retrieve OHLCV data for specific stocks.
• Get dividend data for specific stocks.
• Obtain holdings information for specific ETFs.
• Fetch exchange rate data between two currencies.

📦 Installation

The server requires setting the Alpha Vantage API key in the environment variable ALPHAVANTAGE_API_KEY.

To configure this server in MCP settings, add the following content:

{
  "mcpServers": {
    "github.com/septemhill/alpha_vantage_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alpha_vantage_finance"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your own Alpha Vantage API key.

💻 Usage Examples

Basic Usage

Get OHLCV Data for a Specific Stock

Retrieve the OHLCV data (Open, High, Low, Close, Volume) of a specified stock on a specific date.

Input Format:

{
  "ticker": "AAPL",
  "infoType": "close",
  "date": "2024-01-02"
}

Example Usage: To get the closing price of AAPL stock on January 2, 2024:

mcp call alpha_vantage get_ticker_ohlcv '{"ticker": "AAPL", "infoType": "close", "date": "2024-01-02"}'

Get Dividend Data for a Specific Stock

Retrieve the dividend information of a specified stock.

Input Format:

{
  "ticker": "AAPL"
}

Example Usage: To get the dividend data of AAPL:

mcp call alpha_vantage get_ticker_dividend '{"ticker": "AAPL"}'

Get Holdings Information for a Specific ETF

Retrieve the holdings data of a specified ETF.

Input Format:

{
  "ticker": "SPY"
}

Example Usage: To get the holdings information of the SPY ETF:

mcp call alpha_vantage get_etf_holdings '{"ticker": "SPY"}'

Get Exchange Rate Data

Retrieve the exchange rate between two currencies (including fiat and cryptocurrencies).

Input Format:

{
  "fromCurrency": "USD",
  "toCurrency": "EUR"
}

Example Usage: To get the exchange rate from US dollars to euros:

mcp call alpha_vantage get_exchange_rate '{"fromCurrency": "USD", "toCurrency": "EUR"}'