| name | gitlab-jobs |
| description | Manages GitLab CI jobs. Use for listing, logs, canceling, retrying, or erasing jobs. Triggers: CI builds, job status. |
Overview
Covers job execution and logs.
Available Tools
get_project_jobs: Retrieve a list of jobs for a specific GitLab project, optionally filtered by scope or a single job by id.- Parameters:
project_id(str): Optional. - Project ID or pathjob_id(Optional[int]): Optional. - Job IDscope(Optional[str]): Optional. - Filter jobs by scope (e.g., 'success', 'failed')include_retried(Optional[bool]): Optional. - Include retried jobsinclude_invisible(Optional[bool]): Optional. - Include invisible jobs (e.g., from hidden pipelines)
- Parameters:
get_project_job_log: Retrieve the log (trace) of a specific job in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathjob_id(int): Optional. - Job ID
- Parameters:
cancel_project_job: Cancel a specific job in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathjob_id(int): Optional. - Job IDctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
retry_project_job: Retry a specific job in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathjob_id(int): Optional. - Job IDctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
erase_project_job: Erase (delete artifacts and logs of) a specific job in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathjob_id(int): Optional. - Job IDctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
run_project_job: Run (play) a specific manual job in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathjob_id(int): Optional. - Job IDctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
get_pipeline_jobs: Retrieve a list of jobs for a specific pipeline in a GitLab project, optionally filtered by scope.- Parameters:
project_id(str): Optional. - Project ID or pathpipeline_id(int): Optional. - Pipeline IDscope(Optional[str]): Optional. - Filter jobs by scope (e.g., 'success', 'failed')
- Parameters:
Usage Instructions
- Use job_id for actions.
- Filters: scope, status.
Examples
- Get log:
get_project_job_logwith project_id="123", job_id=456. - Retry:
retry_project_jobwith project_id="123", job_id=456.
Error Handling
- Job not found: Verify IDs.