The official Alpha Vantage API MCP server enables LLMs and agentic workflows to seamlessly interact with real-time and historical stock market data through the Model Context Protocol (MCP).
概览
The official Alpha Vantage API MCP server enables LLMs and agentic workflows to seamlessly interact with real-time and historical stock market data through the Model Context Protocol (MCP).
README
Alpha Vantage MCP Server
The official Alpha Vantage API MCP server enables LLMs and agentic workflows to seamlessly interact with real-time and historical stock market data through the Model Context Protocol (MCP). Add this server to your favorite apps such as Claude, Claude Code, Cursor, VS Code, and many more to give them access to comprehensive financial data.
Quickstart
To use the server, get your free Alpha Vantage API key, copy it to your clipboard, then follow the instructions below for the agentic tool/platform of your interest.
The Alpha Vantage functions are exposed directly as MCP tools. MCP clients discover the available tools with tools/list and invoke them with tools/call.
⭐ View MCP source code on Github
👉 Any questions? Please contact [email protected]
Connection Examples
Remote Server Connection (Recommended, OAuth):
https://mcp.alphavantage.co/mcp
When you connect, an authentication page opens where you enter and authorize your Alpha Vantage API key. If you would like to update/rotate the API key in the future, simple disconnect then reconnect the MCP server and enter the new key in the authentication page.
Remote Server Connection (Legacy, API key in URL, deprecated):
https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY
Local Server Connection:
uvx marketdata-mcp-server YOUR_API_KEY
Setup Instructions by Platform
💬📊 Chatbots
🤖📈 Agentic systems
💻💵 Coding tools
💡💡 I’m just exploring
Just exploring what to build? Check out the Trading Agents stock research tool (#1 trending on Github), which is powered by Alpha Vantage market data with no setup required.
Examples
Below are four example prompts and Claude’s expected responses when using the MCP server.
1. Fetch and display structured market data across assets
Prompt: “Give me last week’s OHLCV data for IBM”
Expected Behavior:
- Claude will select and invoke the correct tool, in this case the TIME_SERIES_DAILY function.
- Claude will make the necessary request to the TIME_SERIES_DAILY function and receive the relevant response.
- Claude will then respond directly in the chat interface with both text and image content:
Here’s IBM’s OHLCV data for last week (March 16–20, 2026):
IBM had a strong Tuesday rally to $256.11, then pulled back through the rest of the week. Friday saw a sharp selloff to close at the session low of $241.77 on more than double the average weekly volume — likely some notable news or broad market pressure driving that move.
2. Use technical indicators and price data to conduct technical analysis
Prompt: “Get NVDA’s hourly price data for the last two days. Compute RSI as well, and plot both hourly with guidelines at 30 and 70 for RSI”
Expected Behavior:
- Claude will select and invoke the correct tools, in this case the TIME_SERIES_INTRADAY function and the RSI function.
- Claude will make two separate requests, one to the TIME_SERIES_INTRADAY function and one to the RSI function. Claude will receive the relevant responses.
- Claude will then make an HTML artifact with the requested visualizations:
3. Visualize fundamental data
Prompt: “Help me visualize AAPL’s earnings surprise trends for the past 4 quarters. Compare actual EPS to analyst estimates”
Expected Behavior:
- Claude will select and invoke the correct tool, in this case the EARNINGS function.
- Claude will make the necessary request to the EARNINGS function and receive the relevant response.
- Claude will do any necessary calculations on top of the returned data, and create an HTML artifact:
4. Compare performance across asset classes
Prompt: “Compare gold, silver, and Bitcoin performance over the past 5 years”
Expected Behavior:
- Claude will select and invoke the correct tools, in this case the TIME_SERIES_MONTHLY function and the DIGITAL_CURRENCY_MONTHLY function.
- Claude will make three separate requests, one to the TIME_SERIES_INTRADAY function using the GLD symbol, one to the TIME_SERIES_INTRADAY function using the SLV symbol, and one to the DIGITAL_CURRENCY_MONTHLY function using the BTC symbol. Claude will receive the relevant responses.
- Claude will do any necessary calculations on top of the returned data, and create an HTML artifact:
Tools Reference
Note: The tools listed below are exposed directly as MCP tools and can be called by name.
| Category | Tools |
|---|---|
| core_stock_apis | TIME_SERIES_INTRADAY, TIME_SERIES_DAILY, TIME_SERIES_DAILY_ADJUSTED, TIME_SERIES_WEEKLY, TIME_SERIES_WEEKLY_ADJUSTED, TIME_SERIES_MONTHLY, TIME_SERIES_MONTHLY_ADJUSTED, GLOBAL_QUOTE, REALTIME_BULK_QUOTES, SYMBOL_SEARCH, MARKET_STATUS |
| options_data_apis | REALTIME_OPTIONS, REALTIME_OPTIONS_FMV, HISTORICAL_OPTIONS |
| alpha_intelligence | NEWS_SENTIMENT, EARNINGS_CALL_TRANSCRIPT, TOP_GAINERS_LOSERS, INSIDER_TRANSACTIONS, INSTITUTIONAL_HOLDINGS, ANALYTICS_FIXED_WINDOW, ANALYTICS_SLIDING_WINDOW |
| fundamental_data | COMPANY_OVERVIEW, INCOME_STATEMENT, BALANCE_SHEET, CASH_FLOW, EARNINGS, LISTING_STATUS, EARNINGS_CALENDAR, IPO_CALENDAR |
| forex | FX_INTRADAY, FX_DAILY, FX_WEEKLY, FX_MONTHLY |
| cryptocurrencies | CURRENCY_EXCHANGE_RATE, DIGITAL_CURRENCY_INTRADAY, DIGITAL_CURRENCY_DAILY, DIGITAL_CURRENCY_WEEKLY, DIGITAL_CURRENCY_MONTHLY |
| commodities | WTI, BRENT, NATURAL_GAS, COPPER, ALUMINUM, WHEAT, CORN, COTTON, SUGAR, COFFEE, GOLD_SILVER_SPOT, GOLD_SILVER_HISTORY, ALL_COMMODITIES |
| economic_indicators | REAL_GDP, REAL_GDP_PER_CAPITA, TREASURY_YIELD, FEDERAL_FUNDS_RATE, CPI, INFLATION, RETAIL_SALES, DURABLES, UNEMPLOYMENT, NONFARM_PAYROLL |
| technical_indicators | SMA, EMA, WMA, DEMA, TEMA, TRIMA, KAMA, MAMA, VWAP, T3, MACD, MACDEXT, STOCH, STOCHF, RSI, STOCHRSI, WILLR, ADX, ADXR, APO, PPO, MOM, BOP, CCI, CMO, ROC, ROCR, AROON, AROONOSC, MFI, TRIX, ULTOSC, DX, MINUS_DI, PLUS_DI, MINUS_DM, PLUS_DM, BBANDS, MIDPOINT, MIDPRICE, SAR, TRANGE, ATR, NATR, AD, ADOSC, OBV, HT_TRENDLINE, HT_SINE, HT_TRENDMODE, HT_DCPERIOD, HT_DCPHASE, HT_PHASOR |
| ping | PING, ADD_TWO_NUMBERS |
Table of Contents - API Tools
- core_stock_apis
- options_data_apis
- alpha_intelligence
- fundamental_data
- forex
- cryptocurrencies
- commodities
- economic_indicators
- technical_indicators
- ping
💡 Each of these MCP tools maps to a corresponding Alpha Vantage API endpoint. If you are interested in the full API specs (in addition to the brief tool descriptions below), please refer to the Alpha Vantage API documentation. For general guidance on choosing the best stock market data API and/or MCP server in the AI agent era, please refer to this article.
CORE_STOCK_APIS
| Category | Tool | Description |
|---|---|---|
| core_stock_apis | TIME_SERIES_INTRADAY |
Current and 20+ years of historical intraday OHLCV data |
| core_stock_apis | TIME_SERIES_DAILY |
Daily time series (OHLCV) covering 20+ years |
| core_stock_apis | TIME_SERIES_DAILY_ADJUSTED |
Daily adjusted OHLCV with split/dividend events |
| core_stock_apis | TIME_SERIES_WEEKLY |
Weekly time series (last trading day of week) |
| core_stock_apis | TIME_SERIES_WEEKLY_ADJUSTED |
Weekly adjusted time series with dividends |
| core_stock_apis | TIME_SERIES_MONTHLY |
Monthly time series (last trading day of month) |
| core_stock_apis | TIME_SERIES_MONTHLY_ADJUSTED |
Monthly adjusted time series with dividends |
| core_stock_apis | GLOBAL_QUOTE |
Latest price and volume for a ticker |
| core_stock_apis | REALTIME_BULK_QUOTES |
Realtime quotes for up to 100 symbols |
| core_stock_apis | SYMBOL_SEARCH |
Search for symbols by keywords |
| core_stock_apis | MARKET_STATUS |
Current market status worldwide |
OPTIONS_DATA_APIS
| Category | Tool | Description |
|---|---|---|
| options_data_apis | REALTIME_OPTIONS |
Realtime US options data with Greeks |
| options_data_apis | REALTIME_OPTIONS_FMV |
Realtime US options FMV (fair market value) mark prices |
| options_data_apis | HISTORICAL_OPTIONS |
Historical options chain for 15+ years |
ALPHA_INTELLIGENCE
| Category | Tool | Description |
|---|---|---|
| alpha_intelligence | NEWS_SENTIMENT |
Live and historical market news & sentiment |
| alpha_intelligence | EARNINGS_CALL_TRANSCRIPT |
Earnings call transcripts with LLM sentiment |
| alpha_intelligence | TOP_GAINERS_LOSERS |
Top 20 gainers, losers, and most active |
| alpha_intelligence | INSIDER_TRANSACTIONS |
Latest and historical insider transactions |
| alpha_intelligence | INSTITUTIONAL_HOLDINGS |
Institutional ownership and holdings information |
| alpha_intelligence | ANALYTICS_FIXED_WINDOW |
Advanced analytics over fixed windows |
| alpha_intelligence | ANALYTICS_SLIDING_WINDOW |
Advanced analytics over sliding windows |
FUNDAMENTAL_DATA
| Category | Tool | Description |
|---|---|---|
| fundamental_data | COMPANY_OVERVIEW |
Company information, financial ratios, and metrics |
| fundamental_data | INCOME_STATEMENT |
Annual and quarterly income statements |
| fundamental_data | BALANCE_SHEET |
Annual and quarterly balance sheets |
| fundamental_data | CASH_FLOW |
Annual and quarterly cash flow statements |
| fundamental_data | EARNINGS |
Annual and quarterly earnings data |
| fundamental_data | LISTING_STATUS |
Listing and delisting data for equities |
| fundamental_data | EARNINGS_CALENDAR |
Earnings calendar for upcoming earnings |
| fundamental_data | IPO_CALENDAR |
Initial public offering calendar |
FOREX
| Category | Tool | Description |
|---|---|---|
| forex | FX_INTRADAY |
Intraday foreign exchange rates |
| forex | FX_DAILY |
Daily foreign exchange rates |
| forex | FX_WEEKLY |
Weekly foreign exchange rates |
| forex | FX_MONTHLY |
Monthly foreign exchange rates |
CRYPTOCURRENCIES
| Category | Tool | Description |
|---|---|---|
| cryptocurrencies | CURRENCY_EXCHANGE_RATE |
Exchange rate between digital/crypto currencies |
| cryptocurrencies | DIGITAL_CURRENCY_INTRADAY |
Intraday time series for digital currencies |
| cryptocurrencies | DIGITAL_CURRENCY_DAILY |
Daily time series for digital currencies |
| cryptocurrencies | DIGITAL_CURRENCY_WEEKLY |
Weekly time series for digital currencies |
| cryptocurrencies | DIGITAL_CURRENCY_MONTHLY |
Monthly time series for digital currencies |
COMMODITIES
| Category | Tool | Description |
|---|---|---|
| commodities | WTI |
West Texas Intermediate (WTI) crude oil prices |
| commodities | BRENT |
Brent crude oil prices |
| commodities | NATURAL_GAS |
Henry Hub natural gas spot prices |
| commodities | COPPER |
Global copper prices |
| commodities | ALUMINUM |
Global aluminum prices |
| commodities | WHEAT |
Global wheat prices |
| commodities | CORN |
Global corn prices |
| commodities | COTTON |
Global cotton prices |
| commodities | SUGAR |
Global sugar prices |
| commodities | COFFEE |
Global coffee prices |
| commodities | GOLD_SILVER_SPOT |
Live spot prices for gold and silver |
| commodities | GOLD_SILVER_HISTORY |
Historical gold and silver prices (daily, weekly, monthly) |
| commodities | ALL_COMMODITIES |
All commodities prices |
ECONOMIC_INDICATORS
| Category | Tool | Description |
|---|---|---|
| economic_indicators | REAL_GDP |
Real Gross Domestic Product |
| economic_indicators | REAL_GDP_PER_CAPITA |
Real GDP per capita |
| economic_indicators | TREASURY_YIELD |
Daily treasury yield rates |
| economic_indicators | FEDERAL_FUNDS_RATE |
Federal funds rate (interest rates) |
| economic_indicators | CPI |
Consumer Price Index |
| economic_indicators | INFLATION |
Inflation rates |
| economic_indicators | RETAIL_SALES |
Retail sales data |
| economic_indicators | DURABLES |
Durable goods orders |
| economic_indicators | UNEMPLOYMENT |
Unemployment rate |
| economic_indicators | NONFARM_PAYROLL |
Non-farm payroll data |
TECHNICAL_INDICATORS
| Category | Tool | Description |
|---|---|---|
| technical_indicators | SMA |
Simple moving average (SMA) values |
| technical_indicators | EMA |
Exponential moving average (EMA) values |
| technical_indicators | WMA |
Weighted moving average (WMA) values |
| technical_indicators | DEMA |
Double exponential moving average (DEMA) values |
| technical_indicators | TEMA |
Triple exponential moving average (TEMA) values |
| technical_indicators | TRIMA |
Triangular moving average (TRIMA) values |
| technical_indicators | KAMA |
Kaufman adaptive moving average (KAMA) values |
| technical_indicators | MAMA |
MESA adaptive moving average (MAMA) values |
| technical_indicators | VWAP |
Volume weighted average price (VWAP) for intraday time series |
| technical_indicators | T3 |
Triple exponential moving average (T3) values |
| technical_indicators | MACD |
Moving average convergence / divergence (MACD) values |
| technical_indicators | MACDEXT |
Moving average convergence / divergence values with controllable moving average type |
| technical_indicators | STOCH |
Stochastic oscillator (STOCH) values |
| technical_indicators | STOCHF |
Stochastic fast (STOCHF) values |
| technical_indicators | RSI |
Relative strength index (RSI) values |
| technical_indicators | STOCHRSI |
Stochastic relative strength index (STOCHRSI) values |
| technical_indicators | WILLR |
Williams’ %R (WILLR) values |
| technical_indicators | ADX |
Average directional movement index (ADX) values |
| technical_indicators | ADXR |
Average directional movement index rating (ADXR) values |
| technical_indicators | APO |
Absolute price oscillator (APO) values |
| technical_indicators | PPO |
Percentage price oscillator (PPO) values |
| technical_indicators | MOM |
Momentum (MOM) values |
| technical_indicators | BOP |
Balance of power (BOP) values |
| technical_indicators | CCI |
Commodity channel index (CCI) values |
| technical_indicators | CMO |
Chande momentum oscillator (CMO) values |
| technical_indicators | ROC |
Rate of change (ROC) values |
| technical_indicators | ROCR |
Rate of change ratio (ROCR) values |
| technical_indicators | AROON |
Aroon (AROON) values |
| technical_indicators | AROONOSC |
Aroon oscillator (AROONOSC) values |
| technical_indicators | MFI |
Money flow index (MFI) values |
| technical_indicators | TRIX |
1-day rate of change of a triple smooth exponential moving average (TRIX) values |
| technical_indicators | ULTOSC |
Ultimate oscillator (ULTOSC) values |
| technical_indicators | DX |
Directional movement index (DX) values |
| technical_indicators | MINUS_DI |
Minus directional indicator (MINUS_DI) values |
| technical_indicators | PLUS_DI |
Plus directional indicator (PLUS_DI) values |
| technical_indicators | MINUS_DM |
Minus directional movement (MINUS_DM) values |
| technical_indicators | PLUS_DM |
Plus directional movement (PLUS_DM) values |
| technical_indicators | BBANDS |
Bollinger bands (BBANDS) values |
| technical_indicators | MIDPOINT |
Midpoint values - (highest value + lowest value)/2 |
| technical_indicators | MIDPRICE |
Midpoint price values - (highest high + lowest low)/2 |
| technical_indicators | SAR |
Parabolic SAR (SAR) values |
| technical_indicators | TRANGE |
True range (TRANGE) values |
| technical_indicators | ATR |
Average true range (ATR) values |
| technical_indicators | NATR |
Normalized average true range (NATR) values |
| technical_indicators | AD |
Chaikin A/D line (AD) values |
| technical_indicators | ADOSC |
Chaikin A/D oscillator (ADOSC) values |
| technical_indicators | OBV |
On balance volume (OBV) values |
| technical_indicators | HT_TRENDLINE |
Hilbert transform, instantaneous trendline (HT_TRENDLINE) values |
| technical_indicators | HT_SINE |
Hilbert transform, sine wave (HT_SINE) values |
| technical_indicators | HT_TRENDMODE |
Hilbert transform, trend vs cycle mode (HT_TRENDMODE) values |
| technical_indicators | HT_DCPERIOD |
Hilbert transform, dominant cycle period (HT_DCPERIOD) values |
| technical_indicators | HT_DCPHASE |
Hilbert transform, dominant cycle phase (HT_DCPHASE) values |
| technical_indicators | HT_PHASOR |
Hilbert transform, phasor components (HT_PHASOR) values |
PING
| Category | Tool | Description |
|---|---|---|
| ping | PING |
Health check tool that returns ‘pong’ |
| ping | ADD_TWO_NUMBERS |
Example tool for adding two numbers |
安装
uvx marketdata-mcp-server YOUR_API_KEY配置
{
"mcpServers": {
"alphavantage": {
"command": "uvx",
"args": ["marketdata-mcp-server", "YOUR_API_KEY"]
}
}
}