--- title: Vercel CI product: vercel url: /docs/agent-resources/vercel-mcp/tools/vercel-ci canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/vercel-ci" 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 CI invocations, jobs, tasks, and logs. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Vercel CI Inspect Vercel CI invocations, attempts, jobs, tasks, and logs for your team. Use `retry_vercel_ci_invocation` to retry an invocation. ## `get_vercel_ci_invocation` Inspect a Vercel CI invocation attempt, including its status and conclusion. ## Parameters | Parameter | Type | Required | Description | | -------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `get_vercel_ci_invocation_logs` Read logs for a Vercel CI invocation attempt. ## Parameters | Parameter | Type | Required | Description | | -------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `level` | Array\ | No | Only return log lines with one of these levels. Allowed values: `"trace"`, `"debug"`, `"command"`, `"info"`, `"warn"`, `"error"`, `"systemError"`, `"fatal"`. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `get_vercel_ci_invocation_tree` Returns an invocation attempt together with every job definition, its latest job run, and the task definitions and active task runs of that job run. Defaults to the latest attempt when `attempt` is omitted. With `follow=1` the response is a newline-delimited JSON stream: a `{"type":"tree", ...}` event with the full tree is sent immediately and again whenever it changes, and a final `{"type":"end","reason":...}` event is sent when the attempt finishes (`completed`) or the stream reaches its maximum duration (`timeout`), after which clients should reconnect. ## Parameters | Parameter | Type | Required | Description | | -------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | No | Invocation attempt to return. Defaults to the latest attempt. | | `follow` | number | No | When 1, stream the tree as newline-delimited JSON until the attempt finishes. Allowed values: `0`, `1`. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `get_vercel_ci_job_definition` Inspect a job definition within a Vercel CI invocation attempt. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `jobDefinitionId` | string | Yes | The job definition ID. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `get_vercel_ci_job_run` Inspect a job run within a Vercel CI invocation attempt. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `jobDefinitionId` | string | Yes | The job definition ID. | | `runAttempt` | string | Yes | The job run attempt number. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `get_vercel_ci_job_run_logs` Read logs for a Vercel CI job run. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `jobDefinitionId` | string | Yes | The job definition ID. | | `runAttempt` | string | Yes | The job run attempt number. | | `follow` | number | No | Allowed values: `0`, `1`. | | `since` | number | No | - | | `level` | Array\ | No | Only return log lines with one of these levels. Allowed values: `"trace"`, `"debug"`, `"command"`, `"info"`, `"warn"`, `"error"`, `"systemError"`, `"fatal"`. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `get_vercel_ci_task_logs` Returns log lines for the tasks of an invocation attempt in a single request, grouped by task. Tasks can be narrowed by name and by conclusion, for example `conclusion=failed` to fetch only the logs of failed tasks. ## Parameters | Parameter | Type | Required | Description | | -------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `task` | Array\ | No | Only return tasks with one of these names (e.g., "web#test"). | | `conclusion` | Array\ | No | Only return completed tasks with one of these conclusions. Allowed values: `"succeeded"`, `"cached"`, `"failed"`, `"skipped"`. | | `level` | Array\ | No | Only return log lines with one of these levels. Allowed values: `"trace"`, `"debug"`, `"command"`, `"info"`, `"warn"`, `"error"`, `"systemError"`, `"fatal"`. | | `limit` | number | No | Maximum number of tasks to return (default: 10, max: 25). | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `get_vercel_ci_task_run_logs` Get Task Run Logs With `follow=1` the response is a newline-delimited JSON stream of log lines that ends once the task run has finished and its logs are flushed, or when the stream reaches its maximum duration. ## Parameters | Parameter | Type | Required | Description | | ------------------ | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `jobDefinitionId` | string | Yes | The job definition ID. | | `runAttempt` | string | Yes | The job run attempt number. | | `taskDefinitionId` | string | Yes | The task definition ID. | | `taskRunAttempt` | string | Yes | The task run attempt number. | | `follow` | number | No | When 1, stream log lines as newline-delimited JSON until the task run finishes. Allowed values: `0`, `1`. | | `since` | number | No | - | | `level` | Array\ | No | Only return log lines with one of these levels. Allowed values: `"trace"`, `"debug"`, `"command"`, `"info"`, `"warn"`, `"error"`, `"systemError"`, `"fatal"`. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `list_vercel_ci_invocation_attempts` List the attempts for a Vercel CI invocation. ## Parameters | Parameter | Type | Required | Description | | -------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `list_vercel_ci_invocations` List Vercel CI invocations for your team. Filter by repository, branch, status, or conclusion. ## Parameters | Parameter | Type | Required | Description | | ---------------- | ---------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `provider` | string | No | Repository provider (e.g., "github"). Allowed values: `"github"`, `"gitlab"`, `"bitbucket"`, `"vercel"`. | | `repository` | string | No | Repository slug (e.g., "vercel/next.js"). | | `branchName` | string | No | Branch name (e.g., "main"). | | `snapshot` | string | No | Snapshot/commit hash. | | `status` | Array\ | No | Allowed values: `"new"`, `"skipped"`, `"bootstrapping"`, `"bootstrapping_failed"`, `"snapshotted"`, `"sandbox_named"`, `"jobs_on_hive_clone_dispatched"`, `"jobs_on_hive_dispatched"`, `"jobs_on_hive_completed"`, `"jobs_on_hive_failed"`, `"awaiting_jobs"`, `"completed"`. | | `conclusion` | Array\ | No | Allowed values: `"succeeded"`, `"failed"`, `"skipped"`. | | `source` | Array\ | No | Allowed values: `"vercel-ci"`, `"vercel-native-checks"`. | | `authorGitHubId` | string | No | - | | `author` | string | No | GitHub author login. | | `createdAfter` | number | No | - | | `createdBefore` | number | No | - | | `limit` | number | No | Number of results per page (default: 20, max: 100). | | `cursor` | string | No | Pagination cursor from a previous response. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `list_vercel_ci_job_definitions` List job definitions for a Vercel CI invocation attempt. ## Parameters | Parameter | Type | Required | Description | | -------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `list_vercel_ci_job_runs` List runs of a job definition within a Vercel CI invocation attempt. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `jobDefinitionId` | string | Yes | The job definition ID. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `list_vercel_ci_task_definitions` List Task Definitions ## Parameters | Parameter | Type | Required | Description | | ----------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `jobDefinitionId` | string | Yes | The job definition ID. | | `runAttempt` | string | Yes | The job run attempt number. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `list_vercel_ci_task_runs` List task runs within a Vercel CI job run. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ------ | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `jobDefinitionId` | string | Yes | The job definition ID. | | `runAttempt` | string | Yes | The job run attempt number. | | `taskRunAttempt` | string | No | The task run attempt number. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | ## `retry_vercel_ci_invocation` Retry a terminal Vercel CI invocation attempt identified by invocationId and attempt. Starts another attempt. inspect its state to determine whether it completes successfully. Retry support depends on the invocation source and terminal state. Native-check invocations can return `retry_not_supported`. A successful retry starts another attempt. Inspect its status and logs before reporting the outcome. ## Parameters | Parameter | Type | Required | Description | | -------------- | ------- | -------- | ----------------------------------------------------------- | | `invocationId` | string | Yes | The Vercel CI invocation ID. | | `attempt` | string | Yes | The invocation attempt number. | | `teamId` | string | No | Team ID to use for this operation. | | `slug` | string | No | Team slug to use for this operation. Use instead of teamId. | | `requestBody` | unknown | No | Request body for this tool. | --- [View full sitemap](/docs/sitemap)