
Alpha Vantage Mcp
io.github.alphavantage由 GitHub 帳號 alphavantage 發布v1.0.0更新於 Oct 25, 2026
Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
概覽
Alpha Vantage 的遠端 MCP 伺服器讓助理取得即時與歷史市場資料,涵蓋股票、選擇權、外匯、加密貨幣、大宗商品與經濟指標。
- 可以做什麼
- 取得股票時間序列、報價、代碼搜尋與市場狀態,以及選擇權資料和批次即時報價與買賣價。計算 RSI、MACD、移動平均線、布林通道、隨機指標等技術指標。讀取基本面資料:公司概況、損益表、資產負債表、現金流量、財報、IPO 與財報行事曆。查詢外匯、加密貨幣與大宗商品價格,以及 GDP、CPI、公債殖利率、失業率等經濟指標。讀取新聞情緒、財報電話會議紀錄、內部人交易、機構持股與國會交易紀錄。
- 適用情境
- 適合需要助理依據即時資料而非既有知識回答市場或金融問題的情境,例如價格歷史、技術分析、財報比較或跨資產表現比較。
- 執行需求
- 透過 HTTP/SSE 存取的遠端端點,使用 OAuth 驗證;需在提供方的授權頁面輸入並授權 Alpha Vantage API 金鑰。需要免費或付費的 Alpha Vantage 金鑰;也可選用本機方式,透過 Python uvx 套件執行並將金鑰作為參數傳入。需要網路存取。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Alpha Vantage Mcp,將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
Web executable,透過 SSE。 遠端服務在工作區中設定後即可從網頁執行環境執行。
交給代理程式安裝
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.alphavantage%2Falpha_vantage_mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。其他 MCP 客戶端
把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。
{
"mcpServers": {
"alpha-vantage": {
"type": "sse",
"url": "https://mcp.alphavantage.co/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):
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):
Local Server Connection:
Setup Instructions by Platform
💬📊 Chatbots
⭐ (Anthropic-Verified Connector) Install in Claude
Requirements:
- Any free or paid Claude account
📺 Watch the setup tutorial. (Click image below.)
[Alpha Vantage MCP Server: Official Claude Connector Setup]
Claude Remote Server Connection (Recommended, OAuth)
The Alpha Vantage MCP Server is already listed in Claude's official Connectors directory. Getting started is easy:
- Go to https://claude.ai/new#settings/customize-connectors (Web) or Settings → Connectors (Desktop)
- Click the "Add" button in the upper-right corner and choose "Browse connectors" in the dropdown menu
- Search for "Alpha Vantage" in the search box
- Click on the "Alpha Vantage MCP Server" tile returned by the search result
- Click "Connect" near the top-right of the page
- Enter your Alpha Vantage API key in the pop-up authentication page
- Click "Authorize Access"
If you would like to update/rotate the API key in the future, simply disconnect then reconnect to the MCP server and follow steps #6 and #7 again. This brief video shows the key rotation process:
[Update Your API Key: Alpha Vantage MCP Server]
Claude Local Server Connection
See Claude Desktop MCP docs for more info.
Install uv (a modern Python package and project manager):
Open Claude Desktop developer settings and edit your claude_desktop_config.json file to add the following configuration:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
⭐ (OpenAI-Verified Connector) Install in ChatGPT
Requirements:
- Any free or paid ChatGPT account
📺 Watch the setup tutorial. (Click image below.)
[Connecting to the Alpha Vantage Plugin in ChatGPT]
ChatGPT Remote Server Connection (Recommended, OAuth)
The Alpha Vantage MCP Server is already listed in ChatGPT's official app directory. Getting started is easy:
- In ChatGPT, click Plugins
- Type "Alpha Vantage" into the Search plugins bar
- Click the + (or Install) button on the Alpha Vantage result.
- Enter your Alpha Vantage API key in the pop-up authentication page
- Click "Authorize Access"
If you would like to update/rotate the API key in the future, simply disconnect then reconnect the MCP server and follow steps #4 and #5 again.
Test your connection with a sample query:
📺 Below are a few examples of ChatGPT performing various stock analysis & charting tasks:
Install in Grok
Requirements:
- SuperGrok (or higher tier)
Setup:
- Click the
+button → Connectors → Add connector → Custom - Name: Alpha Vantage MCP Server (or whatever you prefer)
- Server URL:
https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY(replaceYOUR_API_KEYwith your actual Alpha Vantage API key). - Click Add Connector
🤖📈 Agentic systems
⭐ (Microsoft-Verified Connector) Connect in Microsoft Azure AI Foundry
Requirements:
- Azure subscription with access to Azure AI Foundry
📺 Watch the setup tutorial. (Click image below.)
[1-Min Financial AI Agents: Alpha Vantage MCP + Azure AI Foundry]
Microsoft Azure AI Foundry — Agent Service Connection
To connect a Foundry agent to this MCP server:
- Open your agent (or Create Agent from Home Dashboard) in Azure AI Foundry's Agent playground or Agent designer.
- In the Tools section of the agent configuration, click Add → Browse All Tools. Select the Catalog tab, then search for Alpha Vantage MCP Server or filter by Finance under the Category filter. Click Create.
- Configure the connection with the following settings:
- Name: Accept the default generated name, or enter your own
- (read-only) Remote MCP Server endpoint:
https://mcp.alphavantage.co/mcp - (read-only) Authentication: Key-based
- Credential — apikey: Enter your Alpha Vantage API key
- Click Connect.
Recommended Agent Instructions:
Add the following to your agent's system prompt to optimize performance:
Install in Hermes Agent (Nous Research)
Requirements:
- Hermes Agent installed with the
hermesCLI available
Hermes Remote Server Connection (Recommended, OAuth)
Add the server and start the authorization flow:
Or configure it directly in config.yaml:
A browser consent 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, run hermes mcp login alphavantage (or hermes mcp reauth alphavantage) again and enter the new key on the consent page.
Verify the connection with:
Hermes Remote Server Connection (API key in URL)
For non-interactive environments (e.g., terminal-only setups where the browser-based OAuth flow is not possible), put the API key in the server URL instead. Add the server to your config.yaml under mcp_servers:
Replace YOUR_API_KEY with your actual Alpha Vantage API key. To update/rotate the API key, simply change the key in the URL.
Verify the connection with:
Install in 🦞OpenClaw🦞
Requirements:
- Mac with Apple Silicon (or dedicated Mac mini)
- LLM API Key (OpenAI used in demo)
- Messaging Platform Bot Token (Telegram used in demo)
📺 Watch the setup tutorial (click image below)
[This AI Agent Tracks Stocks 24/7 (OpenClaw Setup Tutorial)]
- View the detailed installation guide from GitHub Gist
- For additional support links, please check the video description on YouTube.
Configure in OpenAI Agent Builder
Requirements:
- OpenAI account with access to Agent Builder (e.g., billing details added, organization verified)
📺 Watch the setup tutorial. (Click image below.)
[Configure Alpha Vantage MCP Server + OpenAI Agent Builder]
OpenAI Agent Builder Connection
To connect OpenAI Agent Builder to this MCP server:
- Do not add a separate MCP Server object. Instead, click on your agent in OpenAI Agent Builder to add the MCP Server directly to the agent.
- Find the Tools section of the agent and click the + button to add a new tool
- Select MCP Server
- Click "+ Server" in the upper right of the "Add MCP server" menu
- Configure the MCP server with the following settings:
- URL:
https://mcp.alphavantage.co/mcp - Label:
Alpha Vantage MCP Server(or any name you prefer) - Description:
Financial market data and technical indicators(or any description you prefer) - Authentication: Select "Access token / API key" (should be default)
- Access Token: Enter your Alpha Vantage API key
- URL:
- Click Connect
- If successful, the next prompt will display all the tools. Scroll to the bottom and click Add.
Recommended Agent Instructions:
Add the following instruction to your agent's configuration to optimize performance:
Install in OpenAI Agents SDK
To use the Alpha Vantage MCP server with OpenAI Agents SDK, see our example agent that demonstrates:
- Interactive financial analysis agent
- Session management for conversation continuity
- Real-time tool execution with Alpha Vantage data
- Support for both HTTP and stdio MCP connections
The example includes a complete setup guide and configuration templates.
💻💵 Coding tools
⭐ (Anthropic-Verified Connector) Install in Claude Code
Requirements:
- Any free or paid Claude account
Claude Remote Server Connection (Recommended, OAuth)
The Alpha Vantage MCP Server is already listed in Claude's official Connectors directory. Getting started is easy:
- Go to https://claude.ai/new#settings/customize-connectors (Web) or Settings → Connectors (Desktop)
- Click the "Add" button in the upper-right corner and choose "Browse connectors" in the dropdown menu
- Search for "Alpha Vantage" in the search box
- Click on the "Alpha Vantage MCP Server" tile returned by the search result
- Click "Connect" near the top-right of the page
- Enter your Alpha Vantage API key in the pop-up authentication page
- Click "Authorize Access"
If you would like to update/rotate the API key in the future, simply disconnect then reconnect the MCP server and follow steps #6 and #7 again. This brief video shows the key rotation process.
Claude Code Local Server Connection
First, install uv (a modern Python package and project manager):
Then run:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Run claude in your terminal from your project directory.
Then connect with:
⭐ (OpenAI-Verified Connector) Install in OpenAI Codex
Requirements:
- Any free or paid ChatGPT account
See OpenAI Codex for more information.
Note: Codex and ChatGPT share the same account, so a plugin installed in one should be available for the other.
Codex Remote Server Connection via ChatGPT App (Recommended, OAuth)
The Alpha Vantage MCP Server is already listed in ChatGPT's official app directory. Getting started is easy:
- In Codex, click Plugins
- Type "Alpha Vantage" into the Search plugins bar
- Click the + (or Install) button on the Alpha Vantage result.
- Enter your Alpha Vantage API key in the pop-up authentication page
- Click "Authorize Access"
If you would like to update/rotate the API key in the future, simply disconnect then reconnect the MCP server and follow steps #4 and #5 again.
Test your connection with a sample query:
📺 Watch the tutorial. (Click image below.)
⚠️ Legacy setup notice: The initial connection steps demonstrate the legacy local method. For new installations, we strongly recommend following the OAuth instructions above.
Starting at 01:41, the video covers troubleshooting and building end-to-end applications powered by Alpha Vantage market data and dynamic visualizations.
[Alpha Vantage MCP + Codex Tutorial]
- Download the companion .md file from Github Gist.
- For additional support links, please check the video description on YouTube.
Codex Remote Server Connection via CLI (Alternative, OAuth)
Prefer the command line? Getting started is easy:
- Add the server by running:
- Codex will open your browser. Enter your Alpha Vantage API key in the pop-up authentication page
- Click "Authorize Access"
- Run
codexfrom your project directory - Verify the connection with:
If you would like to update/rotate the API key in the future, simply run codex mcp add again and enter the new key in the authentication page.
Test your connection with a sample query:
Install in VS Code (Visual Studio Code)
See VS Code MCP docs for more info.
Create .vscode/mcp.json (your VS Code MCP config file) in your workspace, and paste into it one of the following configurations, depending on whether you’re connecting remotely or running the server locally.
VS Code Remote Server Connection
Paste the following into .vscode/mcp.json:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
VS Code Local Server Connection
First, install uv (a modern Python package and project manager):
Then, paste the following into .vscode/mcp.json:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Open the Chat view and select Agent mode
Install in Continue (Extension for VS Code, JetBrains)
See Continue MCP docs for more information. Continue uses its own configuration format (not VS Code's mcp.json).
Create .continue/mcpServers/alphavantage.yaml in your workspace, and paste into it one of the following configurations, depending on whether you’re connecting remotely or running the server locally. (Recommended: Remote)
Continue Remote Server Connection
Paste the following into .continue/mcpServers/alphavantage.yaml:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Continue Local Server Connection
First, install uv (a modern Python package and project manager):
Then, paste the following into .continue/mcpServers/alphavantage.yaml:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Open the Continue panel and select Agent mode. Set up your LLM provider.
Install in Cursor
See Cursor MCP docs for more information.
Paste one of the following configurations into your Cursor ~/.cursor/mcp.json file, depending on whether you’re connecting remotely or running the server locally. You may also install in a specific project by creating .cursor/mcp.json in your project folder.
Cursor Remote Server Connection
Configure Cursor by editing ~/.cursor/mcp.json:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Cursor Local Server Connection
First, install uv (a modern Python package and project manager):
Then, paste the following into your Cursor ~/.cursor/mcp.json file:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Install in Gemini CLI
See Gemini CLI Configuration for more information.
Run one of the following commands, depending on whether you’re connecting remotely or running the server locally.
Gemini CLI Remote Server Connection (Recommended):
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Gemini CLI Local Server Connection:
Install uv (a modern Python package and project manager):
Then run:
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Manual Configuration:
- Open the Gemini CLI settings file. The location is
~/.gemini/settings.json(where~is your home directory). - Add the following to the
mcpServersobject in yoursettings.jsonfile (replaceYOUR_API_KEYwith your actual Alpha Vantage API key):
Or, for a local server (replace YOUR_API_KEY with your actual Alpha Vantage API key):
If the mcpServers object does not exist, create it.
💡💡 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_price]
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:
[NVDA_RSI]
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.
Table of Contents - API Tools
- core_stock_apis
- options_data_apis
- alpha_intelligence
- fundamental_data
- forex
- cryptocurrencies
- commodities
- economic_indicators
- technical_indicators
- ping
- congress
💡 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. Independent API & MCP aggregation platform API Market has also published a practitioner's guide to stock data, which details when to use an MCP server vs. a conventional API (or both) for your workflow design.
CORE_STOCK_APIS
OPTIONS_DATA_APIS
ALPHA_INTELLIGENCE
FUNDAMENTAL_DATA
FOREX
CRYPTOCURRENCIES
COMMODITIES
ECONOMIC_INDICATORS
TECHNICAL_INDICATORS
PING
CONGRESS
CONGRESS_TRADES requires at least one of symbol or bioguide_id (both may be given together to intersect the results); datatype defaults to json and also accepts csv. Example calls: CONGRESS_TRADES(symbol="AAPL") and CONGRESS_TRADES(bioguide_id="S000510"). Use POLITICIAN_METADATA to look up a politician's bioguide_id.
POLITICIAN_METADATA takes no filter or pagination arguments: every call returns the complete, deterministic roster of representatives directly from Alpha Vantage. The response is large enough to trigger the server's standard preview/CDN handling by default; pass return_full_data=true to receive the complete payload inline.
Both tools proxy the public Alpha Vantage CONGRESS_TRADES and POLITICIAN_METADATA endpoints and preserve upstream response fields (including source_url) unchanged.
來源:README.md,提交 3ed9b05
工具
0版本歷史
1- v1.0.0最新Sep 16, 2026
評分
已滿足適用檢查項的 85%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
