open_deployments
Show deployments in a live card with expandable build logs. In clients without app support, receive the deployment state, preview URL, and commit as text. Track the latest deployment for a branch or commit until the build finishes.
This tool appears when your connection enables deployment cards. Pass a project ID or name, a repository URL, or a commit SHA. teamId can be omitted when the project identifies its team. Use branch and sha to track the source you just pushed. For repositories linked to multiple projects, select a project in the card. Calling the tool again refreshes the card.
The view parameter only accepts "preview". target filters production or preview deployments. A missing deployment is a separate state from a successful build.
Sample prompt: "Show the deployment for the branch and commit I just pushed."
| Parameter | Type | Required | Description |
|---|---|---|---|
view | string | No | The deployment card view. Value: "preview". |
teamId | string | No | The team ID or slug. Use the team that owns the resource. |
projectId | string | No | The project ID or name. Read projectId from .vercel/project.json when the repository has one. Without it, pass repo for a preview instead of guessing, or use a project name the user gave. Required unless a preview call has repo or sha. |
branch | string | No | The git branch name. |
sha | string | No | The full git commit SHA. |
repo | string | No | Preview only. The git remote URL or owner/name (git remote get-url origin). Finds the linked project when projectId is unknown, even before the deployment exists. |
target | string | No | Only consider deployments for this environment. Allowed values: "production", "preview". |
Was this helpful?