# runner — gitlab

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

Canonical: https://mcp.jmrp.io/servers/gitlab/actions/runner/
Language: en
Alternate: https://mcp.jmrp.io/es/servers/gitlab/actions/runner/index.md
Updated: 2026-09-22T21:41:36+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 765 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

### `runner.delete_by_token` — Runner Delete By Token

_destructive_

Delete a registered runner by its authentication token. Returns: a success confirmation. See also: runner.delete_registered, runner.remove.

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

### `runner.delete_registered` — Runner Delete Registered

_destructive_

Delete a registered runner by its numeric runner_id. Returns: a success confirmation. See also: runner.delete_by_token, runner.remove.

**Required parameters:** `runner_id (integer)`

### `runner.disable_project` — Runner Disable Project

_destructive_

Remove a runner assignment from a project by project_id and runner_id. Returns: a success confirmation. See also: runner.enable_project, runner.list_project.

**Required parameters:** `project_id (string|integer)`, `runner_id (integer)`

### `runner.enable_project` — Runner Enable Project

Assign an existing runner to a project by project_id and runner_id. Returns: the enabled runner. See also: runner.disable_project, runner.list_project.

**Required parameters:** `project_id (string|integer)`, `runner_id (integer)`

### `runner.get` — Runner Get

_read-only_

Get full configuration for one runner by numeric runner_id. Returns: runner details including tags, locked, access level, maximum timeout, contact time, and associated groups/projects. See also: runner.list, runner.update, runner.jobs.

**Required parameters:** `runner_id (integer)`

### `runner.jobs` — Runner Jobs

_read-only_

List jobs processed by a runner, with status/order/sort filters and pagination. Returns: jobs with id, name, status, stage, ref, and duration, plus pagination metadata. See also: runner.get, job.get.

**Required parameters:** `runner_id (integer)`

### `runner.list` — Runner List

_read-only_

List runners owned by the authenticated user, with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, paused/shared/online flags, plus pagination metadata. See also: runner.get, runner.list_all, runner.list_project.

### `runner.list_all` — Runner List All

_read-only_

List every runner on the instance (admin token required), with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.list, runner.get.

### `runner.list_group` — Runner List Group

_read-only_

List runners available in a group (specific and shared), with type/status/tag filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.list, runner.list_project.

**Required parameters:** `group_id (string|integer)`

### `runner.list_managers` — Runner List Managers

_read-only_

List the managers of a runner by runner_id. Returns: runner managers with system id, version, revision, platform, architecture, status, and IP. See also: runner.get, runner.list.

**Required parameters:** `runner_id (integer)`

### `runner.list_project` — Runner List Project

_read-only_

List runners assigned to a project, with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.enable_project, runner.disable_project, runner.list.

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

### `runner.register` — Runner Register

Register a new runner with a registration token, optional info hashmap, tags, and configuration. Returns: the created runner including its authentication token. See also: runner.verify, runner.list.

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

### `runner.remove` — Runner Remove

_destructive_

Remove (unregister) a runner by numeric runner_id. Returns: a success confirmation. See also: runner.disable_project, runner.delete_registered, runner.get.

**Required parameters:** `runner_id (integer)`

### `runner.reset_group_reg_token` — Runner Reset Group Reg Token

Reset a group's runner registration token by group_id (deprecated). Returns: the new registration token and its expiry. See also: runner.reset_instance_reg_token, runner.reset_project_reg_token.

**Required parameters:** `group_id (string|integer)`

### `runner.reset_instance_reg_token` — Runner Reset Instance Reg Token

Reset the instance-level runner registration token (deprecated, admin only). Returns: the new registration token and its expiry. See also: runner.reset_group_reg_token, runner.reset_project_reg_token.

### `runner.reset_project_reg_token` — Runner Reset Project Reg Token

Reset a project's runner registration token by project_id (deprecated). Returns: the new registration token and its expiry. See also: runner.reset_instance_reg_token, runner.reset_group_reg_token.

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

### `runner.reset_token` — Runner Reset Token

Reset a runner's authentication token by runner_id. Returns: the new token and its expiry. See also: runner.verify, runner.get.

**Required parameters:** `runner_id (integer)`

### `runner.update` — Runner Update

Update a runner's configuration (description, pause state, tags, locked, access level, timeout) by runner_id. Returns: the updated runner details. See also: runner.get, runner.remove.

**Required parameters:** `runner_id (integer)`

### `runner.verify` — Runner Verify

_read-only_

Verify that a runner authentication token is valid. Returns: a success confirmation when the token authenticates. See also: runner.register, runner.reset_token.

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