Alpha Vantage

v1.0.0Finance & Fintechstable

Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

alpha-vantagemcpai-integration
Share:
151
Stars
0
Downloads
0
Weekly
0/5

What is Alpha Vantage?

Alpha Vantage is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Real-time financial market data: stocks, forex, crypto, comm

Use Cases

Access real-time financial market data
Query stock, forex, and cryptocurrency prices
Analyze commodities and economic indicators
alphavantage

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y alpha-vantage

Manual Installation

npx -y alpha-vantage

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Alpha Vantage

Alpha Vantage MCP Server connects AI assistants to the Alpha Vantage financial data platform, exposing over 99 tools covering real-time stock quotes, intraday and historical time series, 60+ technical indicators, company fundamentals, options chains, forex, cryptocurrencies, commodities, economic indicators, and news sentiment. Investors, analysts, and developers use it to ask natural language questions about market data and receive structured, up-to-date financial information directly in their AI conversations without leaving the chat interface.

Prerequisites

  • A free or premium Alpha Vantage API key (obtain at https://www.alphavantage.co/support/#api-key)
  • uv installed for local usage (`curl -LsSf https://astral.sh/uv/install.sh | sh`), or just a web browser for the remote HTTP endpoint
  • Claude Desktop, Claude Code, VS Code, or Cursor as your MCP client
1

Get an Alpha Vantage API key

Visit https://www.alphavantage.co/support/#api-key to register for a free API key. Free keys allow up to 25 requests per day; premium plans support higher rate limits and more endpoints.

2

Choose remote or local connection

You can connect to Alpha Vantage's hosted remote MCP endpoint (no local install) or run the server locally with uvx. The remote endpoint is simpler; the local option gives more control.

3

Configure for Claude Code (remote)

Add the remote Alpha Vantage MCP endpoint directly in Claude Code. Replace YOUR_API_KEY with your actual key.

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

Configure for Claude Code (local)

Alternatively, run the server locally using uvx with your API key passed as an argument.

claude mcp add alphavantage -- uvx marketdata-mcp-server YOUR_API_KEY
5

Configure Claude Desktop

For Claude Desktop, add an entry to claude_desktop_config.json using the local uvx method.

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

Alpha Vantage Examples

Client configuration

Claude Desktop config using uvx to run the Alpha Vantage MCP server locally with your API key.

{
  "mcpServers": {
    "alphavantage": {
      "command": "uvx",
      "args": ["marketdata-mcp-server", "YOUR_ALPHA_VANTAGE_API_KEY"]
    }
  }
}

Prompts to try

These prompts match the actual capabilities of the 99+ tools exposed by the Alpha Vantage MCP server.

- "Give me last week's OHLCV data for IBM."
- "Get NVDA's hourly price data for the last two days and compute the RSI."
- "Help me visualize AAPL's earnings surprise trends for the past 4 quarters."
- "Compare gold, silver, and Bitcoin performance over the past 5 years."
- "What is the current USD/EUR exchange rate and its 30-day trend?"
- "Show me the top market gainers and losers today."
- "What is the current 10-year US Treasury yield?"

Troubleshooting Alpha Vantage

API returns 'Thank you for using Alpha Vantage! Our standard API call frequency is 25 requests per day'

You have hit the free tier daily limit of 25 requests. Upgrade to a premium Alpha Vantage plan for higher rate limits, or wait until the next UTC day for the counter to reset.

Tool call returns empty data or 'Invalid API call' for a valid symbol

Confirm the ticker symbol is correct (Alpha Vantage uses US exchange symbols by default). For non-US stocks, append the exchange suffix (e.g., `TSM` for NYSE-listed TSM, `7203.T` for Tokyo-listed Toyota). Also verify your API key is active.

uvx cannot find 'marketdata-mcp-server' package

Ensure uv is installed and up to date (`uv self update`). The package name is `marketdata-mcp-server` on PyPI. You can also test directly with `uvx marketdata-mcp-server YOUR_API_KEY` in your terminal before adding it to the config.

Frequently Asked Questions about Alpha Vantage

What is Alpha Vantage?

Alpha Vantage is a Model Context Protocol (MCP) server that real-time financial market data: stocks, forex, crypto, commodities, and economic indicators It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Alpha Vantage?

Install via npm with the command: npx -y alpha-vantage. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Alpha Vantage?

Alpha Vantage works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Alpha Vantage free to use?

Yes, Alpha Vantage is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "alpha-vantage": { "command": "npx", "args": ["-y", "alpha-vantage"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Alpha Vantage?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides