vercel — Claude Code MCP server: deployments and logs
Manage Vercel deployments and inspect build or runtime logs from an AI coding agent. Useful when checking releases or tracing application failures.
claude mcp add --env VERCEL_TOKEN=<VERCEL_TOKEN> --env VERCEL_TEAM_ID=<VERCEL_TEAM_ID> --env VERCEL_TEAM_SLUG=<VERCEL_TEAM_SLUG> --env VERCEL_ENABLED_TOOLGROUPS=<VERCEL_ENABLED_TOOLGROUPS> --transport stdio vercel -- npx -y vercel-platform-mcp-serverWhat vercel does
This MCP server connects an agent to the Vercel REST API. It can list projects and deployments, inspect a deployment by ID or URL, read build events, and query runtime application logs with filters.
Tools are split into readonly and readwrite groups. Read-only access covers projects, deployments, and logs; write access adds deployment creation, cancellation, deletion, promotion, and rollback. Set VERCEL_ENABLED_TOOLGROUPS to control the groups, and use VERCEL_TEAM_ID or VERCEL_TEAM_SLUG for team-scoped operations.
You need a Vercel account, an API token in VERCEL_TOKEN, and Node.js 18+. Without VERCEL_TOKEN, the server cannot call the API. For runtime debugging, find the project ID with list_projects, then narrow results by time, level, source, or error status.
What it helps with
- check the state of recent deployments
- trace failures in build logs
- filter runtime application logs
- promote a preview deployment to production
- roll back to an earlier deployment
Example prompts for the agent
- Show the latest Vercel deployments and filter for failed ones.
- Find runtime errors in the latest deployment of
my-appfrom the last 24 hours. - Roll back project
prj_xyz789to the previous deployment.
How to install vercel
Platform CLI
claude mcp add --env VERCEL_TOKEN=<VERCEL_TOKEN> --env VERCEL_TEAM_ID=<VERCEL_TEAM_ID> --env VERCEL_TEAM_SLUG=<VERCEL_TEAM_SLUG> --env VERCEL_ENABLED_TOOLGROUPS=<VERCEL_ENABLED_TOOLGROUPS> --transport stdio vercel -- npx -y vercel-platform-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add vercel --env VERCEL_TOKEN=<VERCEL_TOKEN> --env VERCEL_TEAM_ID=<VERCEL_TEAM_ID> --env VERCEL_TEAM_SLUG=<VERCEL_TEAM_SLUG> --env VERCEL_ENABLED_TOOLGROUPS=<VERCEL_ENABLED_TOOLGROUPS> -- npx -y vercel-platform-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": [
"-y",
"vercel-platform-mcp-server"
],
"env": {
"VERCEL_TOKEN": "<VERCEL_TOKEN>",
"VERCEL_TEAM_ID": "<VERCEL_TEAM_ID>",
"VERCEL_TEAM_SLUG": "<VERCEL_TEAM_SLUG>",
"VERCEL_ENABLED_TOOLGROUPS": "<VERCEL_ENABLED_TOOLGROUPS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"vercel": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vercel-platform-mcp-server"
],
"env": {
"VERCEL_TOKEN": "<VERCEL_TOKEN>",
"VERCEL_TEAM_ID": "<VERCEL_TEAM_ID>",
"VERCEL_TEAM_SLUG": "<VERCEL_TEAM_SLUG>",
"VERCEL_ENABLED_TOOLGROUPS": "<VERCEL_ENABLED_TOOLGROUPS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e VERCEL_TOKEN=<VERCEL_TOKEN> -e VERCEL_TEAM_ID=<VERCEL_TEAM_ID> -e VERCEL_TEAM_SLUG=<VERCEL_TEAM_SLUG> -e VERCEL_ENABLED_TOOLGROUPS=<VERCEL_ENABLED_TOOLGROUPS> vercel npx -y vercel-platform-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about vercel
How do I install vercel in Claude Code?
Run claude mcp add vercel -e VERCEL_TOKEN=<VERCEL_TOKEN> -- npx -y vercel-platform-mcp-server.
What does the vercel MCP server do?
It manages Vercel deployments and exposes build and runtime application logs. The agent can create, cancel, delete, promote, and roll back deployments.
What does vercel require to run?
You need a Vercel account with an API token and Node.js 18+. Team operations can use VERCEL_TEAM_ID or VERCEL_TEAM_SLUG.
