mcpField
A
Alpha_vantage

Alpha_vantage

Local
github.com/septemhillFinance2Updated 72w ago
Repository

About Alpha_vantage

Alpha_vantage is an MCP server for retrieving financial data from Alpha Vantage. It is intended for clients that need ticker, ETF, or currency data and requires an API key.

Key features

  1. 01Retrieve ticker OHLCV data
  2. 02Get dividend data
  3. 03View ETF holdings
  4. 04Fetch currency exchange rates
  5. 05Retrieve options data

Use cases

  1. 01Check a ticker's daily price data
  2. 02Review a ticker's dividends
  3. 03Inspect ETF holdings
  4. 04Look up a currency pair rate

MCP support

It exposes Alpha Vantage financial-data retrieval tools to MCP clients. Configuration requires `ALPHAVANTAGE_API_KEY`.

#alpha-vantage#financial-data#data-retrieval

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "alpha_vantage_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alpha_vantage_finance"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "<ALPHAVANTAGE_API_KEY>"
      }
    }
  }
}
Run commandnpx -y alpha_vantage_finance
Environment variables to set
ALPHAVANTAGE_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmalpha_vantage_finance

Tools

5

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
tickerstringYesThe ticker symbol to get the price for (e.g. AAPL)
infoTypeenumYesThe type of ticker information to get (open, close, high, low, volume)open | close | high | low | volume
datestringYesThe date for which to get the OHLCV data (YYYY-MM-DD)

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.