gitlab-commits

Overview

This skill covers commit operations via MCP. Use for code changes, diffs, or discussions.

Available Tools

• •get_commits: Get commits in a GitLab project, optionally filtered.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (Optional[str]): Optional. - Commit SHA
    • •ref_name (Optional[str]): Optional. - Branch, tag, or commit SHA to filter commits
    • •since (Optional[str]): Optional. - Only commits after this date (ISO 8601 format)
    • •until (Optional[str]): Optional. - Only commits before this date (ISO 8601 format)
    • •path (Optional[str]): Optional. - Only commits that include this file path
    • •all (Optional[bool]): Optional. - Include all commits across all branches
• •create_commit: Create a new commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •branch (str): Optional. - Branch name for the commit
    • •commit_message (str): Optional. - Commit message
    • •actions (List[Dict[str, str]]): Optional. - List of actions (create/update/delete files)
    • •author_email (Optional[str]): Optional. - Author email for the commit
    • •author_name (Optional[str]): Optional. - Author name for the commit
• •get_commit_diff: Get the diff of a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •revert_commit: Revert a commit in a target branch in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA to revert
    • •branch (str): Optional. - Target branch to apply the revert
    • •dry_run (Optional[bool]): Optional. - Simulate the revert without applying
• •get_commit_comments: Retrieve comments on a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •create_commit_comment: Create a new comment on a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •note (str): Optional. - Content of the comment
    • •path (Optional[str]): Optional. - File path to associate with the comment
    • •line (Optional[int]): Optional. - Line number in the file for the comment
    • •line_type (Optional[str]): Optional. - Type of line ('new' or 'old')
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •get_commit_discussions: Retrieve discussions (threaded comments) on a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •get_commit_statuses: Retrieve build/CI statuses for a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •ref (Optional[str]): Optional. - Filter statuses by reference (branch or tag)
    • •stage (Optional[str]): Optional. - Filter statuses by CI stage
    • •name (Optional[str]): Optional. - Filter statuses by job name
    • •coverage (Optional[bool]): Optional. - Include coverage information
    • •all (Optional[bool]): Optional. - Include all statuses
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •post_build_status_to_commit: Post a build/CI status to a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •state (str): Optional. - State of the build (e.g., 'pending', 'running', 'success', 'failed')
    • •target_url (Optional[str]): Optional. - URL to link to the build
    • •context (Optional[str]): Optional. - Context of the status (e.g., 'ci/build')
    • •description (Optional[str]): Optional. - Description of the status
    • •coverage (Optional[float]): Optional. - Coverage percentage
    • •pipeline_id (Optional[int]): Optional. - ID of the associated pipeline
    • •ref (Optional[str]): Optional. - Reference (branch or tag) for the status
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •get_commit_merge_requests: Retrieve merge requests associated with a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •get_commit_gpg_signature: Retrieve the GPG signature for a specific commit in a GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •commit_hash (str): Optional. - Commit SHA
    • •ctx (Optional[Context]): Optional. - MCP context for progress

Usage Instructions

1. •Use project_id and commit_hash for specifics.
2. •For creation, build actions list (e.g., [{"action": "create", "file_path": "file.txt", "content": "..."}]).
3. •Async tools (e.g., delete) support progress via ctx.

Examples

• •List commits: get_commits with project_id="123", ref_name="main", since="2023-01-01".
• •Create: create_commit with project_id="123", branch="feature", commit_message="Add file", actions=[...].
• •Revert: revert_commit with project_id="123", commit_hash="abc123", branch="main".

Error Handling

• •Invalid ref: Check branch/SHA existence first.
• •Conflicts: Use diff tools to resolve.

Reference tools-reference.md for schemas.