get_project_merge_requests
Retrieve merge requests from a GitLab project to review code changes, filter by state, and analyze pending or completed merges for code review workflows.
Instructions
Get all merge requests for a project.
Args:
project_id: The GitLab project ID or URL-encoded path
state: Filter merge requests by state (all, opened, closed, merged, or locked)
limit: Maximum number of merge requests to return
Returns:
List of merge request objects
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| state | No | all | |
| limit | No |
Input Schema (JSON Schema)
{
"properties": {
"limit": {
"default": 20,
"title": "Limit",
"type": "integer"
},
"project_id": {
"title": "Project Id",
"type": "string"
},
"state": {
"default": "all",
"title": "State",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
}
Implementation Reference
- server.py:376-393 (handler)The handler function decorated with @mcp.tool(), which registers and implements the get_project_merge_requests tool. It retrieves a list of merge requests for the specified GitLab project, filtered by state and limited in number, using the GitLab API.@mcp.tool() def get_project_merge_requests(ctx: Context, project_id: str, state: str = "all", limit: int = 20) -> List[Dict[str, Any]]: """ Get all merge requests for a project. Args: project_id: The GitLab project ID or URL-encoded path state: Filter merge requests by state (all, opened, closed, merged, or locked) limit: Maximum number of merge requests to return Returns: List of merge request objects """ gl = ctx.request_context.lifespan_context project = gl.projects.get(project_id) mrs = project.mergerequests.list(state=state, per_page=limit) return [mr.asdict() for mr in mrs]