Manage Vercel deployments and inspect build and runtime application logs through the Vercel REST API.
Also known as pulsemcp/mcp-servers, vercel-platform-mcp-server
- Stars
- 81
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Oct 9, 2026
- License
- MIT
What is Vercel MCP?
Vercel manages Vercel deployments and inspect build and runtime application logs through the Vercel REST API. It exposes 10 tools, such as list_deployments, get_deployment, list_projects.
Summary generated from the project's README
About Vercel MCP server
Managing Vercel deployments and inspecting application logs directly from an AI client is what this server enables. Developers can oversee their entire deployment lifecycle, from listing projects and inspecting specific deployment details to performing critical actions like promoting a preview to production or rolling back to a previous version. It provides a way to monitor both build events and runtime application logs to identify errors quickly.
To use this server, you must provide a Vercel API token via the VERCEL_TOKEN environment variable. You can also scope operations to a specific team using VERCEL_TEAM_ID or VERCEL_TEAM_SLUG. For security, the server supports fine-grained access control through the VERCEL_ENABLED_TOOLGROUPS variable, allowing you to restrict the AI to readonly mode or grant full readwrite permissions. This setup works locally with Node.js 18+ and connects to your Vercel account through the REST API.
What you can do with it
- 1Manage production trafficPromote a specific preview deployment to the production environment.
- 2Investigate runtime errorsSearch through application logs for specific status codes or error levels.
- 3Restore previous versionsPerform a rollback to a previous deployment if a new release causes issues.
Written from the project's README. Every use case is checked against a quote from it.
How to install Vercel MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Vercel MCP in Claude Code
$ claude mcp add --env 'VERCEL_TOKEN=<YOUR_VERCEL_TOKEN>' vercel -- npx -y vercel-platform-mcp-serverInstall Vercel MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": [
"-y",
"vercel-platform-mcp-server"
],
"env": {
"VERCEL_TOKEN": "<YOUR_VERCEL_TOKEN>"
}
}
}
}Install Vercel MCP in VS Code
.vscode/mcp.json
{
"servers": {
"vercel": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vercel-platform-mcp-server"
],
"env": {
"VERCEL_TOKEN": "<YOUR_VERCEL_TOKEN>"
}
}
}
}Install Vercel MCP in VS Code CLI
$ code --add-mcp '{"name":"vercel","type":"stdio","command":"npx","args":["-y","vercel-platform-mcp-server"],"env":{"VERCEL_TOKEN":"<YOUR_VERCEL_TOKEN>"}}'Install Vercel MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": [
"-y",
"vercel-platform-mcp-server"
],
"env": {
"VERCEL_TOKEN": "<YOUR_VERCEL_TOKEN>"
}
}
}
}Install Vercel MCP in Codex
$ codex mcp add vercel --env 'VERCEL_TOKEN=<YOUR_VERCEL_TOKEN>' -- npx -y vercel-platform-mcp-serverInstall Vercel MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.vercel] command = "npx" args = ["-y", "vercel-platform-mcp-server"] [mcp_servers.vercel.env] VERCEL_TOKEN = "<YOUR_VERCEL_TOKEN>"
Install Vercel MCP in Gemini CLI
$ gemini mcp add -s user -e 'VERCEL_TOKEN=<YOUR_VERCEL_TOKEN>' vercel npx -- -y vercel-platform-mcp-serverInstall Vercel MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": [
"-y",
"vercel-platform-mcp-server"
],
"env": {
"VERCEL_TOKEN": "<YOUR_VERCEL_TOKEN>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Vercel MCP tools 10
Detected from the READMElist_deploymentsget_deploymentlist_projectsget_deployment_eventsget_runtime_logscreate_deploymentcancel_deploymentdelete_deploymentpromote_deploymentrollback_deployment
Configuration
VERCEL_TOKENRequiredSecretVercel API token for authentication.
VERCEL_ENABLED_TOOLGROUPSComma-separated list of tool groups to enable (readonly, readwrite).
VERCEL_TEAM_IDTeam ID for team-scoped operations.
VERCEL_TEAM_SLUGTeam URL slug for team-scoped operations.
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubVercel MCP Server
An MCP server for managing Vercel deployments and viewing application runtime logs through the Vercel REST API.
Highlights
- Deployment Management - List, inspect, create, cancel, delete, promote, and rollback deployments
- Build & Runtime Logs - View build logs (events) and runtime application logs for debugging
- Fine-grained Access Control - Enable readonly or readwrite tool groups via environment variables
- Team Support - Scope operations to a specific Vercel team
Capabilities
Tools
| Tool | Group | Description |
|---|---|---|
list_deployments |
readonly | List deployments with filtering by project, target, and state |
get_deployment |
readonly | Get detailed deployment information by ID or URL |
list_projects |
readonly | List projects in the account/team |
get_deployment_events |
readonly | Get build logs for a deployment |
get_runtime_logs |
readonly | Get runtime application logs with filtering |
create_deployment |
readwrite | Create a new deployment or redeploy |
cancel_deployment |
readwrite | Cancel an in-progress deployment |
delete_deployment |
readwrite | Delete a deployment permanently |
promote_deployment |
readwrite | Promote a deployment to production |
rollback_deployment |
readwrite | Rollback to a previous deployment |
Setup
Prerequisites
- A Vercel account with an API token (create one here)
- Node.js 18+
Configuration
| Variable | Required | Description |
|---|---|---|
VERCEL_TOKEN |
Yes | Vercel API token |
VERCEL_TEAM_ID |
No | Team ID for team-scoped operations |
VERCEL_TEAM_SLUG |
No | Team URL slug (alternative to team ID) |
VERCEL_ENABLED_TOOLGROUPS |
No | Comma-separated tool groups: readonly, readwrite (default: all) |
Manual Setup
# Clone the repository
git clone https://github.com/pulsemcp/mcp-servers.git
cd mcp-servers/experimental/vercel
# Install dependencies
npm install
# Build
npm run build
# Set environment variables
export VERCEL_TOKEN="your-token-here"
# Run
npm start
Usage Tips
- Use
list_projectsfirst to find project IDs needed bypromote_deployment,rollback_deployment, andget_runtime_logs - Runtime log retention varies by plan: Hobby=1h, Pro=1d, Enterprise=3d (up to 30d with Observability Plus)
- Use
get_runtime_logswithsince/untilto query historical logs,searchto find specific errors, andlevel/sourceto filter results - Set
VERCEL_ENABLED_TOOLGROUPS=readonlyto prevent any write operations - Use
list_deploymentswith thestatefilter to quickly find failed or in-progress deployments
Examples
Check deployment status
"What's the status of my latest deployments?"
Uses list_deployments to show recent deployments with their states.
Debug a failed build
"Show me the build logs for deployment dpl_abc123"
Uses get_deployment_events to display the build output and error messages.
Promote a preview to production
"Promote deployment dpl_abc123 to production for project prj_xyz789"
Uses promote_deployment to make a preview deployment serve production traffic.
View runtime errors
"Show me the runtime logs for my-app's latest deployment"
Uses list_projects to find the project ID, then get_runtime_logs to show recent application logs.
Search for specific errors in logs
"Find all 500 errors in the last 24 hours for my-app"
Uses get_runtime_logs with statusCode: 500 and since set to 24 hours ago to filter server errors.
Debug edge function issues
"Show me warning and error logs from edge functions for dpl_abc123"
Uses get_runtime_logs with source: "edge-function" and level: "error" to narrow down issues.
Development
# Install dependencies
npm install
# Build
npm run build
# Run functional tests
npm test
# Run integration tests
npm run test:integration
# Run manual tests (requires .env with VERCEL_TOKEN)
npm run test:manual
# Lint
npm run lint
Vercel MCP questions
How do I add Vercel MCP to Claude Code?
Run claude mcp add --env 'VERCEL_TOKEN=<YOUR_VERCEL_TOKEN>' vercel -- npx -y vercel-platform-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Vercel MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Vercel MCP provide?
It exposes 10 tools, including list_deployments, get_deployment, list_projects, get_deployment_events, get_runtime_logs.
How do I authenticate the Vercel MCP server?
You provide a Vercel API token in the VERCEL_TOKEN environment variable, which you can create in your Vercel account settings.
Can I limit the Vercel MCP server to read-only operations?
Yes. Set VERCEL_ENABLED_TOOLGROUPS=readonly to enable only read-only tools and prevent any write operations.
Can the server scope operations to a specific Vercel team?
Yes, you can set VERCEL_TEAM_ID or VERCEL_TEAM_SLUG to scope operations to a specific team.
How long are runtime logs retained?
Retention depends on your plan: Hobby is 1 hour, Pro is 1 day, and Enterprise is 3 days (up to 30 days with Observability Plus).
Can the server promote or roll back deployments?
Yes, it provides promote_deployment and rollback_deployment tools, along with create, cancel, and delete deployment tools.