# Alpha Vantage — how to use (mcp.ai)

Connect your Alpha Vantage account and use 56 tools for analytics straight from your AI agent. Connect with your own API key. Alpha Vantage provides free APIs for real-time and historical financial data, including stock time series, technical indicators, and more.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_alpha_vantage?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `alpha_vantage_all_commodities`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/alpha_vantage`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/alpha_vantage/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/alpha_vantage/all/commodities` — Tool to retrieve the global price index of all commodities. Use when you need monthly, quarterly, or annual aggregated price index data for commodities.
  - body: { datatype?: string, interval: string }
- `POST https://api.mcp.ai/api/alpha_vantage/aluminum` — Tool to fetch global aluminum prices. Use when you need monthly, quarterly, or annual LME aluminum price data.
  - body: { datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/balance/sheet` — Tool to return annual and quarterly balance sheets for a company. Use when you need detailed fiscal statements for analysis. Numeric fields may be returned as strings or empty values; treat empty/miss
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/brent` — Tool to fetch Brent crude oil prices. Use when you need daily, weekly, or monthly Brent price data.
  - body: { datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/cash/flow` — Tool to return annual and quarterly cash flow statements for a company. Use when you need to analyze cash movements.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/coffee` — Tool to retrieve the global coffee price series. Use when you need historical monthly, quarterly, or annual coffee prices.
  - body: { datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/company/overview` — Tool to retrieve company overview and fundamental data for individual company stocks. Note: This endpoint only works for stocks, not ETFs, mutual funds, or indices. Use after specifying a valid stock 
  - body: { apikey?: string, symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/copper` — Tool to fetch global price of copper in monthly, quarterly, and annual intervals. Use when you need historical copper price series for analysis.
  - body: { datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/corn` — Tool to retrieve global price of corn in monthly, quarterly, and annual intervals. Use after verifying API key when you need historical Corn price data.
  - body: { datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/cotton` — Tool to retrieve global cotton prices in monthly, quarterly, and annual intervals. Use when you need historical cotton price data.
  - body: { datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/cpi` — Tool to fetch monthly and semiannual Consumer Price Index (CPI) data of the United States. Use when you need inflation metrics or CPI historical data.
  - body: { apikey?: string, datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/crypto/intraday` — Tool to retrieve intraday time series data for cryptocurrencies with realtime updates. Use when you need high-frequency OHLCV data (open, high, low, close, volume) for a specific cryptocurrency/market
  - body: { apikey?: string, market: string, symbol: string, datatype?: string, interval: string, outputsize?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/currency/exchange/rate` — Tool to retrieve real-time exchange rate for a currency pair. Use after confirming base and quote currency codes to get current rates. Rate is nested at response['Realtime Currency Exchange Rate']['5.
  - body: { apikey?: string, to_currency: string, from_currency: string }
- `POST https://api.mcp.ai/api/alpha_vantage/digital/currency/daily` — Tool to retrieve daily historical time series for a digital currency traded on a specific market. Use when needing daily OHLC and volume data for a crypto/fiat pair, refreshed daily at midnight UTC.
  - body: { apikey?: string, market: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/digital/currency/monthly` — Tool to retrieve monthly digital currency prices in a fiat currency. Use when needing long-term monthly OHLC and volume data for a given crypto/fiat pair. Always returns full history; no date range fi
  - body: { apikey?: string, market: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/digital/currency/weekly` — Tool to retrieve weekly digital currency prices in a fiat currency. Use when needing weekly OHLC and volume data for a given crypto/fiat pair.
  - body: { apikey?: string, market: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/durables` — Tool to fetch monthly manufacturers' new orders of durable goods data for the United States. Use when you need historical data on big-ticket consumer purchases like cars, appliances, and refrigerators
  - body: { apikey?: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/earnings` — Tool to retrieve annual and quarterly earnings (EPS history) for a specific company symbol. Free tier limit: ~25 requests/day, 1 request/second; an 'Information' key or empty array in the response ind
  - body: { apikey?: string, symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/earnings/calendar` — Tool to return the earnings calendar for the next three months. Use when you need a schedule of upcoming earnings across symbols. Returned dates reflect local exchange time, not UTC; normalize to UTC 
  - body: { symbol?: string, horizon?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/earnings/call/transcript` — Tool to retrieve the earnings call transcript for a given company and quarter. Use after confirming symbol and quarter. Returns full transcript text and associated LLM-based sentiment signals. Transcr
  - body: { symbol: string, quarter: string }
- `POST https://api.mcp.ai/api/alpha_vantage/federal/funds/rate` — Tool to fetch daily, weekly, and monthly federal funds rate data of the United States. Use when you need historical interest rate data from the US Federal Reserve for economic analysis.
  - body: { interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/fx/daily` — Tool to fetch daily time series (open, high, low, close) for a currency pair. Use after confirming base and quote currency codes to retrieve historical daily FX rates. Response keys are timestamp stri
  - body: { datatype?: string, to_symbol: string, outputsize?: string, from_symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/fx/intraday` — Tool to retrieve intraday OHLC time series for a forex pair at 1-60 minute intervals (premium endpoint). Use when you need minute-bar FX data for backtesting or monitoring. Note: This is a premium Alp
  - body: { datatype?: string, interval: string, to_symbol: string, outputsize?: string, from_symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/fx/monthly` — Tool to get monthly time series (open, high, low, close) for a currency pair. Use when you need historical monthly forex data for a given currency pair. Data is returned in reverse-chronological order
  - body: { datatype?: string, to_symbol: string, from_symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/fx/weekly` — Tool to get weekly time series (open, high, low, close) for a currency pair. Use when you need weekly FX rates. Results are reverse-chronological; sort ascending and cast OHLC string values to numeric
  - body: { datatype?: string, to_symbol: string, from_symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/get/dividends` — Tool to retrieve historical dividend payment records for a stock symbol. Use when you need dividend dates and amounts for analyzing company distributions.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/get/historical/options` — Tool to retrieve full historical options chain for a symbol on a specific date with 15+ years of history, including Greeks and IV. Use when you need historical options data with pricing, volume, and G
  - body: { date?: string, apikey?: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/get/sliding/window/analytics` — Tool to retrieve advanced analytics metrics with sliding window calculations for trend analysis. Use when you need to perform statistical analysis on stock price movements over time, such as calculati
  - body: { ohlc?: string, RANGE: string, apikey?: string, symbols: string, interval: string, window_size: integer, calculations: string }
- `POST https://api.mcp.ai/api/alpha_vantage/global/quote` — Tool to retrieve latest price and volume information for a specified security ticker in realtime. Use when you need current stock quote data with price, volume, and daily trading metrics.
  - body: { apikey?: string, symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/income/statement` — Tool to fetch annual and quarterly income statements. Use after confirming the company symbol. Numeric fields may be returned as strings or empty values — convert safely and treat empty/missing as nul
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/inflation` — Tool to fetch annual U.S. inflation rates (consumer prices). Use when you need historical inflation data for economic analysis.
  - body: { apikey?: string, datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/ipo/calendar` — Tool to retrieve the IPO calendar for the next three months. Use when you need a list of upcoming IPO events across markets.
- `POST https://api.mcp.ai/api/alpha_vantage/listing/status` — Tool to fetch listing status of US stocks and ETFs. Use when you need active or delisted securities as of a date.
  - body: { date?: string, state?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/market/status` — Tool to retrieve current market status (open/closed) for global stock exchanges. Use when you need to check if major trading venues worldwide are currently open or closed.
  - body: { apikey?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/news/sentiment` — Tool to fetch live and historical market news & sentiment. Use when you need curated news articles with sentiment scores for specified tickers and topics.
  - body: { sort?: string, limit?: integer, topics?: string[], tickers?: string, time_to?: string, time_from?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/nonfarm/payroll` — Tool to fetch monthly U.S. nonfarm payroll employment data from the Bureau of Labor Statistics. Use when you need historical employment statistics for economic analysis.
  - body: { apikey?: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/real/gdp` — Tool to fetch U.S. real GDP time series. Use when you need quarterly or annual GDP data.
  - body: { apikey?: string, datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/real/gdp/per/capita` — Tool to fetch quarterly Real GDP per capita data of the United States. Use when you need real GDP per capita information adjusted for inflation.
  - body: { apikey?: string, datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/realtime/bulk/quotes` — Tool to retrieve realtime quotes for US-traded symbols in bulk (up to 100 symbols per request). Use when you need current price and volume data for multiple symbols simultaneously, covering both regul
  - body: { apikey?: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/retail/sales` — Tool to fetch monthly retail trade sales data of the United States. Use when you need historical U.S. retail sales statistics sourced from Census Bureau.
  - body: { apikey?: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/sector` — Tool to retrieve real-time and historical sector performance data. Use when you need sector performance metrics across timeframes.
  - body: { apikey?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/splits` — Tool to retrieve historical stock split events for a symbol. Use when you need past split dates and ratio details before analyzing corporate actions.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/alpha_vantage/sugar` — Tool to retrieve the global sugar price series. Use when you need historical monthly, quarterly, or annual sugar prices.
  - body: { datatype?: string, interval?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/symbol/search` — Tool to search for best-matching symbols based on keywords. Use when you need to find ticker symbols by a name or keyword. Returns multiple close matches — inspect the exchange, region, and currency f
  - body: { apikey?: string, datatype?: string, keywords: string }
- `POST https://api.mcp.ai/api/alpha_vantage/technical/indicator` — Tool to fetch technical indicators for the specified equity or currency pair. Use after obtaining time series to compute moving averages or oscillators. Response body may contain 'Information' or 'Not
  - body: { month?: string, symbol: string, datatype?: string, function: string, interval: string, series_type: string, time_period: integer }
- `POST https://api.mcp.ai/api/alpha_vantage/time/series/daily` — Tool to retrieve daily time series data (date, daily open, high, low, close, volume) for a global equity symbol, covering 20+ years of historical data. Use when you need daily OHLCV data for a specifi
  - body: { apikey?: string, symbol: string, datatype?: string, outputsize?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/time/series/intraday` — Tool to retrieve intraday OHLCV for a given equity. Use when you need high-frequency pricing data within the trading day. Always inspect the JSON response body for 'Information' or 'Error Message' fie
  - body: { month?: string, symbol: string, adjusted?: string, datatype?: string, interval: string, outputsize?: string, extended_hours?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/time/series/intraday/extended` — Tool to retrieve historical intraday OHLCV data for the trailing 2 years, covering over 2 million data points per ticker. Use when you need extensive historical intraday pricing data for data visualiz
  - body: { slice: string, symbol: string, adjusted?: string, interval: string }
- `POST https://api.mcp.ai/api/alpha_vantage/time/series/monthly` — Tool to retrieve monthly open, high, low, close, and volume for a global equity. Use when you need month-end OHLCV data for a specific stock symbol.
  - body: { apikey?: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/time/series/monthly/adjusted` — Tool to retrieve monthly adjusted OHLC and volume for a global equity. Use after confirming the ticker symbol when you need end-of-month adjusted price and dividend data. Dividends are returned as a s
  - body: { apikey?: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/time/series/weekly` — Tool to fetch weekly open, high, low, close, and volume for a global equity symbol. Use after confirming the target symbol to obtain its historical weekly OHLCV series. Alpha Vantage enforces per-minu
  - body: { apikey?: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/time/series/weekly/adjusted` — Tool to fetch weekly adjusted time series data with split/dividend adjustments, covering 20+ years of historical data. Use after confirming the target symbol to obtain its historical weekly adjusted O
  - body: { apikey?: string, symbol: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/top/gainers/losers` — Tool to fetch the top 20 gainers, losers, and most actively traded US tickers. Use when you need current market movers data without maintaining a ticker universe. Data is updated end-of-day by default
  - body: { apikey?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/treasury/yield` — Tool to fetch US Treasury yield data for specified maturity and interval. Use when you need daily, weekly, or monthly treasury yield rates for various constant maturities (3-month, 2-year, 5-year, 7-y
  - body: { interval?: string, maturity?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/unemployment` — Tool to fetch monthly unemployment rate data of the United States. Use when you need historical U.S. unemployment statistics sourced from Bureau of Labor Statistics.
  - body: { apikey?: string, datatype?: string }
- `POST https://api.mcp.ai/api/alpha_vantage/wheat` — Tool to fetch global price of wheat. Use when you need historical wheat prices in monthly, quarterly, or annual intervals.
  - body: { datatype?: string, interval?: string }

## Example prompts
- "What can I do in Alpha Vantage?"
- "Show me a summary of my Alpha Vantage account"

## More
- Page: https://mcp.ai/alpha_vantage
- Agent spec (llms.txt): https://mcp.ai/alpha_vantage/llms.txt
- Postman collection: https://mcp.ai/alpha_vantage/postman.json