[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_105":106},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@alphavantage/alpha-vantage-mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","alphavantage","moduleId","alpha-vantage-mcp","@alphavantage/alpha-vantage-mcp","displayName","alpha vantage mcp","tagline","Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators","iconKey","https://avatars.githubusercontent.com/u/50210747?v=4","category","data","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.alphavantage.co/mcp\",\"transport\":\"sse\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363387000,"updatedAt",1781499586000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.alphavantage%2Falpha_vantage_mcp","sourceVerified",true,"importedAt","upstreamStars",170,"upstreamUpdatedAt",1780079514000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/alphavantage/alpha_vantage_mcp","githubRepoFullName","alphavantage/alpha_vantage_mcp","releaseId","ext-alphavantage-alpha-vantage-mcp","version","1.0.0","descriptionMarkdown","# Alpha Vantage MCP Server\n\nThe 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.\n\n---\n\n## Quickstart\n\nTo 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.\n\n⚡ We use an optimization technique called [**Progressive Tool Discovery**](https://github.com/alphavantage/alpha_vantage_mcp/blob/main/docs/progressive-discovery.md) to minimize the number of tokens consumed (hence the cost incurred) while preserving the superb response quality when the MCP server is invoked. You can learn more about this technique [here](https://github.com/alphavantage/alpha_vantage_mcp/blob/main/docs/progressive-discovery.md)\n\n⭐ View MCP source code on [Github](https://github.com/alphavantage/alpha_vantage_mcp)\n\n👉 Any questions? Please contact support@alphavantage.co\n\n \n\n### Connection Examples\n\n**Remote Server Connection:**\n```\nhttps://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY\n```\n\n**Local Server Connection:**\n```\nuvx marketdata-mcp-server YOUR_API_KEY\n```\n\n \n\n### Setup Instructions by Use Case\n\n💬📊 _Power your chatbot with financial data_\n\n\n

Install in Claude

\n\n**Requirements:**\n- Claude Pro account (or higher tier)\n \n#### Claude Remote Server Connection\n\nTo connect Claude (Web or Desktop) to this MCP server:\n\n📺 Watch the **setup tutorial** - Click the image below to watch a step-by-step video guide:\n\n[![Alpha Vantage MCP Setup Tutorial](https://img.youtube.com/vi/W69x2qJcYmI/maxresdefault.jpg)](https://www.youtube.com/watch?v=W69x2qJcYmI)\n\n\n📺 Already have your Alpha Vantage MCP server set up? Below are a few examples of Claude performing various stock analysis & charting tasks:\n\n[![Alpha Vantage MCP Example Prompts](https://img.youtube.com/vi/tyl9E7fddvU/maxresdefault.jpg)](https://www.youtube.com/watch?v=tyl9E7fddvU)\n\n**Query Param Option (Recommended):**\n1. Go to [claude.ai/settings/connectors](https://claude.ai/settings/connectors) (Web) or Settings → Connectors (Desktop)\n2. Click \"Add Custom Connector\"\n3. 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)\n4. Click \"Connect\"\n\n**OAuth Option:**\n1. Go to [claude.ai/settings/connectors](https://claude.ai/settings/connectors) (Web) or Settings → Connectors (Desktop)\n2. Click \"Add Custom Connector\"\n3. Add the MCP server URL: `https://mcp.alphavantage.co/mcp`\n4. Click \"Connect\"\n5. Enter your Alpha Vantage API token\n6. Click \"Authorize Access\"\n\n#### Claude Local Server Connection\nSee [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) for more info.\n\nInstall `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nOpen Claude Desktop developer settings and edit your `claude_desktop_config.json` file to add the following configuration:\n\n```json\n{\n \"mcpServers\": {\n \"alphavantage\": {\n \"command\": \"uvx\",\n \"args\": [\"marketdata-mcp-server\", \"YOUR_API_KEY\"]\n }\n }\n}\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n

\n\n\n

Install in ChatGPT

\n\n**Requirements:**\n- ChatGPT Plus account (or higher tier)\n- Developer mode enabled (beta feature) - see [OpenAI's Developer Mode documentation](https://platform.openai.com/docs/guides/developer-mode)\n\n📺 Watch the **setup tutorial** - Click the image below to watch a step-by-step video guide:\n\n[![Alpha Vantage MCP Setup Tutorial](https://img.youtube.com/vi/pY2nr3FWXs0/maxresdefault.jpg)](https://www.youtube.com/watch?v=pY2nr3FWXs0)\n\n\n📺 Already have your Alpha Vantage MCP server set up? Below are a few examples of ChatGPT performing various stock analysis & charting tasks:\n\n[![Alpha Vantage MCP Example Prompts](https://img.youtube.com/vi/LBuHa8Ymw-0/maxresdefault.jpg)](https://www.youtube.com/watch?v=LBuHa8Ymw-0)\n\n**Setup:**\n1. Go to [ChatGPT Settings → Apps](https://chatgpt.com/#settings/Connectors)\n2. Click on **Advanced settings →** enable **Developer mode**\n3. Return to the **Apps** submenu, then click **Create app**.\n4. **MCP Server URL**: `https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY` (replace `YOUR_API_KEY` with your actual Alpha Vantage API key).\n5. **Authentication:** No authentication\n\n> **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.\n\n**Troubleshooting for ChatGPT Plus Accounts**\n\nWhile 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:\n\n1. **Confirm Connection**\n - Confirm the connection by prompting:\n ```\n List 3 functions available in Alpha Vantage MCP server.\n ```\n - You should see endpoints like `TIME_SERIES_DAILY` and `TIME_SERIES_INTRADAY`.\n\n2. **Force JSON Passthrough with simple payload**\n - Use the following prompts in sequence to prime ChatGPT to surface the full payload:\n ```\n Run ADD_TWO_NUMBERS from Alpha Vantage MCP Server using 3 and 6, and then show the JSON response.\n ```\n - If successful, ChatGPT should ask you to **Confirm** or **Deny** the call. Click **Confirm**.\n - If it doesn't, use the 🔄 \"Try Again...\" button and see if you get the **Confirm**/**Deny** prompt.\n - 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.\n ```\n Why aren't you receiving a JSON response?\n ```\n - Then, regardless of the response, prompt ChatGPT\n ```\n Explicitly request a return value from the tool response to verify what the server outputs.\n ```\n - Typically, this gets ChatGPT to ask you to **Confirm** or **Deny** the call. Click **Confirm**.\n - Sometimes, ChatGPT will insist it has no active connection to Alpha Vantage MCP Server. Just tell it to \"try again\".\n - If payloads still fail to appear, start a New Chat and try Step #2 again.\n\n3. **Force JSON Passthrough with large payload**\n - Once step #2 has been successful, repeat step #2 with the larger call:\n ```\n Run TIME_SERIES_DAILY using NVDA, and then show the JSON response.\n ```\n - Use the fallback steps from Step #2 if ChatGPT does not ask you to **Confirm** or **Deny** the call.\n - 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.\n \n

\n\n

Install in Grok

\n\n**Requirements:**\n- SuperGrok (or higher tier)\n\n**Setup:**\n1. Click the `+` button → **Connectors** → **Add connector** → **Custom**\n2. **Name**: Alpha Vantage MCP Server (or whatever you prefer)\n3. **Server URL**: `https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY` (replace `YOUR_API_KEY` with your actual Alpha Vantage API key).\n4. Click **Add Connector**\n \n

\n\n \n\n🤖📈 _Create agentic workflows for quantitative investing_\n\n

Install in 🦞OpenClaw🦞

\n\n**Requirements:**\n- Mac with Apple Silicon (or dedicated Mac mini)\n- LLM API Key (OpenAI used in demo)\n- Messaging Platform Bot Token (Telegram used in demo)\n\n📺 Watch the **setup tutorial** (click image below)\n\n[![This AI Agent Tracks Stocks 24/7 (OpenClaw Setup Tutorial)](https://i3.ytimg.com/vi/Z6DjYKN4uos/maxresdefault.jpg)](https://www.youtube.com/watch?v=Z6DjYKN4uos)\n\n- [View the detailed installation guide from GitHub Gist](https://gist.github.com/gabriel1l/2e6ebe57e9a17983aa8596fd7c5bcdc7)\n- For additional support links, please check the video description on YouTube.\n\n

\n\n

Configure in OpenAI Agent Builder

\n\n**Requirements:**\n- OpenAI account with [access to Agent Builder](https://platform.openai.com/docs/guides/agents) (e.g., billing details added, organization verified)\n\n📺 Watch the **setup tutorial**. (Click image below.)\n\n[![Configure Alpha Vantage MCP Server + OpenAI Agent Builder](http://i3.ytimg.com/vi/2Rsvzjn8hwE/hqdefault.jpg)](https://www.youtube.com/watch?v=2Rsvzjn8hwE)\n\n\n#### OpenAI Agent Builder Connection\n\nTo connect OpenAI Agent Builder to this MCP server:\n\n1. 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.\n2. Find the Tools section of the agent and click the + button to add a new tool\n3. Select MCP Server\n4. Click \"+ Server\" in the upper right of the \"Add MCP server\" menu\n5. Configure the MCP server with the following settings:\n - URL: `https://mcp.alphavantage.co/mcp`\n - Label: `Alpha Vantage MCP Server` (or any name you prefer)\n - Description: `Financial market data and technical indicators` (or any description you prefer)\n - Authentication: Select \"Access token / API key\" (should be default)\n - Access Token: Enter your Alpha Vantage API key\n6. Click Connect\n7. If successful, the next prompt will display all the tools. Scroll to the bottom and click Add.\n\n**Recommended Agent Instructions:**\n\nAdd the following instruction to your agent's configuration to optimize performance:\n\n```\nYou are a helpful financial agent with access to market data through Alpha Vantage MCP Server.\n\nIMPORTANT: Alpha Vantage functions are accessed via wrapper tools:\n- Use TOOL_LIST to see available functions (TIME_SERIES_DAILY, RSI, COMPANY_OVERVIEW, etc.)\n- Use TOOL_CALL with the format: TOOL_CALL(tool_name=\"FUNCTION_NAME\", arguments={...})\n- Example: TOOL_CALL(tool_name=\"TIME_SERIES_DAILY\", arguments={\"symbol\": \"AAPL\", \"outputsize\": \"compact\"})\n```\n

\n\n

Install in OpenAI Agents SDK

\n\nTo 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:\n\n- Interactive financial analysis agent\n- Session management for conversation continuity\n- Real-time tool execution with Alpha Vantage data\n- Support for both HTTP and stdio MCP connections\n\nThe example includes a complete setup guide and configuration templates.\n\n

\n\n

Configure in Microsoft Foundry Agent Service

\n\n**Requirements:**\n- Azure subscription with access to [Azure AI Foundry](https://ai.azure.com)\n\n#### Microsoft Foundry Agent Service Connection\n\nTo connect a Foundry agent to this MCP server:\n\n1. Open your agent (or Create Agent from Home Dashboard) in Azure AI Foundry's Agent playground or Agent designer.\n2. 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**\n3. Configure the MCP server with the following settings:\n - Unauthenticated (recommended):\n - Server label: `alpha-vantage-mcp-server` (or any name you prefer)\n - Server URL: `https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY`\n - Replace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n - Authentication: Select **Unauthenticated**\n - Key-based authentication (alternative):\n - Server label: `alpha-vantage-mcp-server` (or any name you prefer)\n - Server URL: `https://mcp.alphavantage.co/mcp`\n - Authentication: Select **Key-based authentication**\n - Credential\n - Click \"Add key value pair\"\n - Key: `apikey`\n - Value: Enter your Alpha Vantage API key\n4. Click **Connect**\n\n**Recommended Agent Instructions:**\n\nAdd the following instruction to your agent's system prompt to optimize performance:\n\n```\nYou are a helpful financial agent with access to market data through Alpha Vantage MCP Server.\nIMPORTANT: Alpha Vantage functions are accessed via wrapper tools:\n\nUse TOOL_LIST to see available functions (TIME_SERIES_DAILY, RSI, COMPANY_OVERVIEW, etc.)\nUse TOOL_GET to retrieve the schema for a specific function before calling it\nUse TOOL_CALL with the format: TOOL_CALL(tool_name=\"FUNCTION_NAME\", arguments={...})\nExample: TOOL_CALL(tool_name=\"TIME_SERIES_DAILY\", arguments={\"symbol\": \"IBM\", \"outputsize\": \"compact\"})\n\nAlways use Alpha Vantage MCP Server for market data queries. Do not answer from prior knowledge or web search.\n```\n

\n\n \n\n💻💵 _Code up fintech apps_\n\n

Install in OpenAI Codex

\n\n**Requirements:**\n- ChatGPT Plus account (or higher tier)\n\nSee [OpenAI Codex](https://github.com/openai/codex) for more information.\n\n📺 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.\n\n[![Alpha Vantage MCP + Codex Tutorial](http://i3.ytimg.com/vi/8exfs5wpTU0/hqdefault.jpg)](https://www.youtube.com/watch?v=8exfs5wpTU0)\n\n- [Download the companion .md file from Github Gist.](https://tinyurl.com/7uwdd6ud)\n- For additional support links, please check the video description on YouTube.\n\nInstall `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nInstall **Codex CLI v0.34 or later** to avoid compatibility issues.\n\n```bash\n# Install (if not already installed)\nnpm install -g @openai/codex\n\n# Or update to the latest version\nnpm update -g @openai/codex\n\n# Verify installation and version\ncodex --version\n```\n\nAdd the following configuration to your Codex MCP server settings by editing `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.alphavantage]\ncommand = \"uvx\"\nargs = [\"marketdata-mcp-server\", \"YOUR_API_KEY\"]\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\nRun `codex` in your terminal from your project directory. First-time users will be guided through additional prompts.\n\nThen connect with:\n```\n/mcp\n```\n\n

\n\n

Install in Claude Code

\n\n **Requirements:**\n- Claude Pro account (or higher tier)\n \nSee [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) for more information.\n\nRun one of the following commands, depending on whether you’re connecting remotely or running the server locally.\n\n#### Claude Code Remote Server Connection\n\n```bash\nclaude mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n#### Claude Code Local Server Connection\n\nFirst, install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nThen run:\n\n```bash\nclaude mcp add alphavantage -- uvx marketdata-mcp-server YOUR_API_KEY\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\nRun `claude` in your terminal from your project directory.\n\nThen connect with:\n```\n/mcp\n```\n\n

\n\n\n

Install in VS Code (Visual Studio Code)

\n\nSee [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more info.\n\nCreate `.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.\n\n#### VS Code Remote Server Connection\n\nPaste the following into `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"alphavantage\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY\"\n }\n }\n}\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n#### VS Code Local Server Connection\n\nFirst, install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nThen, paste the following into `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"alphavantage\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\"marketdata-mcp-server\", \"YOUR_API_KEY\"]\n }\n }\n}\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\nOpen the Chat view and select Agent mode\n\n

\n\n

\n \n

Install in Continue (Extension for VS Code, JetBrains)

\n\nSee [Continue MCP docs](https://docs.continue.dev/customize/deep-dives/mcp) for more information. Continue uses its own configuration format (not VS Code's mcp.json).\n\nCreate `.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)\n\n#### Continue Remote Server Connection\n\nPaste the following into `.continue/mcpServers/alphavantage.yaml`:\n\n```yaml\nname: Alpha Vantage MCP Server\nversion: 1.0\nschema: v1\nmcpServers:\n - name: alphavantage\n type: streamable-http\n url: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n#### Continue Local Server Connection\n\nFirst, install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nThen, paste the following into `.continue/mcpServers/alphavantage.yaml`:\n\n```yaml\nname: Alpha Vantage MCP Server\nversion: 1.0\nschema: v1\nmcpServers:\n - name: alphavantage\n type: stdio\n command: uvx\n args:\n - marketdata-mcp-server\n - YOUR_API_KEY\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\nOpen the Continue panel and select Agent mode. Set up your LLM provider.\n

\n\n

Install in Cursor

\n\nSee [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) for more information.\n\nPaste 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. \n\n#### Cursor Remote Server Connection\n\nConfigure Cursor by editing `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"alphavantage\": {\n \"url\": \"https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY\"\n }\n }\n}\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n#### Cursor Local Server Connection\n\nFirst, install `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nThen, paste the following into your Cursor `~/.cursor/mcp.json` file:\n\n```json\n{\n \"mcpServers\": {\n \"alphavantage\": {\n \"command\": \"uvx\",\n \"args\": [\"marketdata-mcp-server\", \"YOUR_API_KEY\"]\n }\n }\n}\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n

\n\n\n

Install in Gemini CLI

\n\nSee [Gemini CLI Configuration](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html) for more information.\n\nRun one of the following commands, depending on whether you’re connecting remotely or running the server locally.\n\n**Gemini CLI Remote Server Connection (Recommended):**\n```bash\ngemini mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n**Gemini CLI Local Server Connection:**\n\nInstall `uv` (a [modern Python package](https://docs.astral.sh/uv/) and project manager):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nThen run:\n\n```bash\ngemini mcp add alphavantage uvx marketdata-mcp-server YOUR_API_KEY\n```\n\nReplace `YOUR_API_KEY` with your actual Alpha Vantage API key.\n\n**Manual Configuration:**\n1. Open the Gemini CLI settings file. The location is `~/.gemini/settings.json` (where `~` is your home directory).\n2. Add the following to the `mcpServers` object in your `settings.json` file (replace `YOUR_API_KEY` with your actual Alpha Vantage API key):\n\n```json\n{\n \"mcpServers\": {\n \"alphavantage\": {\n \"httpUrl\": \"https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY\"\n }\n }\n}\n```\n\nOr, for a local server (replace `YOUR_API_KEY` with your actual Alpha Vantage API key):\n\n```json\n{\n \"mcpServers\": {\n \"alphavantage\": {\n \"command\": \"uvx\",\n \"args\": [\"marketdata-mcp-server\", \"YOUR_API_KEY\"]\n }\n }\n}\n```\n\nIf the `mcpServers` object does not exist, create it.\n\n

\n\n \n\n💡💡 _I'm just exploring_\n\nJust exploring what to build? Check out the [Trading Agents stock research tool](https://trading-agents.ai/) (#1 trending on Github), which is powered by Alpha Vantage market data with no setup required. \n\n \n\n## Examples\n\nBelow are four example prompts and Claude's expected responses when using the MCP server.\n\n \n\n### 1. Fetch and display structured market data across assets\n\n**Prompt:** “Give me last week’s OHLCV data for IBM”\n\nExpected Behavior:\n- Claude will use progressive discovery to find and invoke the correct tool, in this case the TIME_SERIES_DAILY function.\n- Claude will make the necessary request to the TIME_SERIES_DAILY function and receive the relevant response.\n- Claude will then respond directly in the chat interface with both text and image content:\n\nHere's IBM's OHLCV data for last week (March 16–20, 2026):\n\n $\"IBM_price\"$ \n\n \n\nIBM 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.\n\n \n\n### 2. Use technical indicators and price data to conduct technical analysis\n\n**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”\n\nExpected Behavior: \n- Claude will use progressive discovery to find and invoke the correct tools, in this case the TIME_SERIES_INTRADAY function and the RSI function.\n- 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.\n- Claude will then make an HTML artifact with the requested visualizations:\n \n \n\n $\"NVDA_RSI\"$ \n\n \n\n### 3. Visualize fundamental data\n\n**Prompt:** “Help me visualize AAPL’s earnings surprise trends for the past 4 quarters. Compare actual EPS to analyst estimates”\n\nExpected Behavior:\n- Claude will use progressive discovery to find and invoke the correct tool, in this case the EARNINGS function.\n- Claude will make the necessary request to the EARNINGS function and receive the relevant response.\n- Claude will do any necessary calculations on top of the returned data, and create an HTML artifact:\n\n $\"AAPL_earnings\"$ \n\n \n\n### 4. Compare performance across asset classes\n\n**Prompt:** “Compare gold, silver, and Bitcoin performance over the past 5 years”\n\nExpected Behavior: \n- Claude will use progressive discovery to find and invoke the correct tools, in this case the TIME_SERIES_MONTHLY function and the DIGITAL_CURRENCY_MONTHLY function.\n- 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.\n- Claude will do any necessary calculations on top of the returned data, and create an HTML artifact:\n\n $\"Commodity_price\"$ \n\n \n\n## Tools Reference\n\n**Note:** The tools listed below are accessed through the MCP server's `TOOL_CALL` wrapper function.\n\n| Category | Tools |\n|----------|-------|\n| 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` |\n| options_data_apis | `REALTIME_OPTIONS`, `REALTIME_OPTIONS_FMV`, `HISTORICAL_OPTIONS` |\n| alpha_intelligence | `NEWS_SENTIMENT`, `EARNINGS_CALL_TRANSCRIPT`, `TOP_GAINERS_LOSERS`, `INSIDER_TRANSACTIONS`, `INSTITUTIONAL_HOLDINGS`, `ANALYTICS_FIXED_WINDOW`, `ANALYTICS_SLIDING_WINDOW` |\n| fundamental_data | `COMPANY_OVERVIEW`, `INCOME_STATEMENT`, `BALANCE_SHEET`, `CASH_FLOW`, `EARNINGS`, `LISTING_STATUS`, `EARNINGS_CALENDAR`, `IPO_CALENDAR` |\n| forex | `FX_INTRADAY`, `FX_DAILY`, `FX_WEEKLY`, `FX_MONTHLY` |\n| cryptocurrencies | `CURRENCY_EXCHANGE_RATE`, `DIGITAL_CURRENCY_INTRADAY`, `DIGITAL_CURRENCY_DAILY`, `DIGITAL_CURRENCY_WEEKLY`, `DIGITAL_CURRENCY_MONTHLY` |\n| commodities | `WTI`, `BRENT`, `NATURAL_GAS`, `COPPER`, `ALUMINUM`, `WHEAT`, `CORN`, `COTTON`, `SUGAR`, `COFFEE`, `GOLD_SILVER_SPOT`, `GOLD_SILVER_HISTORY`, `ALL_COMMODITIES` |\n| economic_indicators | `REAL_GDP`, `REAL_GDP_PER_CAPITA`, `TREASURY_YIELD`, `FEDERAL_FUNDS_RATE`, `CPI`, `INFLATION`, `RETAIL_SALES`, `DURABLES`, `UNEMPLOYMENT`, `NONFARM_PAYROLL` |\n| 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` |\n| ping | `PING`, `ADD_TWO_NUMBERS` |\n\n \n\n### Table of Contents - API Tools\n- [core_stock_apis](#core_stock_apis)\n- [options_data_apis](#options_data_apis)\n- [alpha_intelligence](#alpha_intelligence)\n- [fundamental_data](#fundamental_data)\n- [forex](#forex)\n- [cryptocurrencies](#cryptocurrencies)\n- [commodities](#commodities)\n- [economic_indicators](#economic_indicators)\n- [technical_indicators](#technical_indicators)\n- [ping](#ping)\n\n💡 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](https://www.alphavantage.co/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](https://medium.com/alpha-vantage/best-stock-market-apis-in-2026-e8a982b1ea0c).\n\n\n### CORE_STOCK_APIS\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| core_stock_apis | `TIME_SERIES_INTRADAY` | Current and 20+ years of historical intraday OHLCV data |\n| core_stock_apis | `TIME_SERIES_DAILY` | Daily time series (OHLCV) covering 20+ years |\n| core_stock_apis | `TIME_SERIES_DAILY_ADJUSTED` | Daily adjusted OHLCV with split/dividend events |\n| core_stock_apis | `TIME_SERIES_WEEKLY` | Weekly time series (last trading day of week) |\n| core_stock_apis | `TIME_SERIES_WEEKLY_ADJUSTED` | Weekly adjusted time series with dividends |\n| core_stock_apis | `TIME_SERIES_MONTHLY` | Monthly time series (last trading day of month) |\n| core_stock_apis | `TIME_SERIES_MONTHLY_ADJUSTED` | Monthly adjusted time series with dividends |\n| core_stock_apis | `GLOBAL_QUOTE` | Latest price and volume for a ticker |\n| core_stock_apis | `REALTIME_BULK_QUOTES` | Realtime quotes for up to 100 symbols |\n| core_stock_apis | `SYMBOL_SEARCH` | Search for symbols by keywords |\n| core_stock_apis | `MARKET_STATUS` | Current market status worldwide |\n\n### OPTIONS_DATA_APIS\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| options_data_apis | `REALTIME_OPTIONS` | Realtime US options data with Greeks |\n| options_data_apis | `REALTIME_OPTIONS_FMV` | Realtime US options FMV (fair market value) mark prices |\n| options_data_apis | `HISTORICAL_OPTIONS` | Historical options chain for 15+ years |\n\n### ALPHA_INTELLIGENCE\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| alpha_intelligence | `NEWS_SENTIMENT` | Live and historical market news & sentiment |\n| alpha_intelligence | `EARNINGS_CALL_TRANSCRIPT` | Earnings call transcripts with LLM sentiment |\n| alpha_intelligence | `TOP_GAINERS_LOSERS` | Top 20 gainers, losers, and most active |\n| alpha_intelligence | `INSIDER_TRANSACTIONS` | Latest and historical insider transactions |\n| alpha_intelligence | `INSTITUTIONAL_HOLDINGS` | Institutional ownership and holdings information |\n| alpha_intelligence | `ANALYTICS_FIXED_WINDOW` | Advanced analytics over fixed windows |\n| alpha_intelligence | `ANALYTICS_SLIDING_WINDOW` | Advanced analytics over sliding windows |\n\n### FUNDAMENTAL_DATA\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| fundamental_data | `COMPANY_OVERVIEW` | Company information, financial ratios, and metrics |\n| fundamental_data | `INCOME_STATEMENT` | Annual and quarterly income statements |\n| fundamental_data | `BALANCE_SHEET` | Annual and quarterly balance sheets |\n| fundamental_data | `CASH_FLOW` | Annual and quarterly cash flow statements |\n| fundamental_data | `EARNINGS` | Annual and quarterly earnings data |\n| fundamental_data | `LISTING_STATUS` | Listing and delisting data for equities |\n| fundamental_data | `EARNINGS_CALENDAR` | Earnings calendar for upcoming earnings |\n| fundamental_data | `IPO_CALENDAR` | Initial public offering calendar |\n\n### FOREX\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| forex | `FX_INTRADAY` | Intraday foreign exchange rates |\n| forex | `FX_DAILY` | Daily foreign exchange rates |\n| forex | `FX_WEEKLY` | Weekly foreign exchange rates |\n| forex | `FX_MONTHLY` | Monthly foreign exchange rates |\n\n### CRYPTOCURRENCIES\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| cryptocurrencies | `CURRENCY_EXCHANGE_RATE` | Exchange rate between digital/crypto currencies |\n| cryptocurrencies | `DIGITAL_CURRENCY_INTRADAY` | Intraday time series for digital currencies |\n| cryptocurrencies | `DIGITAL_CURRENCY_DAILY` | Daily time series for digital currencies |\n| cryptocurrencies | `DIGITAL_CURRENCY_WEEKLY` | Weekly time series for digital currencies |\n| cryptocurrencies | `DIGITAL_CURRENCY_MONTHLY` | Monthly time series for digital currencies |\n\n### COMMODITIES\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| commodities | `WTI` | West Texas Intermediate (WTI) crude oil prices |\n| commodities | `BRENT` | Brent crude oil prices |\n| commodities | `NATURAL_GAS` | Henry Hub natural gas spot prices |\n| commodities | `COPPER` | Global copper prices |\n| commodities | `ALUMINUM` | Global aluminum prices |\n| commodities | `WHEAT` | Global wheat prices |\n| commodities | `CORN` | Global corn prices |\n| commodities | `COTTON` | Global cotton prices |\n| commodities | `SUGAR` | Global sugar prices |\n| commodities | `COFFEE` | Global coffee prices |\n| commodities | `GOLD_SILVER_SPOT` | Live spot prices for gold and silver |\n| commodities | `GOLD_SILVER_HISTORY` | Historical gold and silver prices (daily, weekly, monthly) |\n| commodities | `ALL_COMMODITIES` | All commodities prices |\n\n### ECONOMIC_INDICATORS\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| economic_indicators | `REAL_GDP` | Real Gross Domestic Product |\n| economic_indicators | `REAL_GDP_PER_CAPITA` | Real GDP per capita |\n| economic_indicators | `TREASURY_YIELD` | Daily treasury yield rates |\n| economic_indicators | `FEDERAL_FUNDS_RATE` | Federal funds rate (interest rates) |\n| economic_indicators | `CPI` | Consumer Price Index |\n| economic_indicators | `INFLATION` | Inflation rates |\n| economic_indicators | `RETAIL_SALES` | Retail sales data |\n| economic_indicators | `DURABLES` | Durable goods orders |\n| economic_indicators | `UNEMPLOYMENT` | Unemployment rate |\n| economic_indicators | `NONFARM_PAYROLL` | Non-farm payroll data |\n\n### TECHNICAL_INDICATORS\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| technical_indicators | `SMA` | Simple moving average (SMA) values |\n| technical_indicators | `EMA` | Exponential moving average (EMA) values |\n| technical_indicators | `WMA` | Weighted moving average (WMA) values |\n| technical_indicators | `DEMA` | Double exponential moving average (DEMA) values |\n| technical_indicators | `TEMA` | Triple exponential moving average (TEMA) values |\n| technical_indicators | `TRIMA` | Triangular moving average (TRIMA) values |\n| technical_indicators | `KAMA` | Kaufman adaptive moving average (KAMA) values |\n| technical_indicators | `MAMA` | MESA adaptive moving average (MAMA) values |\n| technical_indicators | `VWAP` | Volume weighted average price (VWAP) for intraday time series |\n| technical_indicators | `T3` | Triple exponential moving average (T3) values |\n| technical_indicators | `MACD` | Moving average convergence / divergence (MACD) values |\n| technical_indicators | `MACDEXT` | Moving average convergence / divergence values with controllable moving average type |\n| technical_indicators | `STOCH` | Stochastic oscillator (STOCH) values |\n| technical_indicators | `STOCHF` | Stochastic fast (STOCHF) values |\n| technical_indicators | `RSI` | Relative strength index (RSI) values |\n| technical_indicators | `STOCHRSI` | Stochastic relative strength index (STOCHRSI) values |\n| technical_indicators | `WILLR` | Williams' %R (WILLR) values |\n| technical_indicators | `ADX` | Average directional movement index (ADX) values |\n| technical_indicators | `ADXR` | Average directional movement index rating (ADXR) values |\n| technical_indicators | `APO` | Absolute price oscillator (APO) values |\n| technical_indicators | `PPO` | Percentage price oscillator (PPO) values |\n| technical_indicators | `MOM` | Momentum (MOM) values |\n| technical_indicators | `BOP` | Balance of power (BOP) values |\n| technical_indicators | `CCI` | Commodity channel index (CCI) values |\n| technical_indicators | `CMO` | Chande momentum oscillator (CMO) values |\n| technical_indicators | `ROC` | Rate of change (ROC) values |\n| technical_indicators | `ROCR` | Rate of change ratio (ROCR) values |\n| technical_indicators | `AROON` | Aroon (AROON) values |\n| technical_indicators | `AROONOSC` | Aroon oscillator (AROONOSC) values |\n| technical_indicators | `MFI` | Money flow index (MFI) values |\n| technical_indicators | `TRIX` | 1-day rate of change of a triple smooth exponential moving average (TRIX) values |\n| technical_indicators | `ULTOSC` | Ultimate oscillator (ULTOSC) values |\n| technical_indicators | `DX` | Directional movement index (DX) values |\n| technical_indicators | `MINUS_DI` | Minus directional indicator (MINUS_DI) values |\n| technical_indicators | `PLUS_DI` | Plus directional indicator (PLUS_DI) values |\n| technical_indicators | `MINUS_DM` | Minus directional movement (MINUS_DM) values |\n| technical_indicators | `PLUS_DM` | Plus directional movement (PLUS_DM) values |\n| technical_indicators | `BBANDS` | Bollinger bands (BBANDS) values |\n| technical_indicators | `MIDPOINT` | Midpoint values - (highest value + lowest value)/2 |\n| technical_indicators | `MIDPRICE` | Midpoint price values - (highest high + lowest low)/2 |\n| technical_indicators | `SAR` | Parabolic SAR (SAR) values |\n| technical_indicators | `TRANGE` | True range (TRANGE) values |\n| technical_indicators | `ATR` | Average true range (ATR) values |\n| technical_indicators | `NATR` | Normalized average true range (NATR) values |\n| technical_indicators | `AD` | Chaikin A/D line (AD) values |\n| technical_indicators | `ADOSC` | Chaikin A/D oscillator (ADOSC) values |\n| technical_indicators | `OBV` | On balance volume (OBV) values |\n| technical_indicators | `HT_TRENDLINE` | Hilbert transform, instantaneous trendline (HT_TRENDLINE) values |\n| technical_indicators | `HT_SINE` | Hilbert transform, sine wave (HT_SINE) values |\n| technical_indicators | `HT_TRENDMODE` | Hilbert transform, trend vs cycle mode (HT_TRENDMODE) values |\n| technical_indicators | `HT_DCPERIOD` | Hilbert transform, dominant cycle period (HT_DCPERIOD) values |\n| technical_indicators | `HT_DCPHASE` | Hilbert transform, dominant cycle phase (HT_DCPHASE) values |\n| technical_indicators | `HT_PHASOR` | Hilbert transform, phasor components (HT_PHASOR) values |\n\n### PING\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| ping | `PING` | Health check tool that returns 'pong' |\n| ping | `ADD_TWO_NUMBERS` | Example tool for adding two numbers |\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Data & Analytics","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[],"license","MIT","language","Python","registryName","io.github.alphavantage/alpha_vantage_mcp","homepage","https://mcp.alphavantage.co","ENV",{"_107":108,"_109":110,"_111":112},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]