gitlab_pipeline_health
Read-onlyIdempotent
Assess pipeline stability by aggregating success rate over 7 and 30 days with a trend indicator for any branch or source, suitable for stand-ups and on-call hand-offs.
Instructions
Aggregate success rate over 7 and 30 days with a trend indicator.
Great for stand-ups and on-call hand-offs. Returns success rate %, totals,
last-10 statuses and a trend (up/down/flat).
Emits progress via the MCP Context (info log + report_progress) —
useful in IDEs that show per-tool progress bars.
Examples:
- "How stable is master" → default (ref='master', source='schedule')
- "Push-driven pipeline health" → source='push'
- Don't use for a single pipeline — use gitlab_get_pipeline.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Branch to analyse. | master |
| source | No | Pipeline source to include (typically 'schedule' or 'push'). | schedule |
| project_path | No | GitLab project path (e.g. 'my-org/my-repo'). When omitted, the default from GITLAB_PROJECT_PATH env var is used. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project | Yes | ||
| ref | Yes | ||
| source | Yes | ||
| rate_7d | Yes | ||
| rate_30d | Yes | ||
| trend | Yes | ||
| total_7d | Yes | ||
| success_7d | Yes | ||
| failed_7d | Yes | ||
| total_30d | Yes | ||
| success_30d | Yes | ||
| failed_30d | Yes | ||
| last_10_statuses | Yes | ||
| generated_at | Yes |