How to add Vercel MCP Server (remote) to Windsurf

Vercel's hosted OAuth server for inspecting projects, deployments, and logs from your AI client. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 0★ · http · oauth · official

Windsurf config for Vercel MCP Server (remote)

Add remote MCP server URL https://mcp.vercel.com in your client

{
  "mcpServers": {
    "vercel-mcp-server-remote": {
      "serverUrl": "https://mcp.vercel.com"
    }
  }
}

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

Setup steps

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

Before you start

A Vercel account (the agent gets the same access as your logged-in user)
A supported, Vercel-reviewed MCP client (Claude Code, Claude.ai/Desktop on Pro/Max/Team/Enterprise, ChatGPT Plus/Pro, Codex CLI, Cursor, VS Code Copilot, Devin, Raycast, Goose, Windsurf, Gemini)
No local install or binary — it's a hosted remote server at https://mcp.vercel.com
OAuth authorization completed in the browser when the client first connects

What Vercel MCP Server (remote) can do in Windsurf

search_documentation

Search Vercel docs by topic (public, no auth required)

list_teams

List teams the authenticated user belongs to

list_projects / get_project

List projects and get framework, domains, and latest deployment for one

list_deployments / get_deployment

List a project's deployments and inspect build status, regions, and metadata

get_deployment_build_logs

Read a deployment's build logs to debug failures

get_runtime_logs

Query Vercel Functions runtime logs with filters (level, status, time, full-text)

check_domain_availability_and_price / buy_domain

Check domain availability/pricing and purchase a domain

get_access_to_vercel_url

Create a temporary shareable link to a protected deployment

Security

Access is OAuth-scoped and read-only by default, limiting blast radius, but it still exposes project, deployment, and log data for your account. Use the project-scoped URL form (https://mcp.vercel.com/<org>/<project>) to restrict a session to a single project.

Vercel MCP Server (remote) + Windsurf FAQ

Where is the Windsurf config file?

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

Is Vercel MCP Server (remote) safe to use with Windsurf?

Is it a local or remote server?

Remote and hosted by Vercel at https://mcp.vercel.com. You connect over Streamable HTTP with OAuth — there's no binary to install or run locally.

How do I authenticate?

Via OAuth. When your client first connects it opens a browser to authorize access; the agent then has the same access as your Vercel user account.

Which clients can connect?

Only Vercel-reviewed clients: Claude Code, Claude.ai/Desktop, ChatGPT, Codex CLI, Cursor, VS Code Copilot, Devin, Raycast, Goose, Windsurf, and Gemini. Note Claude.ai/ChatGPT custom connectors require paid plans.

View repo Full Vercel MCP Server (remote) page