# Vercel MCP

> Vercel MCP connects your AI agent directly to your cloud infrastructure. You can list all projects, check deployment status, manage environment variables, link domains, and trigger new builds—all from a simple conversation.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Tags:** frontend-deployment, serverless-functions, edge-computing, build-status, deployment-pipeline, web-hosting

## Description

Managing modern frontend deployments across different environments is usually a headache that requires jumping between dashboards. With this MCP, you talk to your AI agent, and it handles the backend work for Vercel. Need to check if the staging site built correctly? Or maybe you forgot to set an API key in production? You just ask. Your agent pulls the status or sets the variable without you ever leaving your chat window. It’s about controlling your entire build lifecycle—from listing all projects to deleting old records, and even linking custom domains.

Because this MCP deals with critical access tokens and deployment secrets, Vinkius keeps everything locked down using a zero-trust proxy. This means your keys pass through safely in transit but never sit on disk, making the whole process secure. Whether you’re running simple checks or chaining multiple services together for complex automations, your agent manages it all within Vinkius, giving you full visibility into every action taken.

## Tools

### add_vercel_environment_variable
Adds a new environment variable to an existing Vercel project.

### create_vercel_deployment
Triggers and initiates a brand-new deployment build for a specified project.

### delete_vercel_deployment
Removes or deletes an old, specific deployment record from the account.

### get_vercel_deployment_info
Retrieves detailed status and metadata for one particular deployment ID.

### get_vercel_project_details
Pulls all the core configuration details for a specified Vercel project.

### get_vercel_user_profile
Shows basic information about the user account that owns the connection.

### list_vercel_deployments
Shows a list of the most recent deployment records across the entire account.

### list_vercel_account_domains
Lists all registered custom domains associated with your Vercel account.

### list_vercel_project_env_vars
Lists all currently set environment variables for a specific project.

### list_vercel_projects
Retrieves a list of every Vercel project accessible under the connected account.

### list_vercel_teams
Lists all teams to which your user profile has access.

## Prompt Examples

**Prompt:** 
```
List all active projects in my Vercel team.
```

**Response:** 
```
I've retrieved your projects. You have access to: 'vinkius-app', 'marketing-blog', and 'api-gateway'. Which one would you like to inspect?
```

**Prompt:** 
```
Show me the status of the latest deployment for 'vinkius-app'.
```

**Response:** 
```
The latest deployment for 'vinkius-app' (ID: dpl_8823...) is currently in 'READY' state. It was deployed successfully to vinkius-app.vercel.app.
```

**Prompt:** 
```
Add the environment variable 'DB_PASSWORD' to the project 'api-gateway'.
```

**Response:** 
```
Success! I've added 'DB_PASSWORD' to 'api-gateway'. The change is now active for production, preview, and development environments.
```

## Capabilities

### Check Project Status
Retrieve details about specific projects and list all available teams in your account.

### Manage Build Pipelines
Track build history, check the deployment status (like 'READY' or 'ERROR'), and kick off entirely new deployments for any project.

### Handle Secrets & Variables
List existing environment variables or add brand-new ones to keep your configuration safe.

### Configure Networking
See all domains attached to the account and instantly link custom domains to specific projects.

### Audit Deployment Records
List recent deployments or get detailed information on a single, specific build.

## Use Cases

### The Staging Site Failed
A developer finds a bug on staging. Instead of manually checking the build logs, they tell their agent: 'Show me the details for the last deployment of the staging project.' The agent runs `get_vercel_deployment_info` and spits out the error reason immediately.

### Need to Update a Secret
The team's main API key expires. An Ops engineer tells their agent: 'Add the new secret key for production.' The agent uses `add_vercel_environment_variable`, ensuring the change is applied without manual copy-pasting into a web form.

### Project Discovery
A new team member joins. They ask their agent to list all available projects. The MCP runs `list_vercel_projects` and gives them the full inventory, letting them know exactly what needs managing.

### Domain Verification
Before launching a feature, a product owner asks: 'Are we linked to all necessary custom domains?' The agent uses `list_vercel_account_domains` and verifies the setup against the project's requirements.

## Benefits

- Stop switching between dashboards. You check deployment status or list projects using natural language conversation instead of clicking through multiple tabs.
- Maintain strict secrets management by using the MCP to add new environment variables without ever exposing your raw credentials in a chat log.
- Audit your work instantly: Need to know which domains are set up? Use `list_vercel_account_domains` and get an immediate list of every custom site attached.
- Control the build process directly. If you need to push a fix, simply trigger it with `create_vercel_deployment`—no manual CLI commands needed.
- Get context instantly: Instead of guessing which project ID is right, use `list_vercel_projects` first, then ask for details on the specific one you want to work with.

## How It Works

The bottom line is that you control complex cloud operations using plain language prompts instead of clicking through web UIs.

1. Subscribe to this MCP and provide your Vercel Access Token.
2. Your AI agent uses the token through the secure Vinkius proxy to authenticate with your account.
3. You simply tell your agent what you want—for example, 'Check the environment variables for the staging project.'—and it returns the data.

## Frequently Asked Questions

**How do I use the `list_vercel_projects` tool?**
You simply ask your agent to list all projects. It runs `list_vercel_projects` and returns a clean, usable list of every project name you have access to.

**What is the best way to check deployment status with `get_vercel_deployment_info`?**
You first need to get the specific deployment ID (like dpl_xyz...). Then, asking for 'details on that deployment' lets your agent run `get_vercel_deployment_info`, giving you the current status.

**Can I set environment variables using `add_vercel_environment_variable`?**
Yes. Just tell your agent which project and what variable name/value to use, and it executes the secure call via `add_vercel_environment_variable`.

**How do I list all my domains? Do I use `list_vercel_account_domains`?**
Correct. Asking your agent to 'show my registered domains' triggers the `list_vercel_account_domains` tool, giving you a full account overview.

**How do I see all the teams I have access to using `list_vercel_teams`?**
The tool returns a list of accessible Vercel team names. This lets your agent verify which organizational scopes you can manage across your accounts.

**What if I need to clean up old deployments? How do I use `delete_vercel_deployment`?**
You pass the specific deployment ID to the tool, and it removes that record. This is useful for clearing out old build artifacts or abandoned testing environments.

**Besides listing projects, how do I get the full technical details using `get_vercel_project_details`?**
This function fetches comprehensive metadata about a specific project. It provides deeper context than just basic listings, helping you validate configuration settings.

**How can I check all the environment variables set for a specific project? Do I use `list_vercel_project_env_vars`?**
Yes, using this tool provides an inventory of current environment variables. This is key to auditing what secrets or configs are active on a given project.

**Can I see if a specific deployment failed using the AI?**
Yes! Use the `get_deployment_info` tool with the Deployment ID. Your agent will retrieve the current state, and if it's 'ERROR', it will show you the deployment details.

**How do I add a new API Key to a project via AI?**
Use the `add_environment_variable` action. Provide the project name/ID, the key name, and the value. You can also specify the type as 'secret' or 'sensitive'.

**Is it possible to list all domains linked to my account?**
Absolutely. Use the `list_account_domains` query to retrieve a complete list of all domains registered or configured within your Vercel account.