stackgate.ai
All integrations

Vercel

Manage Vercel projects, deployments, env vars, domains, DNS, and aliases via MCP. Connect with an access token.

Manual setup 41 tools

Overview

Connect Vercel so AI clients can manage projects, deployments, environment variables, domains, DNS, and aliases through the Vercel REST API.

stackgate.ai stores your access token encrypted and calls https://api.vercel.com on your behalf. Tool results are returned to your AI client for that request.

Prerequisites

  • A Vercel account
  • A stackgate.ai account

Getting credentials

  1. Sign in to Vercel and open Account Tokens (personal account Settings).
  2. Create a token with Full Account, Team, or Project scope. Prefer the narrowest scope that covers your tools.
  3. Copy the token once (often prefixed with vcp_).
  4. In stackgate.ai, open My Integrations → Vercel, paste the token, and click Connect & enable.
  5. Optionally choose a default team (organization) and project from the dropdowns, or skip.

Treat the token like a password. Revoke or rotate it in Vercel if it is exposed.

For full-account tokens targeting a team, set a default team so tools send teamId automatically. You can also set a default project. Team- and project-scoped tokens usually do not need a team default.

Using with AI clients

  • Dedicated endpoint: POST /mcp/vercel with a Sanctum bearer token
  • Private gateway: one config for all integrations - use vercel__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Suggested workflow

  1. get_user / list_teams - confirm identity and team IDs.
  2. list_projects / get_project - find project ids or names.
  3. list_deployments / get_deployment / get_deployment_events - inspect status and builds.
  4. list_project_env / create_project_env - manage env vars carefully.
  5. promote_deployment / rollback_project - control production traffic.
  6. Domain, DNS, and alias tools for hostname management.

Troubleshooting

  • 422 integration not configured - paste an access token in My Integrations.
  • 401 Unauthorized - regenerate the token under Account Tokens and update My Integrations.
  • 403 Forbidden - the token scope or team role may lack permission for that resource.
  • Missing team resources - set a default team on the Vercel defaults page, or pass team_id on the tool call.
  • 429 Too many requests - Vercel enforces per-endpoint rate limits; wait and retry, and avoid tight polling loops.
  • Destructive actions - tools like delete_project, delete_deployment, and DNS deletes can cause outages; confirm intent before approving Write access.

Available tools

  • get_user

    Get the Vercel user for the connected access token.

  • list_teams

    List Vercel teams accessible to the connected token.

  • get_team

    Get a Vercel team by ID. Defaults to team_id or organization_id from My Integrations.

  • list_projects

    List Vercel projects. Optionally filter by search string.

  • get_project

    Get a Vercel project by id or name.

  • create_project

    Create a new Vercel project.

  • update_project

    Update an existing Vercel project.

  • delete_project

    Delete a Vercel project. Confirm with the user before calling.

  • list_deployments

    List deployments, optionally filtered by project, state, or target.

  • get_deployment

    Get a deployment by ID or URL.

  • get_deployment_events

    Get build and runtime events for a deployment.

  • cancel_deployment

    Cancel a running deployment.

  • delete_deployment

    Delete a deployment. Confirm with the user before calling.

  • create_deployment

    Create a new deployment from a project or git source. File-upload deployments are not supported.

  • promote_deployment

    Point production traffic to a given deployment.

  • rollback_project

    Point production traffic to a previous production deployment.

  • list_project_env

    List environment variables for a project (values may be encrypted).

  • get_project_env

    Retrieve the decrypted value of a project environment variable by ID.

  • create_project_env

    Create an environment variable on a project.

  • update_project_env

    Edit an environment variable on a project.

  • delete_project_env

    Remove an environment variable from a project.

  • list_project_domains

    List domains assigned to a project.

  • add_project_domain

    Add a domain to a project.

  • update_project_domain

    Update a project domain.

  • remove_project_domain

    Remove a domain from a project.

  • verify_project_domain

    Verify a project domain.

  • pause_project

    Pause a project (stops new deployments serving traffic).

  • unpause_project

    Unpause a previously paused project.

  • list_domains

    List all domains on the account or team.

  • get_domain

    Get information for a single apex domain.

  • add_domain

    Add an existing domain to the Vercel platform / account.

  • remove_domain

    Remove a domain from the Vercel platform. Confirm with the user before calling.

  • list_dns_records

    List DNS records for a domain.

  • create_dns_record

    Create a DNS record on a domain.

  • update_dns_record

    Update an existing DNS record.

  • delete_dns_record

    Delete a DNS record from a domain.

  • list_aliases

    List aliases for the account or team.

  • get_alias

    Get an alias by ID or alias hostname.

  • list_deployment_aliases

    List aliases assigned to a deployment.

  • assign_alias

    Assign an alias to a deployment.

  • delete_alias

    Delete an alias by ID.

MCP endpoint: https://stackgate.ai/mcp/vercel (HTTP) or via the private gateway.

Create account Documentation