MCP Directory

How to add Alpha Vantage MCP (Remote) to Windsurf

Official Alpha Vantage remote server for stocks, crypto, forex, and technical indicators. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 170★ · http · apikey · official

Windsurf config for Alpha Vantage MCP (Remote)

Add remote MCP URL https://mcp.alphavantage.co/mcp?apikey=<your-api-key>
{
  "mcpServers": {
    "alpha-vantage-mcp-remote": {
      "serverUrl": "https://mcp.alphavantage.co/mcp?apikey=<your-alpha-vantage-api-key>"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Alpha Vantage MCP (Remote) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Alpha Vantage MCP (Remote)'s tools become available to Cascade.

Before you start

  • A free Alpha Vantage API key from https://www.alphavantage.co/support/#api-key (premium key recommended for higher rate limits)
  • For the remote server: any MCP client that supports HTTP/SSE transport — no local runtime needed
  • For the optional local server: Python with the uv/uvx toolchain installed

What Alpha Vantage MCP (Remote) can do in Windsurf

TIME_SERIES_INTRADAY / DAILY / WEEKLY / MONTHLY

Intraday and adjusted end-of-day OHLCV price series for equities.

GLOBAL_QUOTE / REALTIME_BULK_QUOTES

Latest price and volume for one or many symbols.

SYMBOL_SEARCH / MARKET_STATUS

Look up ticker symbols and check global market open/close status.

REALTIME_OPTIONS / HISTORICAL_OPTIONS

Live and historical options chains, including fair-value (FMV) pricing.

COMPANY_OVERVIEW / INCOME_STATEMENT / BALANCE_SHEET / CASH_FLOW / EARNINGS

Company fundamentals and financial statements.

NEWS_SENTIMENT / EARNINGS_CALL_TRANSCRIPT / TOP_GAINERS_LOSERS

Alpha Intelligence: news sentiment, transcripts, and market movers.

INSIDER_TRANSACTIONS / INSTITUTIONAL_HOLDINGS

Insider trades and institutional ownership data.

CURRENCY_EXCHANGE_RATE / FX series / DIGITAL_CURRENCY series

Forex rates and crypto/digital currency time series.

Security

Read-only financial data; the API key travels in the URL query string, so avoid logging or sharing the full endpoint. Free-tier daily call limits apply.

Alpha Vantage MCP (Remote) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Alpha Vantage MCP (Remote) config there under the "mcpServers" key and restart the client.

Is Alpha Vantage MCP (Remote) safe to use with Windsurf?

Read-only financial data; the API key travels in the URL query string, so avoid logging or sharing the full endpoint. Free-tier daily call limits apply.

Is this the official Alpha Vantage MCP server?

Yes. It is maintained by Alpha Vantage and exposes their full API surface over MCP.

How do I authenticate the remote server?

Pass your API key as a query parameter on the endpoint URL: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY.

Is there a free tier and what are the limits?

Yes, the free Alpha Vantage key works, but it is rate-limited (historically 25 requests/day and 5/minute). High-volume use requires a premium key.

View repo Full Alpha Vantage MCP (Remote) page