alphavantage/alpha_vantage_mcp

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:

📺 Already have your Alpha Vantage MCP server set up? Below are a few examples of Claude performing various stock analysis & charting tasks:

Query Param Option (Recommended):

1. Go to 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"

OAuth Option:

1. Go to 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 token
6. Click "Authorize Access"

Local Server Connection

Open Claude Desktop developer settings and edit your claude_desktop_config.json file to add the following configuration. See Claude Desktop MCP docs for more info.

{
  "mcpServers": {
    "alphavantage": {
      "command": "uvx",
      "args": ["av-mcp", "YOUR_API_KEY"]
    }
  }
}

Replace YOUR_API_KEY with your actual Alpha Vantage API key.

To connect ChatGPT to this MCP server using ChatGPT Developer mode:

Requirements:

• ChatGPT Pro or Plus account
• Developer mode enabled (beta feature) - see OpenAI's Developer Mode documentation

Setup:

1. Go to ChatGPT Settings → Connectors
2. Enable Advanced → Developer mode
3. Add a remote MCP server with URL: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY (replace YOUR_API_KEY with your actual Alpha Vantage API key)
4. In conversations, choose Developer mode from the Plus menu and select the Alpha Vantage connector

Note: While Developer mode is available for both Pro and Plus accounts, MCP tool execution is currently most reliable with Pro accounts. We're monitoring Plus plan functionality and will update this guide as improvements are made.

See OpenAI Codex for more information.

Add the following configuration to your Codex MCP server settings by editing ~/.codex/config.toml (replace YOUR_API_KEY with your actual Alpha Vantage API key):

[mcp_servers.alphavantage]
command = "uvx"
args = ["av-mcp", "YOUR_API_KEY"]

Run codex in your terminal from your project directory

Then connect with:

/mcp

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

VS Code Remote Server Connection

Create a .vscode/mcp.json file in your workspace and add this configuration (replace YOUR_API_KEY with your actual Alpha Vantage API key):

{
  "servers": {
    "alphavantage": {
      "type": "http",
      "url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

VS Code Local Server Connection

{
  "servers": {
    "alphavantage": {
      "type": "stdio",
      "command": "uvx",
      "args": ["av-mcp", "YOUR_API_KEY"]
    }
  }
}

Open the Chat view and select Agent mode

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

Cursor Remote Server Connection

Configure Cursor by editing ~/.cursor/mcp.json (replace YOUR_API_KEY with your actual Alpha Vantage API key):

{
  "mcpServers": {
    "alphavantage": {
      "url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

Cursor Local Server Connection

{
  "mcpServers": {
    "alphavantage": {
      "command": "uvx",
      "args": ["av-mcp", "YOUR_API_KEY"]
    }
  }
}

Replace YOUR_API_KEY with your actual Alpha Vantage API key.

Run this command. See Claude Code MCP docs for more info.

Claude Code Remote Server Connection

claude mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

Claude Code Local Server Connection

claude mcp add alphavantage -- uvx av-mcp 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

See Gemini CLI Configuration for details.

CLI Command (Recommended):

gemini mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

Local Server CLI Command:

gemini mcp add alphavantage uvx av-mcp YOUR_API_KEY

Manual Configuration:

1. Open the Gemini CLI settings file. The location is ~/.gemini/settings.json (where ~ is your home directory).
2. Add the following to the mcpServers object in your settings.json file:

{
  "mcpServers": {
    "alphavantage": {
      "httpUrl": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

Or, for a local server:

{
  "mcpServers": {
    "alphavantage": {
      "command": "uvx",
      "args": ["av-mcp", "YOUR_API_KEY"]
    }
  }
}

If the mcpServers object does not exist, create it.

Replace YOUR_API_KEY with your actual Alpha Vantage API key.

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.