? A powerful Model Context Protocol (MCP) server that provides full administrative control over your Vercel deployments through both Cursor's Composer and Codeium's Cascade. This tool enables seamless project management with comprehensive features for deployments, domains, environment variables, and more.
? Table of Contents
? Prerequisites
- Node.js >= 16.x
- npm >= 8.x
- A Vercel account with:
- Access Token
- Team ID (optional)
- Project ID (optional)
- Cursor IDE or Codeium's Cascade (for paying users)
? Quick Start
? Installation
# Clone the repository
git clone https://github.com/Quegenx/vercel-mcp-server.git
cd vercel-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
⚙️ Configuration
-
Install dependencies and build the project:
npm install
npm run build
-
Set up your Vercel access token:
- Go to https://vercel.com/account/tokens to generate your access token
-
Update the token in both of these files:
In src/config/constants.ts:
export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
In src/index.ts:
export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
-
In Cursor's MCP settings, add the server with this command:
For macOS:
# Default installation
/usr/local/bin/node /path/to/vercel-mcp/dist/index.js
# Homebrew installation
/opt/homebrew/bin/node /path/to/vercel-mcp/dist/index.js
# NVM installation
~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
For Windows:
```bash
# Default installation
C:Program Files
odejs
ode.exe C:path overcel-mcpdistindex.js
# NVM for Windows
C:
vm4w
odejs
ode.exe C:path overcel-mcpdistindex.js
# Scoop installation
C:Usersusernamescoopapps
odejscurrent
ode.exe C:path overcel-mcpdistindex.js
For Linux:
```bash
# Default installation
/usr/bin/node /path/to/vercel-mcp/dist/index.js
# NVM installation
~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
Replace /path/to/vercel-mcp or C:path overcel-mcp with your actual installation path.
To find your Node.js path:
# macOS/Linux
which node
# Windows
where node
Note: Keep your Vercel access token secure and never commit it to version control.
? Features
Team Management
- Teams:
create_team, delete_team, get_team, list_teams, update_team
- Team Members:
list_team_members, invite_team_member, remove_team_member, update_team_member
Project Management
- Projects:
list_projects, create_project, delete_project, update_project, pause_project
- Project Members:
add_project_member, list_project_members, remove_project_member
- Project Transfer:
request_project_transfer, accept_project_transfer
Deployment Management
- Deployments:
create_deployment, cancel_deployment, get_deployment, delete_deployment, list_deployment
- Deployment Events:
get_deployment_events, update_deployment_integration
- Deployment Files:
list_deployment_files, upload_deployment_files, get_deployment_file
- Promotion:
promote_deployment, get_promotion_aliases
Domain & DNS Management
- Domains:
add_domain, remove_domain, get_domain, list_domains, get_project_domain
- Domain Operations:
domain_check, domain_price, domain_config, domain_registry, domain_get, domain_list, domain_buy, domain_register, domain_remove, domain_update
- DNS:
create_dns_record, delete_dns_record, list_dns_records, update_dns_record
- Certificates:
get_cert, issue_cert, remove_cert, upload_cert
Environment & Configuration
- Environment Variables:
add_env, update_env, delete_env, get_env, list_env
- Edge Config:
create_edge_config, update_edge_config, delete_edge_config, get_edge_config, list_edge_configs
- Edge Config Items:
list_edge_config_items, get_edge_config_item, update_edge_config_items
- Edge Config Schema:
get_edge_config_schema, update_edge_config_schema, delete_edge_config_schema
- Edge Config Tokens:
create_edge_config_token, get_edge_config_token, list_edge_config_tokens, delete_edge_config_tokens
- Edge Config Backups:
list_edge_config_backups, get_edge_config_backup
Access Control & Security
- Access Groups:
create_access_group, delete_access_group, update_access_group, get_access_group, list_access_groups
- Access Group Projects:
create_access_group_project, delete_access_group_project, get_access_group_project, list_access_group_projects
- Access Group Members:
list_access_group_members
- Authentication:
create_auth_token, delete_auth_token, get_auth_token, list_auth_tokens, sso_token_exchange
- Firewall:
create_firewall_bypass, delete_firewall_bypass, get_firewall_bypass, get_attack_status, update_attack_mode, get_firewall_config, update_firewall_config, put_firewall_config
Monitoring & Logging
- Log Drains:
logdrain_create, logdrain_createIntegration, logdrain_delete, logdrain_deleteIntegration, logdrain_get, logdrain_list, logdrain_listIntegration
- Webhooks:
create_webhook, delete_webhook, list_webhooks, get_webhook
- Analytics:
send_web_vitals
User Management
- Users:
delete_user, get_user, list_user_events
Marketplace & Integration
- Marketplace:
create_marketplace_event, get_marketplace_account, get_marketplace_invoice, get_marketplace_member, import_marketplace_resource, submit_marketplace_billing, submit_marketplace_invoice, update_marketplace_secrets, marketplace_sso_token_exchange, submit_marketplace_balance, marketplace_invoice_action
- Integrations:
int_delete, int_list, int_gitns, int_searchRepo, int_get, int_updateAction
Environments & Secrets
- Environments:
create_environment, delete_environment, get_environment, list_environments, update_environment
- Secrets:
create_secret, update_secret_name, delete_secret, get_secret, list_secrets
Artifacts & Aliases
- Artifacts:
check_artifact, download_artifact, get_artifact_status, query_artifacts, record_artifact_events, upload_artifact
- Aliases:
assign_alias, delete_alias, get_alias, list_aliases, list_deployment_aliases
? Usage
Once configured, the MCP server provides all Vercel management tools through Cursor's Composer. Simply describe what you want to do with your Vercel projects, and the AI will use the appropriate commands.
Examples:
- ? "List all my projects"
- ? "Create a new Next.js project"
- ? "Add a custom domain to my project"
- ? "Set up environment variables"
? Security Notes
- ? Keep your Vercel access token secure
- ⚠️ Never commit sensitive credentials to version control
- ? Use appropriate access controls and permissions
- ?️ Follow Vercel's security best practices
?️ Troubleshooting
Common Issues
- Node.js Path Issues
- Ensure you're using the correct Node.js path
- On Mac/Linux: Use
which node to find the correct path
-
On Windows: Use where node to find the correct path
-
Access Token Issues
- Verify your Vercel access token is valid
- Check if the token has the required permissions
-
Ensure the token hasn't expired
-
MCP Not Detecting Tools
- Click the refresh button in Cursor's MCP settings
- Ensure the server is running (no error messages)
- Verify your Vercel credentials are valid
Debug Mode
Add DEBUG=true before your command to see detailed logs:
# macOS/Linux
DEBUG=true /usr/local/bin/node /path/to/vercel-mcp/dist/index.js
# Windows
set DEBUG=true && "C:Program Files
odejs
ode.exe" "C:path overcel-mcpdistindex.js"
If you're still experiencing issues, please open an issue with:
- Your operating system
- Node.js version (node --version)
- Full error message
- Steps to reproduce
? Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
? License
