Vercel MCP Tools

The Vercel MCP server offers two main categories of tools:

  • Public tools: Available without authentication, including documentation search
  • Authenticated tools: Require Vercel authentication for managing teams, projects, and deployments

Search the comprehensive Vercel documentation for answers about platform features, best practices, and technical guidance.

Parameters:

  • topic (optional): Specific topic to focus the search on (e.g., 'routing', 'data-fetching')
  • tokens (optional): Maximum number of tokens to include in the result (default: 2500)

Coverage Areas:

  • Core concepts: Projects, Deployments, Git Integration, Preview Deployments, Environments
  • Frontend & frameworks: Next.js, SvelteKit, Nuxt, Astro, Remix, framework configuration and optimization
  • APIs: REST API, Vercel SDK, Build Output API
  • Compute: Fluid Compute, Functions, Routing Middleware, Cron Jobs, OG Image Generation, Sandbox, Data Cache
  • AI: Vercel AI SDK, AI Gateway, MCP, v0
  • Performance & delivery: Edge Network, Caching, CDN, Image Optimization, Headers, Redirects, Rewrites
  • Pricing: Plans, Spend Management, Billing
  • Security: Audit Logs, Firewall, Bot Management, BotID, OIDC, RBAC, Secure Compute, 2FA
  • Storage: Blog, Edge Config

These tools require Vercel authentication and are available when using the authenticated MCP endpoints.

List all teams that include the authenticated user as a member.

Parameters: None

Returns: Array of team objects with:

  • name: Team name (nullable)
  • slug: Team slug identifier
  • id: Team ID
  • saml: SAML configuration (if applicable)

List all Vercel projects associated with a user (maximum 50 projects).

Parameters:

  • teamId (optional): Team ID or team slug to list projects for. Can use either alphanumeric ID (e.g., 'team_123') or team slug (e.g., 'my-team')

Returns: Array of project objects with:

  • id: Project ID
  • name: Project name
  • accountId: Account/Team ID
  • createdAt: Creation timestamp

Retrieve detailed information about a specific project.

Parameters:

  • teamId (optional): Team ID or team slug
  • projectId (optional): Project ID or project slug

Returns: Detailed project object including:

  • id: Project ID
  • name: Project name
  • framework: Framework information
  • accountId: Account/Team ID
  • createdAt: Creation timestamp
  • updatedAt: Last update timestamp
  • nodeVersion: Node.js version
  • live: Live status
  • latestDeployment: Information about the most recent deployment
  • domains: Associated domains

List deployments associated with a specific project.

Parameters:

  • teamId (optional): Team ID or team slug
  • projectId (optional): Project ID or project slug

Returns: Array of deployment objects with:

  • id: Deployment ID
  • name: Deployment name
  • url: Deployment URL
  • created: Creation timestamp
  • state: Deployment state
  • target: Deployment target (production/preview)
  • creator: Deployment creator information
  • meta: Additional metadata
  • inspectorUrl: Inspector URL for debugging
  • isRollbackCandidate: Whether deployment can be rolled back

Retrieve detailed information for a specific deployment.

Parameters:

  • teamId (optional): Team ID or team slug
  • deploymentId (required): Deployment ID

Returns: Detailed deployment object including:

  • id: Deployment ID
  • name: Deployment name
  • url: Deployment URL
  • type: Deployment type
  • state: Deployment state
  • createdAt: Creation timestamp
  • creator: Creator information
  • project: Associated project information
  • meta: Additional metadata
  • alias: Associated aliases
  • target: Deployment target
  • regions: Deployment regions
  • buildingAt: Build timestamp
  • ready: Ready status
  • readyState: Ready state
  • source: Deployment source

Retrieve build logs and events for a specific deployment.

Parameters:

  • teamId (optional): Team ID or team slug
  • deploymentId (required): Deployment ID
  • buildId (required): Build ID

Returns: Deployment events and build logs, which can be streamed or returned as JSON depending on the implementation.

  • search_vercel_documentation
  • All public tools plus:
  • list_teams
  • list_projects
  • get_project
  • list_deployments
  • get_deployment
  • get_deployment_events
{
  "tool": "search_vercel_documentation",
  "parameters": {
    "topic": "Next.js API routes",
    "tokens": 2000
  }
}
{
  "tool": "list_teams",
  "parameters": {}
}
{
  "tool": "list_deployments",
  "parameters": {
    "teamId": "team_abc123",
    "projectId": "my-project"
  }
}
Last updated on August 14, 2025