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 support@alphavantage.co
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
Requirements:
- Any free or paid Claude account
📺 Watch the setup tutorial. (Click image below.)
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:
Claude Local Server Connection
See Claude Desktop MCP docs for more info.
Install uv (a modern Python package and project manager):
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:
{
"mcpServers": {
"alphavantage": {
"command": "uvx",
"args": ["marketdata-mcp-server", "YOUR_API_KEY"]
}
}
}
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
Requirements:
- Any free or paid ChatGPT account
📺 Watch the setup tutorial. (Click image below.)
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:
Give me last week's OHLCV data for IBM
📺 Below are a few examples of ChatGPT performing various stock analysis & charting tasks:
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 (replace YOUR_API_KEY with your actual Alpha Vantage API key).
- Click Add Connector
🤖📈 Agentic systems
Requirements:
📺 Watch the setup tutorial. (Click image below.)
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:
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.
Requirements:
- Hermes Agent installed with the
hermes CLI available
Hermes Remote Server Connection (Recommended, OAuth)
Add the server and start the authorization flow:
hermes mcp add alphavantage --url https://mcp.alphavantage.co/mcp --auth oauth
hermes mcp login alphavantage
Or configure it directly in config.yaml:
mcp_servers:
alphavantage:
url: https://mcp.alphavantage.co/mcp
auth: oauth
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 mcp test alphavantage
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:
mcp_servers:
alphavantage:
url: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY
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:
hermes mcp test alphavantage
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)
Requirements:
📺 Watch the setup tutorial. (Click image below.)
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
- 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:
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").
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
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):
curl -LsSf https://astral.sh/uv/install.sh | sh
Then run:
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
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:
Give me last week's OHLCV data for IBM
📺 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.
Codex Remote Server Connection via CLI (Alternative, OAuth)
Prefer the command line? Getting started is easy:
- Add the server by running:
codex mcp add alphavantage --url https://mcp.alphavantage.co/mcp
- Codex will open your browser. Enter your Alpha Vantage API key in the pop-up authentication page
- Click "Authorize Access"
- Run
codex from your project directory
- Verify the connection with:
/mcp
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:
Give me last week's OHLCV data for IBM
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:
{
"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 and project manager):
curl -LsSf https://astral.sh/uv/install.sh | sh
Then, paste the following into .vscode/mcp.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
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:
name: Alpha Vantage MCP Server
version: 1.0
schema: v1
mcpServers:
- name: alphavantage
type: streamable-http
url: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY
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):
curl -LsSf https://astral.sh/uv/install.sh | sh
Then, paste the following into .continue/mcpServers/alphavantage.yaml:
name: Alpha Vantage MCP Server
version: 1.0
schema: v1
mcpServers:
- name: 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 Continue panel and select Agent mode. Set up your LLM provider.
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:
{
"mcpServers": {
"alphavantage": {
"url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
}
}
}
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):
curl -LsSf https://astral.sh/uv/install.sh | sh
Then, paste the following into your Cursor ~/.cursor/mcp.json file:
{
"mcpServers": {
"alphavantage": {
"command": "uvx",
"args": ["marketdata-mcp-server", "YOUR_API_KEY"]
}
}
}
Replace YOUR_API_KEY with your actual Alpha Vantage API key.
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):
gemini 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.
Gemini CLI Local Server Connection:
Install uv (a modern Python package and project manager):
curl -LsSf https://astral.sh/uv/install.sh | sh
Then run:
gemini mcp add alphavantage uvx marketdata-mcp-server YOUR_API_KEY
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
mcpServers object in your settings.json file (replace YOUR_API_KEY with your actual Alpha Vantage API key):
{
"mcpServers": {
"alphavantage": {
"httpUrl": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
}
}
}
Or, for a local server (replace YOUR_API_KEY with your actual Alpha Vantage API key):
{
"mcpServers": {
"alphavantage": {
"command": "uvx",
"args": ["marketdata-mcp-server", "YOUR_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.