This MCP server provides access to financial data from Alpha Vantage. It includes tools to retrieve OHLCV data, dividend data, and ETF holdings.
npm install alpha_vantage_financeThis MCP server provides access to financial data from Alpha Vantage. It includes tools to retrieve OHLCV data, dividend data, and ETF holdings.
Get specific ticker OHLCV data (Open, High, Low, Close, Volume) for a given date.
Input:
``json`
{
"ticker": "AAPL",
"infoType": "close",
"date": "2024-01-02"
}
Example Usage:
To get the closing price of AAPL on January 2, 2024:
`bash`
mcp call alpha_vantage get_ticker_ohlcv '{"ticker": "AAPL", "infoType": "close", "date": "2024-01-02"}'
Get dividend data for a specific ticker.
Input:
`json`
{
"ticker": "AAPL"
}
Example Usage:
To get the dividend data for AAPL:
`bash`
mcp call alpha_vantage get_ticker_dividend '{"ticker": "AAPL"}'
Get the holdings data for a specific ETF.
Input:
`json`
{
"ticker": "SPY"
}
Example Usage:
To get the holdings data for SPY:
`bash`
mcp call alpha_vantage get_etf_holdings '{"ticker": "SPY"}'
Get the exchange rate between two currencies (fiat or crypto).
Input:
`json`
{
"fromCurrency": "USD",
"toCurrency": "EUR"
}
Example Usage:
To get the exchange rate from USD to EUR:
`bash`
mcp call alpha_vantage get_exchange_rate '{"fromCurrency": "USD", "toCurrency": "EUR"}'
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:
`json`
{
"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.