Vercel MCP
A powerful Model Context Protocol (MCP) server enabling seamless Vercel project management, including deployments, domains, environment variables, and team configurations through Cursor's Composer or Codeium's Cascade.
What is Vercel MCP?
Vercel MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to powerful model context protocol (mcp) server enabling seamless vercel project management, including deployments, domains, environment variables, and team configurations through cursor's composer or co...
A powerful Model Context Protocol (MCP) server enabling seamless Vercel project management, including deployments, domains, environment variables, and team configurations through Cursor's Composer or Codeium's Cascade.
This server falls under the Cloud Services and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A powerful Model Context Protocol (MCP) server enabling seam
Use Cases
Maintainer
Works with
Installation
NPM
npx -y vercel-mcp-serverManual Installation
npx -y vercel-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Vercel MCP
The Vercel MCP Server is a TypeScript MCP server that exposes over 100 Vercel platform management tools to AI assistants, covering deployments, domains, DNS records, environment variables, edge configuration, access control, team management, and marketplace integrations. It enables developers using Cursor's Composer, Codeium's Cascade, or Claude Desktop to manage their entire Vercel infrastructure through natural language without switching to the Vercel dashboard. Teams that deploy frequently can use it to inspect deployment logs, promote previews to production, rotate secrets, and configure domains all within an AI-driven workflow.
Prerequisites
- Node.js 16 or newer and npm 8 or newer installed
- A Vercel account with an access token (generate at https://vercel.com/account/tokens)
- Git to clone the repository
- An MCP-compatible client such as Claude Desktop, Cursor, or Codeium Cascade
Clone the repository and install dependencies
The server is not published to npm, so clone it locally and install its dependencies.
git clone https://github.com/Quegenx/vercel-mcp-server.git
cd vercel-mcp-server
npm installGenerate a Vercel access token
Go to https://vercel.com/account/tokens, create a new token with an appropriate scope, and copy it. Never commit this token to version control.
Set your access token in the source files
Open src/config/constants.ts and src/index.ts and set the DEFAULT_ACCESS_TOKEN constant to your Vercel token. Alternatively, pass it as an environment variable in your MCP config.
# In src/config/constants.ts and src/index.ts, set:
# export const DEFAULT_ACCESS_TOKEN = 'your_vercel_token_here';Build the server
Compile the TypeScript source to JavaScript in the dist/ directory.
npm run buildFind your Node.js binary path and configure your MCP client
The MCP config needs the absolute path to node. Use 'which node' (macOS/Linux) or 'where node' (Windows), then add the server entry to your client config.
{
"mcpServers": {
"vercel": {
"command": "/usr/local/bin/node",
"args": ["/path/to/vercel-mcp-server/dist/index.js"]
}
}
}Restart your MCP client and verify
Fully quit and relaunch your MCP client, then ask it to list your Vercel projects to confirm the connection.
Vercel MCP Examples
Client configuration
Example claude_desktop_config.json for running the Vercel MCP server. Replace the node and script paths with the actual absolute paths on your system.
{
"mcpServers": {
"vercel": {
"command": "/usr/local/bin/node",
"args": ["/path/to/vercel-mcp-server/dist/index.js"]
}
}
}Prompts to try
These prompts exercise the broad range of Vercel management tools the server exposes.
- "List all my Vercel projects and their latest deployment status."
- "Add the custom domain api.myapp.com to my project my-nextjs-app."
- "Set a new environment variable DATABASE_URL for the production environment of project my-api."
- "Cancel the deployment with ID dpl_abc123."
- "Show me the DNS records for myapp.com."Troubleshooting Vercel MCP
Authentication error 403 when calling Vercel API tools
Verify that DEFAULT_ACCESS_TOKEN is set correctly in both src/config/constants.ts and src/index.ts before running 'npm run build'. The built dist/ files embed the token at compile time, so rebuild after any change to the token.
MCP client shows 'server not found' or fails to launch
Confirm the absolute paths in the MCP config are correct. Run 'which node' to get the exact node path and verify the dist/index.js file exists after 'npm run build'. On Windows use backslashes or escaped forward slashes in the path.
Tool calls succeed but changes are not reflected in the Vercel dashboard immediately
Some Vercel operations (domain propagation, deployment promotion) have propagation delays of several minutes. Wait 2–5 minutes and refresh the dashboard, or ask the AI to describe the current status using a list tool.
Frequently Asked Questions about Vercel MCP
What is Vercel MCP?
Vercel MCP is a Model Context Protocol (MCP) server that powerful model context protocol (mcp) server enabling seamless vercel project management, including deployments, domains, environment variables, and team configurations through cursor's composer or codeium's cascade. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Vercel MCP?
Install via npm with the command: npx -y vercel-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Vercel MCP?
Vercel MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Vercel MCP free to use?
Yes, Vercel MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Vercel MCP Alternatives — Similar Cloud Services Servers
Looking for alternatives to Vercel MCP? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Vercel MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Vercel MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.