Alpha Vantage MCP Server

This MCP server provides access to financial data from Alpha Vantage. It includes tools to retrieve OHLCV data, dividend data, and ETF holdings.

Tools

get_ticker_ohlcv

Get specific ticker OHLCV data (Open, High, Low, Close, Volume) for a given date.

Input:

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

Example Usage:

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

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

get_ticker_dividend

Get dividend data for a specific ticker.

Input:

{
  "ticker": "AAPL"
}

Example Usage:

To get the dividend data for AAPL:

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

get_etf_holdings

Get the holdings data for a specific ETF.

Input:

{
  "ticker": "SPY"
}

Example Usage:

To get the holdings data for SPY:

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

get_exchange_rate

Get the exchange rate between two currencies (fiat or crypto).

Input:

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

Example Usage:

To get the exchange rate from USD to EUR:

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

get_ticker_options

Get options data for a specific ticker.

Input:

{
  "ticker": "AAPL"
}

Example Usage:

To get the options data for AAPL:

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

Configuration

The server requires an Alpha Vantage API key to be set in the environment variable ALPHAVANTAGE_API_KEY.

To configure the MCP server, add the following to your MCP settings:

{
  "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 Alpha Vantage API key.