Vercel MCP Server

A comprehensive Model Context Protocol (MCP) server that provides seamless integration with Vercel's deployment platform. This server enables AI assistants and applications to manage projects, deployments, domains, environment variables, and team resources directly through Vercel's API. Whether you're deploying applications, managing custom domains, or configuring environment variables, this MCP server provides a complete toolkit for automating and controlling your Vercel infrastructure.

Overview

The Vercel MCP server acts as a bridge between AI assistants and Vercel's cloud platform, enabling programmatic control over your entire deployment workflow. It supports comprehensive project lifecycle management, from creation and configuration to deployment and monitoring. With support for team collaboration, domain management, and environment configuration, this server is designed for developers and teams who want to automate their Vercel operations or integrate deployment capabilities into their AI-powered workflows.

Features

Project Management

Complete control over your Vercel projects with full CRUD operations. Create new projects with custom configurations including framework presets, Git repository connections, and initial environment variables. Update existing projects to modify build settings, commands, and output directories. Search and filter through your projects, and manage project lifecycles including deletion when needed.

Deployment Operations

Trigger and manage deployments with fine-grained control over the deployment process. Create deployments from Git sources with specific branch or commit references, targeting either production or preview environments. Monitor deployment status across multiple states (BUILDING, READY, ERROR, etc.), cancel running deployments when necessary, and retrieve comprehensive build and runtime logs for debugging and monitoring purposes.

Domain Configuration

Full domain lifecycle management including adding custom domains to projects, removing domains, and verifying domain ownership. List all domains across your account or filter by specific projects. The server handles domain verification workflows to ensure proper DNS configuration and domain ownership validation.

Environment Variables

Comprehensive environment variable management with support for multiple target environments (production, preview, development). Create, update, and delete environment variables with optional Git branch scoping. List all environment variables for a project and manage sensitive configuration data across different deployment targets.

Team Collaboration

Access team information and manage team-based resources. List all teams you belong to, retrieve team member information, and perform operations within specific team contexts. All major operations support team ID filtering to ensure proper multi-tenant operation.

Alias Management

Control deployment aliases to manage custom URLs and domain routing. List aliases for deployments or projects, and assign new aliases to specific deployments for custom URL management and traffic routing.

Tools

list_projects

Retrieves all Vercel projects for the authenticated user or team. Supports pagination through a limit parameter, search functionality to filter projects by name or other criteria, and team ID filtering for multi-team accounts.

Parameters:

• limit (number, optional): Maximum number of projects to return
• search (string, optional): Search query to filter projects
• teamId (string, optional): Team ID to filter projects

create_project

Creates a new Vercel project with comprehensive configuration options. Specify the project name, optionally associate it with a team, set a framework preset for automatic configuration, connect a Git repository for continuous deployment, and initialize environment variables.

Parameters:

• name (string, required): Project name
• teamId (string, optional): Team ID to create project under
• framework (string, optional): Framework preset (e.g., nextjs, vite, remix)
• gitRepository (object, optional): Git repository configuration with type and repo path
• environmentVariables (array, optional): Initial environment variables with key, value, and target environments

update_project

Modifies settings for an existing project including name changes, framework preset updates, and build configuration overrides for development, build, and install commands, as well as output directory specifications.

Parameters:

• projectId (string, required): Project ID to update
• name (string, optional): New project name
• teamId (string, optional): Team ID
• framework (string, optional): Framework preset
• devCommand (string, optional): Development command override
• buildCommand (string, optional): Build command override
• installCommand (string, optional): Install command override
• outputDirectory (string, optional): Output directory override

delete_project

Permanently removes a Vercel project and all associated resources. Use with caution as this operation cannot be undone.

Parameters:

• projectId (string, required): Project ID to delete
• teamId (string, optional): Team ID

list_deployments

Retrieves deployments with flexible filtering options. List all deployments, filter by project, limit results for pagination, or filter by deployment state to find deployments in specific stages of the deployment lifecycle.

Parameters:

• projectId (string, optional): Filter by project ID
• limit (number, optional): Maximum number of deployments to return
• state (string, optional): Filter by deployment state (BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED)
• teamId (string, optional): Team ID

create_deployment

Initiates a new deployment for a project. Specify Git source configuration including repository ID, reference (branch or commit), and provider type. Target either production or preview environments based on your deployment strategy.

Parameters:

• projectId (string, required): Project ID to deploy
• gitSource (object, required): Git source configuration with type, repoId, and ref
• target (string, optional): Deployment target environment (production or preview)
• teamId (string, optional): Team ID

cancel_deployment

Stops a running deployment before completion. Useful for canceling deployments that were triggered in error or when newer deployments should take priority.

Parameters:

• deploymentId (string, required): Deployment ID to cancel
• teamId (string, optional): Team ID

get_deployment_logs

Retrieves comprehensive build and runtime logs for a specific deployment. Essential for debugging deployment issues, monitoring build processes, and understanding runtime behavior.

Parameters:

• deploymentId (string, required): Deployment ID
• limit (number, optional): Maximum number of log entries to return
• teamId (string, optional): Team ID

list_domains

Lists all domains associated with your account or team. Optionally filter by project ID to see only domains assigned to a specific project.

Parameters:

• teamId (string, optional): Team ID
• projectId (string, optional): Filter by project ID

add_domain

Adds a custom domain to a Vercel project. The domain must be configured with proper DNS records pointing to Vercel's infrastructure.

Parameters:

• projectId (string, required): Project ID
• domain (string, required): Domain name to add
• teamId (string, optional): Team ID

remove_domain

Removes a domain from a project and your Vercel account. The domain will no longer route to your deployments.

Parameters:

• domain (string, required): Domain name to remove
• teamId (string, optional): Team ID

verify_domain

Initiates domain ownership verification. Vercel checks DNS records to confirm you control the domain before allowing it to be used with your deployments.

Parameters:

• domain (string, required): Domain name to verify
• teamId (string, optional): Team ID

list_env_variables

Retrieves all environment variables configured for a project, including their keys, targets, and IDs for further management operations.

Parameters:

• projectId (string, required): Project ID
• teamId (string, optional): Team ID

create_env_variable

Creates a new environment variable for a project. Specify target environments (production, preview, development) and optionally scope the variable to specific Git branches.

Parameters:

• projectId (string, required): Project ID
• key (string, required): Environment variable key
• value (string, required): Environment variable value
• target (array, required): Target environments (production, preview, development)
• teamId (string, optional): Team ID
• gitBranch (string, optional): Git branch to scope the variable to

update_env_variable

Modifies an existing environment variable's value or target environments. Use the environment variable ID to specify which variable to update.

Parameters:

• projectId (string, required): Project ID
• envId (string, required): Environment variable ID
• value (string, optional): New value
• target (array, optional): Target environments (production, preview, development)
• teamId (string, optional): Team ID
• gitBranch (string, optional): Git branch to scope the variable to

delete_env_variable

Permanently removes an environment variable from a project. The variable will no longer be available in any deployment environment.

Parameters:

• projectId (string, required): Project ID
• envId (string, required): Environment variable ID
• teamId (string, optional): Team ID

list_teams

Retrieves all teams that the authenticated user is a member of, providing team IDs and basic information for team-scoped operations.

Parameters: None

get_team_members

Lists all members of a specific team including their roles, permissions, and membership status.

Parameters:

• teamId (string, required): Team ID

list_aliases

Retrieves all aliases (custom URLs) for your deployments. Filter by project or specific deployment to see alias assignments.

Parameters:

• teamId (string, optional): Team ID
• projectId (string, optional): Filter by project ID
• deploymentId (string, optional): Filter by deployment ID

assign_alias

Assigns a custom alias (URL) to a specific deployment, routing traffic from that alias to the deployment.

Parameters:

• deploymentId (string, required): Deployment ID
• alias (string, required): Alias to assign
• teamId (string, optional): Team ID

Resource Templates

project

Access detailed information about a specific Vercel project through the URI pattern vercel://project/{projectId}. Returns comprehensive project data including configuration, settings, linked repositories, and metadata.

deployment

Retrieve complete deployment information using vercel://deployment/{deploymentId}. Provides deployment status, URLs, build information, Git source details, and timing data.

domain

Access domain configuration and status information via vercel://domain/{domain}. Returns DNS configuration, verification status, SSL certificate information, and associated projects.

team

View team information and settings through vercel://team/{teamId}. Provides team name, member count, subscription details, and team-level settings.

env-variable

Access specific environment variable details using vercel://project/{projectId}/env/{envId}. Returns the variable's key, target environments, Git branch scope, and metadata without exposing the actual value for security purposes.

Use Cases

This MCP server excels in scenarios requiring deployment automation, infrastructure-as-code workflows, and AI-assisted DevOps operations. Use it to build chatbots that can deploy applications on command, create automated deployment pipelines triggered by natural language, manage multi-environment configurations programmatically, or integrate Vercel operations into larger workflow automation systems. The comprehensive API coverage makes it suitable for everything from simple deployment triggers to complex multi-project, multi-team infrastructure management.