Alpha_vantage

by septemhill

387 downloads
Not rated
GitHub

Description

# 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…

About

# 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:** ```json { "ticker"…

Details

Author
septemhill
Downloads
387
Categories
Other

- Retrieve OHLCV data for a specific ticker and date.
- Fetch dividend data for any ticker.
- Obtain ETF holdings data.
- Simple JSON input for all tools.
- Configured via environment variable for the API key.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Alpha_vantage
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The server requires an Alpha Vantage API key set in the environment variable ALPHAVANTAGE_API_KEY. To configure it, add a new entry to your MCP settings with the command npx -y alpha_vantage_finance and the API key in the environment. Once running, you can call any of its three tools: get_ticker_ohlcv, get_ticker_dividend, or get_etf_holdings.

get_ticker_ohlcv

Get specific ticker OHLCV data (Open, High, Low, Close, Volume)

get_ticker_dividend

Get dividend data for a specific ticker

get_etf_holdings

Get the holdings data for a specific ETF

get_exchange_rate

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

get_ticker_options

Get options data for a specific ticker

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "alpha_vantage": {
            "alpha_vantage": {
                "command": "npx",
                "args": [
                    "-y",
                    "alpha_vantage_finance"
                ],
                "env": {
                    "ALPHAVANTAGE_API_KEY": "YOUR_ALPHA_VANTAGE_API_KEY"
                },
                "disabled": false,
                "autoApprove": [
                    "get_ticker_ohlcv"
                ]
            }
        }
    }
}

McpServers

{
    "alpha_vantage": {
        "command": "npx",
        "args": [
            "-y",
            "alpha_vantage_finance"
        ],
        "env": {
            "ALPHAVANTAGE_API_KEY": "YOUR_ALPHA_VANTAGE_API_KEY"
        },
        "disabled": false,
        "autoApprove": [
            "get_ticker_ohlcv"
        ]
    }
}

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"}'

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.