gitlab_get_user_reported_issues
Retrieve all issues originally reported by a specific GitLab user to track reporting patterns, monitor resolution progress, and analyze user feedback across projects.
Instructions
List all issues created/reported by a specific user (including closed ones).
Shows issues where the user is the original reporter/creator. Use this tool to see what problems or requests a user has reported.
Examples:
Bug reporting patterns: get_user_reported_issues(user_id=123)
User feedback analysis
Historical issue creation
Find all issues originally created by the specified user across all accessible projects, with current status and resolution tracking.
For issues currently assigned to a user, use 'gitlab_get_user_open_issues' instead.
Returns reported issues with:
Issue details: title, description, current state
Progress tracking: assignees, resolution status
Timeline: creation, updates, resolution dates
Engagement: comments, watchers, related issues
Project context: where issue was reported
Use cases:
Track personal issue reporting patterns
Follow up on submitted problems
Monitor issue resolution progress
Generate user engagement reports
Parameters:
user_id: Numeric user ID
username: Username string (use either user_id or username)
state: Filter by state (opened, closed, all)
since: Issues created after date (YYYY-MM-DD)
until: Issues created before date (YYYY-MM-DD)
sort: Sort order (created, updated, closed)
per_page: Results per page (default: 20)
page: Page number (default: 1)
Example: Get recently reported issues
{
"username": "johndoe",
"state": "opened",
"since": "2024-01-01",
"sort": "created"
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | No | Numeric user ID | |
| username | No | Username string | |
| state | No | Filter by state | opened |
| since | No | Issues created after date (YYYY-MM-DD) | |
| until | No | Issues created before date (YYYY-MM-DD) | |
| sort | No | Sort order | created |
| per_page | No | Number of results per page Type: integer Range: 1-100 Default: 20 Example: 50 (for faster browsing) Tip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing | |
| page | No | Page number for pagination Type: integer Range: ≥1 Default: 1 Example: 3 (to get the third page of results) Note: Use with per_page to navigate large result sets |
Implementation Reference
- src/mcp_gitlab/tool_handlers.py:783-804 (handler)The core handler function that implements the tool logic. Parses arguments and calls the GitLabClient's get_user_reported_issues method to fetch issues reported by the user.
def handle_get_user_reported_issues(client: GitLabClient, arguments: Optional[Dict[str, Any]]) -> Dict[str, Any]: """Handle getting user's reported issues""" user_id = get_argument(arguments, "user_id") username = get_argument(arguments, "username") state = get_argument(arguments, "state", "opened") since = get_argument(arguments, "since") until = get_argument(arguments, "until") sort = get_argument(arguments, "sort", "created") per_page = get_argument(arguments, "per_page", DEFAULT_PAGE_SIZE) page = get_argument(arguments, "page", 1) return client.get_user_reported_issues( user_id=user_id, username=username, state=state, since=since, until=until, sort=sort, per_page=per_page, page=page ) - src/mcp_gitlab/tool_handlers.py:1083-1097 (registration)The TOOL_HANDLERS dictionary entry that registers the handler function for the tool name TOOL_GET_USER_REPORTED_ISSUES, used by the server to dispatch tool calls.
TOOL_GET_USER_REPORTED_ISSUES: handle_get_user_reported_issues, TOOL_GET_USER_RESOLVED_ISSUES: handle_get_user_resolved_issues, # User's Code & Commits handlers TOOL_GET_USER_COMMITS: handle_get_user_commits, TOOL_GET_USER_MERGE_COMMITS: handle_get_user_merge_commits, TOOL_GET_USER_CODE_CHANGES_SUMMARY: handle_get_user_code_changes_summary, TOOL_GET_USER_SNIPPETS: handle_get_user_snippets, # User's Comments & Discussions handlers TOOL_GET_USER_ISSUE_COMMENTS: handle_get_user_issue_comments, TOOL_GET_USER_MR_COMMENTS: handle_get_user_mr_comments, TOOL_GET_USER_DISCUSSION_THREADS: handle_get_user_discussion_threads, TOOL_GET_USER_RESOLVED_THREADS: handle_get_user_resolved_threads, } - The tool schema definition including input validation schema and description reference.
name=TOOL_GET_USER_REPORTED_ISSUES, description=desc.DESC_GET_USER_REPORTED_ISSUES, inputSchema={ "type": "object", "properties": { "username": {"type": "string", "description": "Username string"}, "state": {"type": "string", "description": "Issue state", "enum": ["opened", "closed", "all"], "default": "opened"}, "since": {"type": "string", "description": "Issues created after date (YYYY-MM-DD)"}, "per_page": {"type": "integer", "description": desc.DESC_PER_PAGE, "default": DEFAULT_PAGE_SIZE, "minimum": 1, "maximum": MAX_PAGE_SIZE}, "page": {"type": "integer", "description": desc.DESC_PAGE_NUMBER, "default": 1, "minimum": 1} }, "required": ["username"] } - src/mcp_gitlab/server.py:1079-1094 (registration)Explicit tool registration in server.list_tools() method, defining the tool schema for MCP protocol.
name=TOOL_GET_USER_REPORTED_ISSUES, description=desc.DESC_GET_USER_REPORTED_ISSUES, inputSchema={ "type": "object", "properties": { "user_id": {"type": "string", "description": "Numeric user ID"}, "username": {"type": "string", "description": "Username string"}, "state": {"type": "string", "description": "Filter by state", "enum": ["opened", "closed", "all"], "default": "opened"}, "since": {"type": "string", "description": "Issues created after date (YYYY-MM-DD)"}, "until": {"type": "string", "description": "Issues created before date (YYYY-MM-DD)"}, "sort": {"type": "string", "description": "Sort order", "enum": ["created", "updated", "closed"], "default": "created"}, "per_page": {"type": "integer", "description": desc.DESC_PER_PAGE, "default": DEFAULT_PAGE_SIZE, "minimum": 1, "maximum": MAX_PAGE_SIZE}, "page": {"type": "integer", "description": desc.DESC_PAGE_NUMBER, "default": 1, "minimum": 1} } } ), - src/mcp_gitlab/constants.py:261-261 (helper)Constant defining the exact tool name string used throughout the codebase.
TOOL_GET_USER_REPORTED_ISSUES = "gitlab_get_user_reported_issues"