Alpha Vantage MCP server
Alpha Vantage's official MCP server gives agents real-time and historical stock, forex, crypto, and economic data.
Alpha Vantage MCP is the official server for the Alpha Vantage market-data API, giving an AI agent a wide financial dataset as tools. It covers equities (intraday through monthly time series, adjusted prices, global quotes, bulk quotes, symbol search, and market status), options chains, forex and digital-currency rates, fundamentals (company overview, income statement, balance sheet, cash flow, earnings, and calendars), commodities, macroeconomic indicators like GDP, CPI, and Treasury yields, and a very large library of technical indicators (SMA, EMA, MACD, RSI, BBANDS, and dozens more). Each tool maps directly to an Alpha Vantage API endpoint.
The canonical setup is the remote endpoint at https://mcp.alphavantage.co/mcp, where you pass your free Alpha Vantage API key as an apikey query parameter on the URL. It also runs locally over stdio via uvx using the marketdata-mcp-server package, taking the API key as an argument. A free key is enough to get started; the same key governs your rate limits and premium-endpoint access.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"alphavantage": {
"type": "http",
"url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
}
}
}claude mcp add --transport http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEYAvailable tools
| Tool | Description |
|---|---|
| TIME_SERIES_INTRADAY | Returns intraday OHLCV time series for an equity at a chosen interval. |
| TIME_SERIES_DAILY | Returns daily OHLCV time series for an equity. |
| TIME_SERIES_DAILY_ADJUSTED | Returns daily adjusted OHLCV time series with dividends and splits. |
| TIME_SERIES_WEEKLY | Returns weekly OHLCV time series for an equity. |
| TIME_SERIES_WEEKLY_ADJUSTED | Returns weekly adjusted OHLCV time series. |
| TIME_SERIES_MONTHLY | Returns monthly OHLCV time series for an equity. |
| TIME_SERIES_MONTHLY_ADJUSTED | Returns monthly adjusted OHLCV time series. |
| GLOBAL_QUOTE | Returns the latest price and volume quote for a ticker. |
| REALTIME_BULK_QUOTES | Returns real-time quotes for up to 100 symbols at once. |
| SYMBOL_SEARCH | Searches for symbols and companies matching keywords. |
| MARKET_STATUS | Returns the open or closed status of major global markets. |
| REALTIME_OPTIONS | Returns the real-time US options chain for a ticker. |
| REALTIME_OPTIONS_FMV | Returns real-time options data with fair-value estimates. |
| HISTORICAL_OPTIONS | Returns historical options chain data for a ticker and date. |
| NEWS_SENTIMENT | Returns market news and sentiment scores filtered by tickers and topics. |
| EARNINGS_CALL_TRANSCRIPT | Returns the transcript of a company's earnings call. |
| TOP_GAINERS_LOSERS | Returns the day's top gaining, losing, and most-active US tickers. |
| INSIDER_TRANSACTIONS | Returns insider trading transactions for a company. |
| INSTITUTIONAL_HOLDINGS | Returns institutional ownership holdings for a company. |
| ANALYTICS_FIXED_WINDOW | Computes analytics metrics over a fixed time window for one or more symbols. |
| ANALYTICS_SLIDING_WINDOW | Computes analytics metrics over a sliding time window for one or more symbols. |
| COMPANY_OVERVIEW | Returns a company overview with key fundamentals and ratios. |
| INCOME_STATEMENT | Returns annual and quarterly income statements for a company. |
| BALANCE_SHEET | Returns annual and quarterly balance sheets for a company. |
| CASH_FLOW | Returns annual and quarterly cash-flow statements for a company. |
| EARNINGS | Returns annual and quarterly earnings (EPS) for a company. |
| LISTING_STATUS | Returns active or delisted listing status for stocks and ETFs. |
| EARNINGS_CALENDAR | Returns expected earnings report dates for the coming months. |
| IPO_CALENDAR | Returns the list of upcoming IPOs. |
| FX_INTRADAY | Returns intraday exchange-rate time series for a currency pair. |
| FX_DAILY | Returns daily exchange-rate time series for a currency pair. |
| FX_WEEKLY | Returns weekly exchange-rate time series for a currency pair. |
| FX_MONTHLY | Returns monthly exchange-rate time series for a currency pair. |
| CURRENCY_EXCHANGE_RATE | Returns the real-time exchange rate for any pair of physical or digital currencies. |
| DIGITAL_CURRENCY_INTRADAY | Returns intraday time series for a digital currency. |
| DIGITAL_CURRENCY_DAILY | Returns daily time series for a digital currency. |
| DIGITAL_CURRENCY_WEEKLY | Returns weekly time series for a digital currency. |
| DIGITAL_CURRENCY_MONTHLY | Returns monthly time series for a digital currency. |
| WTI | Returns West Texas Intermediate crude oil prices. |
| BRENT | Returns Brent crude oil prices. |
| NATURAL_GAS | Returns natural gas prices. |
| COPPER | Returns global copper prices. |
| ALUMINUM | Returns global aluminum prices. |
| WHEAT | Returns global wheat prices. |
| CORN | Returns global corn prices. |
| COTTON | Returns global cotton prices. |
| SUGAR | Returns global sugar prices. |
| COFFEE | Returns global coffee prices. |
| ALL_COMMODITIES | Returns a global commodities price index. |
| REAL_GDP | Returns US real GDP data. |
| REAL_GDP_PER_CAPITA | Returns US real GDP per capita. |
| TREASURY_YIELD | Returns US Treasury yield for a chosen maturity. |
| FEDERAL_FUNDS_RATE | Returns the US federal funds (interest) rate. |
| CPI | Returns US Consumer Price Index data. |
| INFLATION | Returns US annual inflation rates. |
| RETAIL_SALES | Returns US advance retail sales data. |
| DURABLES | Returns US durable goods orders data. |
| UNEMPLOYMENT | Returns the US unemployment rate. |
| NONFARM_PAYROLL | Returns US total nonfarm payroll data. |
| SMA | Computes the Simple Moving Average technical indicator. |
| EMA | Computes the Exponential Moving Average technical indicator. |
| WMA | Computes the Weighted Moving Average technical indicator. |
| DEMA | Computes the Double Exponential Moving Average. |
| TEMA | Computes the Triple Exponential Moving Average. |
| TRIMA | Computes the Triangular Moving Average. |
| KAMA | Computes the Kaufman Adaptive Moving Average. |
| MAMA | Computes the MESA Adaptive Moving Average. |
| VWAP | Computes the Volume Weighted Average Price. |
| T3 | Computes the Triple Exponential Moving Average (T3). |
| MACD | Computes the Moving Average Convergence/Divergence indicator. |
| MACDEXT | Computes MACD with controllable moving-average types. |
| STOCH | Computes the Stochastic Oscillator. |
| STOCHF | Computes the Stochastic Fast oscillator. |
| RSI | Computes the Relative Strength Index. |
| STOCHRSI | Computes the Stochastic Relative Strength Index. |
| WILLR | Computes Williams' %R indicator. |
| ADX | Computes the Average Directional Movement Index. |
| ADXR | Computes the Average Directional Movement Index Rating. |
| APO | Computes the Absolute Price Oscillator. |
| PPO | Computes the Percentage Price Oscillator. |
| MOM | Computes the Momentum indicator. |
| BOP | Computes the Balance of Power indicator. |
| CCI | Computes the Commodity Channel Index. |
| CMO | Computes the Chande Momentum Oscillator. |
| ROC | Computes the Rate of Change indicator. |
| ROCR | Computes the Rate of Change Ratio. |
| AROON | Computes the Aroon indicator. |
| AROONOSC | Computes the Aroon Oscillator. |
| MFI | Computes the Money Flow Index. |
| TRIX | Computes the TRIX (1-day rate of change of a triple-smoothed EMA). |
| ULTOSC | Computes the Ultimate Oscillator. |
| DX | Computes the Directional Movement Index. |
| MINUS_DI | Computes the Minus Directional Indicator. |
| PLUS_DI | Computes the Plus Directional Indicator. |
| MINUS_DM | Computes the Minus Directional Movement. |
| PLUS_DM | Computes the Plus Directional Movement. |
| BBANDS | Computes Bollinger Bands. |
| MIDPOINT | Computes the MidPoint over a period. |
| MIDPRICE | Computes the MidPrice over a period. |
| SAR | Computes the Parabolic SAR. |
| TRANGE | Computes the True Range. |
| ATR | Computes the Average True Range. |
| NATR | Computes the Normalized Average True Range. |
| AD | Computes the Chaikin A/D (accumulation/distribution) Line. |
| ADOSC | Computes the Chaikin A/D Oscillator. |
| OBV | Computes On-Balance Volume. |
| HT_TRENDLINE | Computes the Hilbert Transform Instantaneous Trendline. |
| HT_SINE | Computes the Hilbert Transform Sine Wave. |
| HT_TRENDMODE | Computes the Hilbert Transform Trend vs Cycle Mode. |
| HT_DCPERIOD | Computes the Hilbert Transform Dominant Cycle Period. |
| HT_DCPHASE | Computes the Hilbert Transform Dominant Cycle Phase. |
| HT_PHASOR | Computes the Hilbert Transform Phasor Components. |
What you can do with it
Analyze a stock on demand
An agent pulls a daily time series, the company overview, and a few technical indicators to produce a grounded snapshot of how a stock is trading and what its fundamentals look like.
Track macro and commodities
The agent reads CPI, Treasury yields, and commodity prices to summarize the macro backdrop without a human assembling the figures by hand.
FAQ
- Is it free?
- Yes. A free Alpha Vantage API key works with the server; the key governs your rate limits, and premium endpoints and higher limits require a paid plan.
- Does it support remote/OAuth?
- It offers a hosted endpoint at https://mcp.alphavantage.co/mcp where you append your API key as an apikey query parameter; there is no OAuth. It can also run locally over stdio with the key passed as an argument.