Vercel MCP Server (remote)
OfficialVercel's hosted OAuth server for inspecting projects, deployments, and logs from your AI client.
Add to your client
Copy the config for your MCP client and paste it into its config file.
Add remote MCP server URL https://mcp.vercel.com in your clientPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"vercel-mcp-server-remote": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.vercel.com"
]
}
}
}Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.
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
About Vercel MCP Server (remote)
Vercel MCP is Vercel's official remote MCP server, hosted at https://mcp.vercel.com. Instead of running a local binary, your AI client connects over Streamable HTTP and authenticates with OAuth, granting the agent the same access as your Vercel user account. It implements the current MCP Authorization and Streamable HTTP specs.
The server exposes tools to search Vercel documentation, manage teams and projects, inspect deployments, read build and runtime logs (to debug failures), manage domains, create shareable links for protected deployments, and act on Vercel Toolbar comment threads. A subset of tools (documentation search) is public; the rest require authentication.
For security, Vercel only allows connections from a reviewed list of AI clients (Claude Code, Claude.ai/Desktop, ChatGPT, Codex CLI, Cursor, VS Code Copilot, Devin, Raycast, Goose, Windsurf, Gemini). It protects against confused-deputy attacks by requiring explicit per-client consent, and recommends keeping human confirmation enabled for tool execution.
Tools & capabilities (12)
search_documentationSearch Vercel docs by topic (public, no auth required)
list_teamsList teams the authenticated user belongs to
list_projects / get_projectList projects and get framework, domains, and latest deployment for one
list_deployments / get_deploymentList a project's deployments and inspect build status, regions, and metadata
get_deployment_build_logsRead a deployment's build logs to debug failures
get_runtime_logsQuery Vercel Functions runtime logs with filters (level, status, time, full-text)
check_domain_availability_and_price / buy_domainCheck domain availability/pricing and purchase a domain
get_access_to_vercel_urlCreate a temporary shareable link to a protected deployment
web_fetch_vercel_urlFetch content from a Vercel deployment URL, with auth if protected
list_toolbar_threads / get_toolbar_thread / reply_to_toolbar_thread / change_toolbar_thread_resolve_statusRead and act on Vercel Toolbar comment threads
deploy_to_vercelDeploy the current project to Vercel
use_vercel_cliGuide the agent to run the appropriate Vercel CLI command
When to use it
- Use it when a deployment failed and you want the agent to pull build logs and explain the cause
- Use it when debugging production errors via runtime logs filtered by level, status code, and time
- Use it when you need to list projects/deployments and check the status of the latest one
- Use it when you want an agent to answer Vercel questions from the official docs
- Use it when you need a shareable link to a protected preview, or to fetch content behind deployment protection
- Use it when triaging Vercel Toolbar comment threads from your AI client
Quick setup
- 1Pick a supported client (Claude Code, Cursor, VS Code Copilot, ChatGPT, etc.)
- 2Add the remote server URL https://mcp.vercel.com over HTTP transport (e.g. `claude mcp add --transport http vercel https://mcp.vercel.com`, or `npx add-mcp https://mcp.vercel.com`)
- 3Trigger the OAuth flow (e.g. run /mcp in Claude Code) and authorize the client in your browser
- 4Confirm you connected to the official endpoint mcp.vercel.com before approving
- 5Keep human confirmation enabled for tool execution
- 6Verify with a prompt like 'list my Vercel projects' or 'search the Vercel docs for custom domains'
Security notes
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) FAQ
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.
Can I use it without logging in?
Partly. Documentation search is a public tool; project, deployment, log, domain, and toolbar tools require authentication.
Is it safe to give an agent this access?
Vercel requires explicit per-client consent (confused-deputy protection) and recommends keeping human confirmation on. Be cautious mixing it with other MCP servers to avoid prompt-injection exfiltrating your logs or data.
Alternatives to Vercel MCP Server (remote)
GitHub's official server for repos, issues, PRs, and Actions — local Docker or hosted remote.
Official AWS Labs server that lets agents call any AWS API via the AWS CLI surface.
Grafana's official server for dashboards, Prometheus/Loki queries, alerts, and incidents.
Compare Vercel MCP Server (remote) with: