--- title: Routing product: vercel url: /docs/agent-resources/vercel-mcp/tools/routing canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/routing" last_updated: 2018-10-20 type: reference prerequisites: - /docs/agent-resources/vercel-mcp/tools - /docs/agent-resources/vercel-mcp related: [] summary: Vercel MCP tools for routing. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Routing Control where requests go with project routing rules, redirects, and deployment aliases. You can stage changes, review version history, and promote or restore a routing configuration. ## `add_route` Add a routing rule. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `projectId` | string | Yes | The project ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | ## `assign_alias` Assign an Alias. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | ------------------------------------------------ | | `id` | string | Yes | The deployment or alias ID or URL to assign from | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | Yes | Request body for this tool. | ## `edit_route` Edit a routing rule. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `projectId` | string | Yes | The project ID. | | `routeId` | string | Yes | The route ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | Yes | Request body for this tool. | ## `generate_route` Generate a routing rule from natural language. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `projectId` | string | Yes | The project ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | ## `list_aliases` List aliases. ## Parameters | Parameter | Type | Required | Description | | ---------------------- | -------------------------- | -------- | -------------------------------------------------------------- | | `domain` | Array\ | string | No | Get only aliases of the given domain name | | `from` | number | No | Get only aliases created after the provided timestamp | | `limit` | number | No | Maximum number of aliases to list from a request | | `projectId` | string | No | Filter aliases from the given `projectId` | | `since` | number | No | Get aliases created after this JavaScript timestamp | | `until` | number | No | Get aliases created before this JavaScript timestamp | | `rollbackDeploymentId` | string | No | Get aliases that would be rolled back for the given deployment | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | ## `list_bulk_redirect_versions` Get the version history for a project's redirects. ## Parameters | Parameter | Type | Required | Description | | ----------- | ------ | -------- | --------------- | | `projectId` | string | Yes | The project ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | ## `list_bulk_redirects` Gets project-level redirects. ## Parameters | Parameter | Type | Required | Description | | ----------- | ----------------- | -------- | ------------------------------------------------------------ | | `projectId` | string | Yes | The project ID. | | `versionId` | string | No | - | | `q` | string | No | - | | `diff` | boolean | string | No | - | | `page` | integer | No | - | | `perPage` | integer | No | - | | `sortBy` | string | No | Allowed values: `"source"`, `"destination"`, `"statusCode"`. | | `sortOrder` | string | No | Allowed values: `"asc"`, `"desc"`. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | ## `list_deployment_aliases` List Deployment Aliases. ## Parameters | Parameter | Type | Required | Description | | --------- | ------ | -------- | --------------------------------------------------------- | | `id` | string | Yes | The ID of the deployment the aliases should be listed for | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | ## `list_project_route_versions` Get routing rule version history. ## Parameters | Parameter | Type | Required | Description | | ----------- | ------ | -------- | --------------- | | `projectId` | string | Yes | The project ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | ## `list_project_routes` Get project routing rules. ## Parameters | Parameter | Type | Required | Description | | ----------- | ----------------- | -------- | ------------------------------------------------------------------------- | | `projectId` | string | Yes | The project ID. | | `versionId` | string | No | - | | `q` | string | No | - | | `filter` | string | No | Allowed values: `"rewrite"`, `"redirect"`, `"set_status"`, `"transform"`. | | `diff` | boolean | string | No | - | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | ## `patch_url_protection_bypass` Update the protection bypass for a URL. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `id` | string | Yes | The alias or deployment ID | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | ## `stage_redirects` Stages new redirects for a project. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | ## `stage_routes` Stage routing rules. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `projectId` | string | Yes | The project ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | Yes | Request body for this tool. | ## `update_route_versions` Promote, restore, or discard a routing rule version. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `projectId` | string | Yes | The project ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | ## `update_version` Promote a staging version to production or restore a previous production version. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `projectId` | string | Yes | The project ID. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | --- [View full sitemap](/docs/sitemap)