gitlab_get_merge_request_approvals
Check merge request approval status on GitLab to determine if it can be merged. Returns required approvals, remaining approvals, and who has approved.
Instructions
Check MR approval status Returns: Approval requirements and current state Use when: Checking if MR can be merged Shows: Required approvals, who approved
Example response: { "approvals_required": 2, "approvals_left": 1, "approved_by": [ {"user": {"username": "johndoe"}} ], "approval_rules": [...] }
Related tools:
gitlab_approve_merge_request: Add approval
gitlab_merge_merge_request: Merge when ready
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mr_iid | Yes | Merge request number (IID - Internal ID) Type: integer Format: Project-specific MR number (without !) Required: Yes Examples: - 456 (for MR !456) - 7890 (for MR !7890) How to find: Look at MR URL or title - URL: https://gitlab.com/group/project/-/merge_requests/456 → use 456 - Title: "Add new feature (!456)" → use 456 Note: This is NOT the global MR ID | |
| 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 |
Implementation Reference
- src/mcp_gitlab/tool_handlers.py:356-362 (handler)The handler function that executes the tool logic by calling the GitLab client's get_merge_request_approvals method with resolved project_id and mr_iid.def handle_get_merge_request_approvals(client: GitLabClient, arguments: Optional[Dict[str, Any]]) -> Dict[str, Any]: """Handle getting merge request approvals""" project_id = require_project_id(client, arguments) mr_iid = require_argument(arguments, "mr_iid") return client.get_merge_request_approvals(project_id, mr_iid)
- The input schema definition for the tool, specifying project_id (string) and required mr_iid (integer).name=TOOL_GET_MR_APPROVALS, description=desc.DESC_GET_MR_APPROVALS, inputSchema={ "type": "object", "properties": { "project_id": {"type": "string", "description": desc.DESC_PROJECT_ID}, "mr_iid": {"type": "integer", "description": desc.DESC_MR_IID} }, "required": ["mr_iid"] } ),
- src/mcp_gitlab/tool_handlers.py:1036-1036 (registration)Registration of the tool name to its handler function in the TOOL_HANDLERS dictionary.TOOL_GET_MR_APPROVALS: handle_get_merge_request_approvals,
- src/mcp_gitlab/constants.py:221-221 (helper)Constant definition for the tool name used across the codebase.TOOL_GET_MR_APPROVALS = "gitlab_get_merge_request_approvals"