Home / Servers / Vercel API / list_promote_aliases

Gets a list of aliases with status for the current promote

An MCP tool from the Vercel API server, hosted on mcp.hjlabs.in.

Gets a list of aliases with status for the current promote Get a list of aliases related to the last promote request with their mapping status [GET /v1/projects/{projectId}/promote/aliases]

Name on the gateway: vercel_api__list_promote_aliases · read-only.

Parameters

NameTypeDescription
projectId requiredstringprojectId parameter
limitnumberMaximum number of aliases to list from a request (max 100).
sincenumberGet aliases created after this epoch timestamp.
untilnumberGet aliases created before this epoch timestamp.
failedOnlybooleanFilter results down to aliases that failed to map to the requested deployment
teamIdstringThe Team identifier to perform the request on behalf of.
slugstringThe Team slug to perform the request on behalf of.

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "vercel_api__list_promote_aliases",
  "arguments": {
    "projectId": "…"
  }
}

Or connect the Vercel API server directly, which lists 472 tools including this one:

Run in your terminal
claude mcp add --transport http hj-vercel-api https://mcp.hjlabs.in/mcp/vercel-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the gets a list of aliases with status for the current promote tool with projectId set to ….

More from Vercel API