# Alpha Vantage Mcp > Alpha Vantage MCP Server - **Type:** MCP server - **Install:** `agentstack add mcp-alphavantage-alpha-vantage-mcp` - **Verified:** Pending review - **Seller:** [alphavantage](https://agentstack.voostack.com/s/alphavantage) - **Installs:** 0 - **Category:** [Integrations](https://agentstack.voostack.com/c/integrations) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [alphavantage](https://github.com/alphavantage) - **Source:** https://github.com/alphavantage/alpha_vantage_mcp - **Website:** https://mcp.alphavantage.co ## Install ```sh agentstack add mcp-alphavantage-alpha-vantage-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # 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](https://github.com/alphavantage/alpha_vantage_mcp) πŸ‘‰ Any questions? Please contact support@alphavantage.co   ### Connection Examples **Remote Server Connection (Recommended, OAuth):** ``` https://mcp.alphavantage.co/mcp ``` When you connect, a consent page opens where you enter and authorize your Alpha Vantage API key. **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 Use Case πŸ’¬πŸ“Š _Power your chatbot with financial data_ Install in Claude **Requirements:** - Claude Pro account (or higher tier) #### Claude Remote Server Connection To connect Claude (Web or Desktop) to this MCP server: πŸ“Ί Watch the **setup tutorial** - Click the image below to watch a step-by-step video guide: [](https://www.youtube.com/watch?v=W69x2qJcYmI) πŸ“Ί Already have your Alpha Vantage MCP server set up? Below are a few examples of Claude performing various stock analysis & charting tasks: [](https://www.youtube.com/watch?v=tyl9E7fddvU) **OAuth Option (Recommended):** 1. Go to [claude.ai/settings/connectors](https://claude.ai/settings/connectors) (Web) or Settings β†’ Connectors (Desktop) 2. Click "Add Custom Connector" 3. Add the MCP server URL: `https://mcp.alphavantage.co/mcp` 4. Click "Connect" 5. Enter your Alpha Vantage API key 6. Click "Authorize Access" **API Key in URL (Legacy, deprecated):** 1. Go to [claude.ai/settings/connectors](https://claude.ai/settings/connectors) (Web) or Settings β†’ Connectors (Desktop) 2. Click "Add Custom Connector" 3. Add the MCP server URL with your API key: `https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY` (replace `YOUR_API_KEY` with your actual Alpha Vantage API key) 4. Click "Connect" #### Claude Local Server Connection See [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) for more info. Install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` Open Claude Desktop developer settings and edit your `claude_desktop_config.json` file to add the following configuration: ```json { "mcpServers": { "alphavantage": { "command": "uvx", "args": ["marketdata-mcp-server", "YOUR_API_KEY"] } } } ``` Replace `YOUR_API_KEY` with your actual Alpha Vantage API key. Install in ChatGPT **Requirements:** - ChatGPT Plus account (or higher tier) - Developer mode enabled (beta feature) - see [OpenAI's Developer Mode documentation](https://platform.openai.com/docs/guides/developer-mode) πŸ“Ί Watch the **setup tutorial** - Click the image below to watch a step-by-step video guide: [](https://www.youtube.com/watch?v=pY2nr3FWXs0) πŸ“Ί Already have your Alpha Vantage MCP server set up? Below are a few examples of ChatGPT performing various stock analysis & charting tasks: [](https://www.youtube.com/watch?v=LBuHa8Ymw-0) **Setup (Recommended, OAuth):** 1. Go to [ChatGPT Settings β†’ Apps](https://chatgpt.com/#settings/Connectors) 2. Click on **Advanced settings β†’** enable **Developer mode** 3. Return to the **Apps** submenu, then click **Create app**. 4. **MCP Server URL**: `https://mcp.alphavantage.co/mcp` 5. **Authentication:** OAuth. When you connect, a consent page opens where you enter and authorize your Alpha Vantage API key. **Legacy (API key in URL, deprecated):** 1. Go to [ChatGPT Settings β†’ Apps](https://chatgpt.com/#settings/Connectors) 2. Click on **Advanced settings β†’** enable **Developer mode** 3. Return to the **Apps** submenu, then click **Create app**. 4. **MCP Server URL**: `https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY` (replace `YOUR_API_KEY` with your actual Alpha Vantage API key). 5. **Authentication:** No authentication > **Note:** When you return to your conversation, your UI will clearly indicate that you are in **Developer mode**. ChatGPT will retain memory of any previous remarks made within the same chat session; however, **these sessions may not be persisted**, meaning the conversation generated while Developer mode is active may not be saved or accessible once closed. **Troubleshooting for ChatGPT Plus Accounts** While Developer mode is available for both **Plus** and **Pro** accounts, on **Plus** accounts, first-time MCP tool execution may exhibit inconsistent behavior. This primarily affects large data payloads returned from the MCP server. If you notice that MCP calls abruptly terminate without returning any JSON response, try the following: 1. **Confirm Connection** - Confirm the connection by prompting: ``` List 3 functions available in Alpha Vantage MCP server. ``` - You should see endpoints like `TIME_SERIES_DAILY` and `TIME_SERIES_INTRADAY`. 2. **Force JSON Passthrough with simple payload** - Use the following prompts in sequence to prime ChatGPT to surface the full payload: ``` Run ADD_TWO_NUMBERS from Alpha Vantage MCP Server using 3 and 6, and then show the JSON response. ``` - If successful, ChatGPT should ask you to **Confirm** or **Deny** the call. Click **Confirm**. - If it doesn't, use the πŸ”„ "Try Again..." button and see if you get the **Confirm**/**Deny** prompt. - If this doesn't work, ask ChatGPT the following, and if it starts `Thinking` make it **Skip**, so that it doesn't try the call again and instead outputs its conversational response. ``` Why aren't you receiving a JSON response? ``` - Then, regardless of the response, prompt ChatGPT ``` Explicitly request a return value from the tool response to verify what the server outputs. ``` - Typically, this gets ChatGPT to ask you to **Confirm** or **Deny** the call. Click **Confirm**. - Sometimes, ChatGPT will insist it has no active connection to Alpha Vantage MCP Server. Just tell it to "try again". - If payloads still fail to appear, start a New Chat and try Step #2 again. 3. **Force JSON Passthrough with large payload** - Once step #2 has been successful, repeat step #2 with the larger call: ``` Run TIME_SERIES_DAILY using NVDA, and then show the JSON response. ``` - Use the fallback steps from Step #2 if ChatGPT does not ask you to **Confirm** or **Deny** the call. - Once you observe ChatGPT successfully return part of the raw JSON payload from the larger call, you can typically continue on with more conversational queries. Install in Grok **Requirements:** - SuperGrok (or higher tier) **Setup:** 1. Click the `+` button β†’ **Connectors** β†’ **Add connector** β†’ **Custom** 2. **Name**: Alpha Vantage MCP Server (or whatever you prefer) 3. **Server URL**: `https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY` (replace `YOUR_API_KEY` with your actual Alpha Vantage API key). 4. Click **Add Connector**   πŸ€–πŸ“ˆ _Create agentic workflows for quantitative investing_ 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) [](https://www.youtube.com/watch?v=Z6DjYKN4uos) - [View the detailed installation guide from GitHub Gist](https://gist.github.com/gabriel1l/2e6ebe57e9a17983aa8596fd7c5bcdc7) - For additional support links, please check the video description on YouTube. Configure in OpenAI Agent Builder **Requirements:** - OpenAI account with [access to Agent Builder](https://platform.openai.com/docs/guides/agents) (e.g., billing details added, organization verified) πŸ“Ί Watch the **setup tutorial**. (Click image below.) [](https://www.youtube.com/watch?v=2Rsvzjn8hwE) #### OpenAI Agent Builder Connection To connect OpenAI Agent Builder to this MCP server: 1. 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. 2. Find the Tools section of the agent and click the + button to add a new tool 3. Select MCP Server 4. Click "+ Server" in the upper right of the "Add MCP server" menu 5. 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 6. Click Connect 7. 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: ``` You are a helpful financial agent with access to market data through Alpha Vantage MCP Server. The Alpha Vantage functions (TIME_SERIES_DAILY, RSI, COMPANY_OVERVIEW, etc.) are exposed directly as MCP tools. Call them by name with their parameters, e.g. TIME_SERIES_DAILY(symbol="AAPL", outputsize="compact"). ``` Install in OpenAI Agents SDK To use the Alpha Vantage MCP server with OpenAI Agents SDK, see our [example agent](https://github.com/alphavantage/alpha_vantage_mcp/blob/main/examples/agent/README.md) 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. Configure in Microsoft Foundry Agent Service **Requirements:** - Azure subscription with access to [Azure AI Foundry](https://ai.azure.com) #### Microsoft Foundry Agent Service Connection To connect a Foundry agent to this MCP server: 1. Open your agent (or Create Agent from Home Dashboard) in Azure AI Foundry's Agent playground or Agent designer. 2. In the **Tools** section of the agent configuration, click **Add** β†’ **Browse All Tools**. Select the **Custom** category underneath "Select a Tool" and select **Model Context Protocol** 3. Configure the MCP server with the following settings: - Key-based authentication (recommended): - Server label: `alpha-vantage-mcp-server` (or any name you prefer) - Server URL: `https://mcp.alphavantage.co/mcp` - Authentication: Select **Key-based authentication** - Credential - Click "Add key value pair" - Key: `apikey` - Value: Enter your Alpha Vantage API key - Unauthenticated (legacy, API key in URL, deprecated): - Server label: `alpha-vantage-mcp-server` (or any name you prefer) - Server URL: `https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY` - Replace `YOUR_API_KEY` with your actual Alpha Vantage API key. - Authentication: Select **Unauthenticated** 4. Click **Connect** **Recommended Agent Instructions:** Add the following instruction to your agent's system prompt to optimize performance: ``` You are a helpful financial agent with access to market data through Alpha Vantage MCP Server. The Alpha Vantage functions (TIME_SERIES_DAILY, RSI, COMPANY_OVERVIEW, etc.) are exposed directly as MCP tools. Call them by name with their parameters, e.g. TIME_SERIES_DAILY(symbol="IBM", outputsize="compact"). Always use Alpha Vantage MCP Server for market data queries. Do not answer from prior knowledge or web search. ```   πŸ’»πŸ’΅ _Code up fintech apps_ Install in OpenAI Codex **Requirements:** - ChatGPT Plus account (or higher tier) See [OpenAI Codex](https://github.com/openai/codex) for more information. πŸ“Ί Watch the **setup tutorial**. (Click image below.) This video additionally provides guidance on handling setup errors and building complete end-to-end applications which are empowered to fetch market data to power dynamic, data-driven visualizations. [](https://www.youtube.com/watch?v=8exfs5wpTU0) - [Download the companion .md file from Github Gist.](https://tinyurl.com/7uwdd6ud) - For additional support links, please check the video description on YouTube. Install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` Install **Codex CLI v0.34 or later** to avoid compatibility issues. ```bash # Install (if not already installed) npm install -g @openai/codex # Or update to the latest version npm update -g @openai/codex # Verify installation and version codex --version ``` Add the following configuration to your Codex MCP server settings by editing `~/.codex/config.toml`: ```toml [mcp_servers.alphavantage] command = "uvx" args = ["marketdata-mcp-server", "YOUR_API_KEY"] ``` Replace `YOUR_API_KEY` with your actual Alpha Vantage API key. Run `codex` in your terminal from your project directory. First-time users will be guided through additional prompts. Then connect with: ``` /mcp ``` Install in Claude Code **Requirements:** - Claude Pro account (or higher tier) See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) for more information. Run one of the following commands, depending on whether you’re connecting remotely or running the server locally. #### Claude Code Remote Server Connection ```bash claude mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY ``` Replace `YOUR_API_KEY` with your actual Alpha Vantage API key. #### Claude Code Local Server Connection First, install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` Then run: ```bash claude mcp add alphavantage -- uvx marketdata-mcp-server YOUR_API_KEY ``` Replace `YOUR_API_KEY` with your actual Alpha Vantage API key. Run `claude` in your terminal from your project directory. Then connect with: ``` /mcp ``` Install in VS Code (Visual Studio Code) See [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) 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`: ```json { "servers": { "alphavantage": { "type": "http", "url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY" } } } ``` Replace `YOUR_API_KEY` with your actual Alpha Vantage API key. #### VS Code Local Server Connection First, install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` Then, paste the following into `.vscode/mcp.json`: ```json { "servers": { "alphavantage": { "type": "stdio", "command": "uvx", "args": ["marketdata-mcp-server", "YOUR_API_KEY"] } } } ``` 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](https://docs.continue.dev/customize/deep-dives/mcp) for more informati … ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source β€” we do not rehost the code. - **Author:** [alphavantage](https://github.com/alphavantage) - **Source:** [alphavantage/alpha_vantage_mcp](https://github.com/alphavantage/alpha_vantage_mcp) - **License:** MIT - **Homepage:** https://mcp.alphavantage.co Install and usage instructions live in the source repository linked above. ## Pricing - **Free** β€” Free ## Security capabilities Automated source analysis of v0.1.0 β€” what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source β€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** β€” security scan: flagged β€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-alphavantage-alpha-vantage-mcp - Seller: https://agentstack.voostack.com/s/alphavantage - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack β€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.