What is Alpha Vantage Mcp

alpha_vantage_mcp is an MCP Server that provides access to financial data from Alpha Vantage, including OHLCV data, dividend data, and ETF holdings.

Use cases

Use cases include tracking stock performance, analyzing dividend yields, managing ETF portfolios, and converting currencies for financial transactions.

How to use

To use alpha_vantage_mcp, you need to call specific functions such as get_ticker_ohlcv, get_ticker_dividend, get_etf_holdings, and get_exchange_rate with the appropriate parameters. Ensure to set your Alpha Vantage API key in the environment variable ALPHAVANTAGE_API_KEY.

Key features

Key features include retrieving OHLCV data for specific tickers, obtaining dividend information, accessing ETF holdings, and getting exchange rates between currencies.

Where to use

alpha_vantage_mcp can be used in financial analysis, investment research, trading applications, and any domain that requires access to stock market data and currency exchange rates.

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.