> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Vercel

**Authentication:** OAuth or API token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List failed deploys in the last 24 hours, by project.
* Trigger a redeploy of the `marketing-site` production branch.
* Find projects with no deploys in the last 60 days.

## Available Tools

#### list_deployments

List Vercel deployments with pagination. Filter by project, target, or state. Use 'until' cursor from page_info for n...

#### create_deployment

Create a new Vercel deployment. Provide project name and optionally a Git source or files to deploy. Use list_project...

#### get_deployment

Get a Vercel deployment by ID or URL. Returns deployment details including state, URL, and metadata. Use list_deploym...

#### delete_deployment

Delete a Vercel deployment by ID. This permanently removes the deployment. Use list_deployments to find valid IDs.

#### cancel_deployment

Cancel an in-progress Vercel deployment. Only works on deployments that are currently building. Use list_deployments ...

#### list_deployment_files

List files in a Vercel deployment. Returns the file tree of the deployed output. Use list_deployments to find valid d...

#### get_deployment_events

Get build logs and events for a Vercel deployment. Returns build output and status changes. Use list_deployments to f...

#### list_domains

List all domains on the Vercel account with pagination. Use 'until' cursor from page_info for next page.

#### get_domain

Get details for a specific domain including verification and configuration status. Use list_domains to find valid dom...

#### add_domain

Add a domain to your Vercel account. After adding, configure DNS to point to Vercel. Use get_domain_config to check D...

#### update_domain

Update or move a domain. Use op='move' with destination team ID to transfer a domain between teams. Use list_domains ...

#### delete_domain

Remove a domain from your Vercel account. This does not affect DNS records. Use list_domains to find valid domain names.

#### get_domain_config

Get DNS configuration status for a domain. Shows whether the domain is properly configured and any required DNS changes.

#### list_env_vars

List environment variables for a Vercel project. Values may be encrypted. Use get_env_var to decrypt. Use 'until' cur...

#### create_env_var

Create an environment variable for a Vercel project. Specify key, value, type (plain/encrypted/secret/sensitive), and...

#### get_env_var

Get a decrypted environment variable value by ID. Use list_env_vars to find valid env var IDs for the project.

#### update_env_var

Update an environment variable's key, value, type, or target environments. Use list_env_vars to find valid env var IDs.

#### delete_env_var

Delete an environment variable from a Vercel project. Use list_env_vars to find valid env var IDs.

#### delete_env_vars_batch

Batch delete multiple environment variables from a Vercel project. Use list_env_vars to find valid env var IDs.

#### list_feature_flags

List feature flags for a Vercel project. Supports filtering by state and search. Use cursor from page_info for next p...

#### get_feature_flag

Get details of a specific feature flag by ID. Use list_feature_flags to find valid flag IDs.

#### list_feature_flag_segments

List feature flag segments for a Vercel project. Segments define user groups for targeting.

#### get_feature_flag_segment

Get details of a specific feature flag segment by ID. Use list_feature_flag_segments to find valid segment IDs.

#### list_projects

List Vercel projects with pagination. Use 'until' cursor from page_info for next page. Optionally filter by search term.

#### create_project

Create a new Vercel project. Optionally connect a Git repository and set framework, build command, and environment va...

#### get_project

Get a Vercel project by ID or name. Returns project details including framework, Git repo, and settings. Use list_pro...

#### update_project

Update a Vercel project's settings such as name, framework, build command, or output directory. Use list_projects to ...

#### delete_project

Delete a Vercel project by ID or name. This permanently removes the project and all its deployments. Use list_project...

#### list_project_domains

List domains assigned to a Vercel project. Use 'until' cursor from page_info for next page. Use list_projects to find...

#### add_project_domain

Add a domain to a Vercel project. Optionally configure redirect or link to a git branch. Use list_projects to find va...

#### remove_project_domain

Remove a domain from a Vercel project. Use list_project_domains to find valid domain names for the project.

#### pause_project

Pause a Vercel project. Paused projects stop serving traffic. Use list_projects to find valid project IDs.

#### unpause_project

Unpause a Vercel project. Resumes traffic to the project's deployments. Use list_projects to find valid project IDs.

#### list_shared_env_vars

List shared (team-level) environment variables. These are shared across all projects in the team. Use list_teams to f...

#### create_shared_env_var

Create a shared (team-level) environment variable. Shared vars are accessible to all projects in the team. Use list_t...

#### get_shared_env_var

Get a decrypted shared environment variable by ID. Use list_shared_env_vars to find valid IDs.

#### update_shared_env_var

Update a shared environment variable's key, value, type, or target. Use list_shared_env_vars to find valid IDs.

#### delete_shared_env_vars

Delete one or more shared environment variables by ID. Use list_shared_env_vars to find valid IDs.

#### disconnect_shared_env_var

Disconnect a shared environment variable from a specific project. The variable remains but is no longer linked to the...

#### list_teams

List all Vercel teams the authenticated user belongs to. Use 'until' cursor from page_info for next page.

#### get_team

Get details for a Vercel team by ID including name, slug, and membership info. Use list_teams to find valid team IDs.

#### create_team

Create a new Vercel team. Requires a unique URL slug. Optionally set a display name.

#### update_team

Update a Vercel team's name, slug, or description. Use list_teams to find valid team IDs.

#### delete_team

Delete a Vercel team. This permanently removes the team and all associated resources. Use list_teams to find valid te...

#### list_team_members

List members of a Vercel team with pagination. Use 'until' cursor from page_info for next page. Use list_teams to fin...

#### invite_team_member

Invite a user to a Vercel team by email. Assign a role: MEMBER, OWNER, VIEWER, DEVELOPER, or BILLING. Use list_teams ...

#### get_authenticated_user

Get the currently authenticated Vercel user's profile including email, username, and avatar.

#### list_user_events

List activity events for the authenticated user. Shows recent actions like deployments, domain changes, and team acti...

#### list_webhooks

List all webhooks configured for the account or team. Returns webhook IDs, URLs, and subscribed events.

#### create_webhook

Create a webhook to receive event notifications. Specify URL and event types (e.g. deployment.created, project.created).

#### get_webhook

Get details of a specific webhook by ID. Use list_webhooks to find valid webhook IDs.

#### delete_webhook

Delete a webhook by ID. Use list_webhooks to find valid webhook IDs.