gitlab_list_pipelines

Retrieve and filter CI/CD pipeline runs by branch or status to monitor execution and identify failures. Provides pipeline details like ID, status, ref, SHA, creation time, and duration for informed workflow management.

Instructions

List CI/CD pipelines Returns: Pipeline runs with status Use when: Checking CI status, finding failures Filtering: By ref (branch), status

Statuses:

running: Currently executing
pending: Waiting to start
success: Passed
failed: Failed
canceled: Manually canceled
skipped: Skipped

Example response: [{ "id": 123456, "status": "success", "ref": "main", "sha": "abc123...", "created_at": "2024-01-15T10:00:00Z", "duration": 300 }]

Related tools:

gitlab_get_pipeline: Full pipeline details
gitlab_summarize_pipeline: AI-friendly summary

Input Schema

Name	Required	Description	Default
`project_id`	No	Project identifier (auto-detected if not provided) Type: integer OR string Format: numeric ID or 'namespace/project' Optional: Yes - auto-detects from current git repository Examples: - 12345 (numeric ID) - 'gitlab-org/gitlab' (namespace/project path) - 'my-group/my-subgroup/my-project' (nested groups) Note: If in a git repo with GitLab remote, this can be omitted
`ref`	No	Branch or tag name Type: string Format: Valid git reference name Optional: Yes Examples: - 'main' (main branch) - 'develop' (development branch) - 'feature/user-auth' (feature branch) - 'v1.0.0' (version tag) - 'release-2024.01' (release tag)

Input Schema (JSON Schema)

{
  "properties": {
    "project_id": {
      "description": "Project identifier (auto-detected if not provided)\nType: integer OR string\nFormat: numeric ID or 'namespace/project'\nOptional: Yes - auto-detects from current git repository\nExamples:\n  - 12345 (numeric ID)\n  - 'gitlab-org/gitlab' (namespace/project path)\n  - 'my-group/my-subgroup/my-project' (nested groups)\nNote: If in a git repo with GitLab remote, this can be omitted",
      "type": "string"
    },
    "ref": {
      "description": "Branch or tag name\nType: string\nFormat: Valid git reference name\nOptional: Yes\nExamples:\n  - 'main' (main branch)\n  - 'develop' (development branch)\n  - 'feature/user-auth' (feature branch)\n  - 'v1.0.0' (version tag)\n  - 'release-2024.01' (release tag)",
      "type": "string"
    }
  },
  "type": "object"
}

MCP GitLab Server