Home / Servers / Vercel API / get_deployments

List deployments

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

List deployments under the authenticated user or team. If a deployment hasn't finished uploading (is incomplete), the url property will have a value of null. [GET /v7/deployments]

Name on the gateway: vercel_api__get_deployments · read-only.

Parameters

NameTypeDescription
appstringName of the deployment.
fromnumberGets the deployment created after this Date timestamp. (default: current time)
limitnumberMaximum number of deployments to list from a request.
projectIdstringFilter deployments from the given ID or name.
projectIdsarrayFilter deployments from the given project IDs. Cannot be used when projectId…
targetstringFilter deployments based on the environment.
tonumberGets the deployment created before this Date timestamp. (default: current time)
usersstringFilter out deployments based on users who have created the deployment.
sincenumberGet Deployments created after this JavaScript timestamp.
untilnumberGet Deployments created before this JavaScript timestamp.
statestringFilter deployments based on their state (BUILDING, ERROR, INITIALIZING…
rollbackCandidatebooleanFilter deployments based on their rollback candidacy
branchstringFilter deployments based on the branch name
shastringFilter deployments based on the SHA
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__get_deployments",
  "arguments": {}
}

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 list deployments tool with app set to ….

More from Vercel API