# job — gitlab

> 25 actions
> This page as plain markdown. Index: https://mcp.jmrp.io/llms.txt

Canonical: https://mcp.jmrp.io/servers/gitlab/actions/job/
Language: en
Alternate: https://mcp.jmrp.io/es/servers/gitlab/actions/job/index.md
Updated: 2026-09-11T09:56:41+02:00
License: https://mcp.jmrp.io/license/

Counted with a Free-tier token against gitlab.com, which is the only host this endpoint talks to: to use it against a self-managed instance, run the server yourself — its documentation covers that. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: higher tiers expose more actions, and administration domains only appear to tokens allowed to use them. That is why the figures differ elsewhere: the upstream project catalogues 1,006 actions across 162 domains, and 851 on the Free/CE surface, while this deployment publishes 747 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.

## Actions

### `job.artifacts` — Job Artifacts

_read-only_

Download the full artifact archive for a CI job (base64-encoded, truncated at 1MB). Returns: archive size, content, and truncation flag. See also: job.download_single_artifact, job.keep_artifacts, job.get.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.cancel` — Job Cancel

Cancel a CI job. Set force:true to cancel jobs already in a non-cancellable state (requires GitLab v17.2+). Returns: updated job state. See also: job.get, job.retry.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.delete_artifacts` — Job Delete Artifacts

_destructive_

Delete the artifacts for one CI job (destructive). Returns: a success confirmation. See also: job.artifacts, job.get, job.delete_project_artifacts.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.delete_project_artifacts` — Job Delete Project Artifacts

_destructive_

Delete every eligible artifact across a project (destructive, irreversible). Returns: a success confirmation. See also: job.delete_artifacts, job.list_project, job.artifacts.

**Required parameters:** `project_id (string)`

### `job.download_artifacts` — Job Download Artifacts

_read-only_

Download the latest successful artifacts archive for a ref and job name. Returns: archive size, content, and truncation flag. See also: job.artifacts, job.download_single_artifact, job.get.

**Required parameters:** `project_id (string)`

### `job.download_single_artifact` — Job Download Single Artifact

_read-only_

Download one artifact file from a job by job_id and artifact_path. Returns: file size, raw content, and truncation flag. See also: job.artifacts, job.download_artifacts, job.get.

**Required parameters:** `artifact_path (string)`, `job_id (integer)`, `project_id (string)`

### `job.download_single_artifact_by_ref` — Job Download Single Artifact By Ref

_read-only_

Download one artifact file from the latest successful job on a ref by name and path. Returns: file size, raw content, and truncation flag. See also: job.download_artifacts, job.download_single_artifact, job.get.

**Required parameters:** `artifact_path (string)`, `job (string)`, `project_id (string)`, `ref_name (string)`

### `job.erase` — Job Erase

_destructive_

Erase a finished CI job's trace log and artifacts (destructive). Returns: updated job state. See also: job.get, job.trace, job.artifacts.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.get` — Job Get

_read-only_

Get one CI job. Returns: status, stage, ref, embedded commit/pipeline/project/runner/user objects, timing fields, and failure metadata. See also: job.trace, job.cancel, job.retry.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.keep_artifacts` — Job Keep Artifacts

Keep a CI job's artifacts by clearing their expiration. Returns: updated job state. See also: job.artifacts, job.get, job.download_artifacts.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.list` — Job List

_read-only_

List CI jobs for one pipeline with status filters, keyset pagination, and ordering. Returns: job summaries with status, stage, ref, and pipeline association. See also: job.get, job.trace, pipeline.get.

**Required parameters:** `pipeline_id (integer)`, `project_id (string)`

### `job.list_bridges` — Job List Bridges

_read-only_

List CI bridge (trigger) jobs for one pipeline with keyset pagination. Returns: bridge summaries with status and downstream pipeline references. See also: job.list, pipeline.get, job.get.

**Required parameters:** `pipeline_id (integer)`, `project_id (string)`

### `job.list_project` — Job List Project

_read-only_

List CI jobs in one project with filters, keyset pagination, and ordering. Returns: job summaries, status, stage, ref, and pipeline associations. See also: job.get, job.trace, pipeline.get.

**Required parameters:** `project_id (string)`

### `job.play` — Job Play

Run a manual CI job with optional variable overrides. Returns: the started job state. See also: job.get, job.retry, job.trace.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.retry` — Job Retry

Retry a failed or canceled CI job. Returns: the newly created job state. See also: job.get, job.trace, job.cancel.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.token_scope_add_group` — Add Group Job Token Allowlist

Add a group to a project's CI/CD job token allowlist. Returns: the new allowlist entry with source project ID and target group ID. See also: job.token_scope_list_groups, job.token_scope_remove_group, job.token_scope_add_project.

**Required parameters:** `project_id (string)`, `target_group_id (integer)`

### `job.token_scope_add_project` — Add Project Job Token Allowlist

Add a project to a project's CI/CD job token inbound allowlist. Returns: the new allowlist entry with source and target project IDs. See also: job.token_scope_list_inbound, job.token_scope_remove_project, job.token_scope_add_group.

**Required parameters:** `project_id (string)`, `target_project_id (integer)`

### `job.token_scope_get` — Get Job Token Access Settings

_read-only_

Get a project's CI/CD job token access settings. Returns: whether inbound job token access is limited to the allowlist. See also: job.token_scope_patch, job.token_scope_list_inbound, job.token_scope_list_groups.

**Required parameters:** `project_id (string)`

### `job.token_scope_list_groups` — List Job Token Group Allowlist

_read-only_

List groups on a project's CI/CD job token allowlist. Returns: allowlisted groups with id, name, full path, and web URL plus pagination metadata. See also: job.token_scope_add_group, job.token_scope_remove_group, job.token_scope_get.

**Required parameters:** `project_id (string)`

### `job.token_scope_list_inbound` — List Job Token Inbound Allowlist

_read-only_

List projects on a project's CI/CD job token inbound allowlist. Returns: allowlisted projects with id, name, path, and web URL plus pagination metadata. See also: job.token_scope_add_project, job.token_scope_remove_project, job.token_scope_get.

**Required parameters:** `project_id (string)`

### `job.token_scope_patch` — Patch Job Token Access Settings

Update a project's CI/CD job token access settings. Returns: a confirmation that the inbound scope setting was updated. See also: job.token_scope_get, job.token_scope_add_project, job.token_scope_add_group.

**Required parameters:** `enabled (boolean)`, `project_id (string)`

### `job.token_scope_remove_group` — Remove Group Job Token Allowlist

_destructive_

Remove a group from a project's CI/CD job token allowlist. Returns: a success confirmation naming the removed group. See also: job.token_scope_list_groups, job.token_scope_add_group, job.token_scope_remove_project.

**Required parameters:** `project_id (string)`, `target_group_id (integer)`

### `job.token_scope_remove_project` — Remove Project Job Token Allowlist

_destructive_

Remove a project from a project's CI/CD job token inbound allowlist. Returns: a success confirmation naming the removed project. See also: job.token_scope_list_inbound, job.token_scope_add_project, job.token_scope_remove_group.

**Required parameters:** `project_id (string)`, `target_project_id (integer)`

### `job.trace` — Job Trace

_read-only_

Get CI job trace output. Returns: text log with truncation metadata when logs exceed limits. See also: job.get, job.retry, job.cancel.

**Required parameters:** `job_id (integer)`, `project_id (string)`

### `job.wait` — Job Wait

_read-only_

Wait for a CI job to finish, polling until terminal state or timeout. Returns: final job snapshot, wait duration, poll count, and timed-out flag. See also: job.get, job.trace, job.retry.

**Required parameters:** `job_id (integer)`, `project_id (string)`