@zereight/mcp-gitlab 2.1.11 → 2.1.13

package/README.md

@@ -495,156 +495,158 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
 2. `create_or_update_file` - Create or update a single file in a GitLab project
 3. `search_repositories` - Search for GitLab projects
 4. `create_repository` - Create a new GitLab project
-5. `get_file_contents` - Get the contents of a file or directory from a GitLab project
-6. `push_files` - Push multiple files to a GitLab project in a single commit
-7. `create_issue` - Create a new issue in a GitLab project
-8. `create_merge_request` - Create a new merge request in a GitLab project
-9. `fork_repository` - Fork a GitLab project to your account or specified namespace
-10. `create_branch` - Create a new branch in a GitLab project
-11. `get_merge_request` - Get details of a merge request with compact deployment summary, behind-count, commit addition summary, and approval summary (Either mergeRequestIid or branchName must be provided)
-12. `get_merge_request_diffs` - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)
-13. `list_merge_request_diffs` - List merge request diffs with pagination support (Either mergeRequestIid or branchName must be provided)
-14. `get_merge_request_conflicts` - Get the conflicts of a merge request in a GitLab project
-15. `list_merge_request_changed_files` - STEP 1 of code review workflow. Returns ONLY the list of changed file paths in a merge request — WITHOUT diff content. Call this first to get file paths, then call get_merge_request_file_diff with multiple files in a single batched call (recommended 3-5 files per call). Supports excluded_file_patterns filtering using regex. (Either mergeRequestIid or branchName must be provided)
-16. `get_merge_request_file_diff` - STEP 2 of code review workflow. Get diffs for one or more files from a merge request. Call list_merge_request_changed_files first, then pass them as an array to fetch diffs efficiently. Batching multiple files (recommended 3-5) is supported. (Either mergeRequestIid or branchName must be provided)
-17. `list_merge_request_versions` - List all versions of a merge request
-18. `get_merge_request_version` - Get a specific version of a merge request
-19. `get_branch_diffs` - Get the changes/diffs between two branches or commits in a GitLab project
-20. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
-21. `create_note` - Create a new note (comment) to an issue or merge request
-22. `create_merge_request_thread` - Create a new thread on a merge request
-23. `mr_discussions` - List discussion items for a merge request
-24. `resolve_merge_request_thread` - Resolve a thread on a merge request
-25. `update_merge_request_note` - Modify an existing merge request thread note
-26. `create_merge_request_note` - Add a new note to an existing merge request thread
-27. `delete_merge_request_discussion_note` - Delete a discussion note on a merge request
-28. `update_merge_request_discussion_note` - Update a discussion note on a merge request
-29. `create_merge_request_discussion_note` - Add a new discussion note to an existing merge request thread
-30. `delete_merge_request_note` - Delete an existing merge request note
-31. `get_merge_request_note` - Get a specific note for a merge request
-32. `get_merge_request_notes` - List notes for a merge request
-33. `get_draft_note` - Get a single draft note from a merge request
-34. `list_draft_notes` - List draft notes for a merge request
-35. `create_draft_note` - Create a draft note for a merge request
-36. `update_draft_note` - Update an existing draft note
-37. `delete_draft_note` - Delete a draft note
-38. `publish_draft_note` - Publish a single draft note
-39. `bulk_publish_draft_notes` - Publish all draft notes for a merge request
-40. `list_merge_requests` - List merge requests globally or in a specific GitLab project with filtering options (project_id is now optional)
-41. `approve_merge_request` - Approve a merge request (requires appropriate permissions)
-42. `unapprove_merge_request` - Unapprove a previously approved merge request
-43. `get_merge_request_approval_state` - Get merge request approval details including approvers (uses `approval_state` when available, otherwise falls back to `approvals`)
-44. `update_issue_note` - Modify an existing issue thread note
-45. `create_issue_note` - Add a new note to an existing issue thread
-46. `list_issues` - List issues (default: created by current user only; use scope='all' for all accessible issues)
-47. `my_issues` - List issues assigned to the authenticated user (defaults to open issues)
-48. `get_issue` - Get details of a specific issue in a GitLab project
-49. `update_issue` - Update an issue in a GitLab project
-50. `delete_issue` - Delete an issue from a GitLab project
-51. `list_todos` - List GitLab to-do items for the current user
-52. `mark_todo_done` - Mark a GitLab to-do item as done
-53. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
-54. `list_issue_links` - List all issue links for a specific issue
-55. `list_issue_discussions` - List discussions for an issue in a GitLab project
-56. `get_issue_link` - Get a specific issue link
-57. `create_issue_link` - Create an issue link between two issues
-58. `delete_issue_link` - Delete an issue link
-59. `list_namespaces` - List all namespaces available to the current user
-60. `get_namespace` - Get details of a namespace by ID or path
-61. `verify_namespace` - Verify if a namespace path exists
-62. `get_project` - Get details of a specific project
-63. `list_projects` - List projects accessible by the current user
-64. `list_project_members` - List members of a GitLab project
-65. `list_group_projects` - List projects in a GitLab group with filtering options
-66. `list_group_iterations` - List group iterations with filtering options
-67. `list_labels` - List labels for a project
-68. `get_label` - Get a single label from a project
-69. `create_label` - Create a new label in a project
-70. `update_label` - Update an existing label in a project
-71. `delete_label` - Delete a label from a project
-72. `list_pipelines` - List pipelines in a GitLab project with filtering options
-73. `get_pipeline` - Get details of a specific pipeline in a GitLab project
-74. `list_pipeline_jobs` - List all jobs in a specific pipeline
-75. `list_pipeline_trigger_jobs` - List all trigger jobs (bridges) in a specific pipeline that trigger downstream pipelines
-76. `get_pipeline_job` - Get details of a GitLab pipeline job number
-77. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job with optional pagination to limit context window usage
-78. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
-79. `validate_project_ci_lint` - Validate an existing `.gitlab-ci.yml` configuration for a project
-80. `create_pipeline` - Create a new pipeline for a branch or tag
-81. `retry_pipeline` - Retry a failed or canceled pipeline
-82. `cancel_pipeline` - Cancel a running pipeline
-83. `play_pipeline_job` - Run a manual pipeline job
-84. `retry_pipeline_job` - Retry a failed or canceled pipeline job
-85. `cancel_pipeline_job` - Cancel a running pipeline job
-86. `list_deployments` - List deployments in a GitLab project with filtering options
-87. `get_deployment` - Get details of a specific deployment in a GitLab project
-88. `list_environments` - List environments in a GitLab project
-89. `get_environment` - Get details of a specific environment in a GitLab project
-90. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
-91. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
-92. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
-93. `list_milestones` - List milestones in a GitLab project with filtering options
-94. `get_milestone` - Get details of a specific milestone
-95. `create_milestone` - Create a new milestone in a GitLab project
-96. `edit_milestone` - Edit an existing milestone in a GitLab project
-97. `delete_milestone` - Delete a milestone from a GitLab project
-98. `get_milestone_issue` - Get issues associated with a specific milestone
-99. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
-100. `promote_milestone` - Promote a milestone to the next stage
-101. `get_milestone_burndown_events` - Get burndown events for a specific milestone
-102. `list_wiki_pages` - List wiki pages in a GitLab project
-103. `get_wiki_page` - Get details of a specific wiki page
-104. `create_wiki_page` - Create a new wiki page in a GitLab project
-105. `update_wiki_page` - Update an existing wiki page in a GitLab project
-106. `delete_wiki_page` - Delete a wiki page from a GitLab project
-107. `list_group_wiki_pages` - List wiki pages in a GitLab group
-108. `get_group_wiki_page` - Get details of a specific group wiki page
-109. `create_group_wiki_page` - Create a new wiki page in a GitLab group
-110. `update_group_wiki_page` - Update an existing wiki page in a GitLab group
-111. `delete_group_wiki_page` - Delete a wiki page from a GitLab group
-112. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
-113. `list_commits` - List repository commits with filtering options
-114. `get_commit` - Get details of a specific commit
-115. `get_commit_diff` - Get changes/diffs of a specific commit
-116. `list_commit_statuses` - List statuses for a specific commit
-117. `create_commit_status` - Create or update the status of a specific commit
-118. `list_releases` - List all releases for a project
-119. `get_release` - Get a release by tag name
-120. `create_release` - Create a new release in a GitLab project
-121. `update_release` - Update an existing release in a GitLab project
-122. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
-123. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
-124. `download_release_asset` - Download a release asset file by direct asset path
-125. `list_tags` - List repository tags with filtering and pagination support
-126. `get_tag` - Get details of a specific repository tag
-127. `create_tag` - Create a new tag in the repository
-128. `delete_tag` - Delete a tag from the repository
-129. `get_tag_signature` - Get the signature of a signed tag
-130. `get_users` - Get GitLab user details by usernames
-131. `list_events` - List all events for the currently authenticated user
-132. `get_project_events` - List all visible events for a specified project
-133. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
-134. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
-135. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
-136. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
-137. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
-138. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
-139. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
-140. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
-141. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
-142. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
-143. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
-144. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
-145. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
-146. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
-147. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
-148. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
-149. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
-150. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
-151. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
-152. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
-153. `execute_graphql` - Execute a GitLab GraphQL query
-154. `list_merge_request_pipelines` - List pipelines for a merge request with pagination support
+5. `create_group` - Create a new GitLab group or subgroup (name, path, description, visibility, and optional parent_id)
+6. `get_file_contents` - Get the contents of a file or directory from a GitLab project
+7. `push_files` - Push multiple files to a GitLab project in a single commit
+8. `create_issue` - Create a new issue in a GitLab project
+9. `create_merge_request` - Create a new merge request in a GitLab project
+10. `fork_repository` - Fork a GitLab project to your account or specified namespace
+11. `create_branch` - Create a new branch in a GitLab project
+12. `get_merge_request` - Get details of a merge request with compact deployment summary, behind-count, commit addition summary, and approval summary (Either mergeRequestIid or branchName must be provided)
+13. `get_merge_request_diffs` - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)
+14. `list_merge_request_diffs` - List merge request diffs with pagination support (Either mergeRequestIid or branchName must be provided)
+15. `get_merge_request_conflicts` - Get the conflicts of a merge request in a GitLab project
+16. `list_merge_request_changed_files` - STEP 1 of code review workflow. Returns ONLY the list of changed file paths in a merge request — WITHOUT diff content. Call this first to get file paths, then call get_merge_request_file_diff with multiple files in a single batched call (recommended 3-5 files per call). Supports excluded_file_patterns filtering using regex. (Either mergeRequestIid or branchName must be provided)
+17. `get_merge_request_file_diff` - STEP 2 of code review workflow. Get diffs for one or more files from a merge request. Call list_merge_request_changed_files first, then pass them as an array to fetch diffs efficiently. Batching multiple files (recommended 3-5) is supported. (Either mergeRequestIid or branchName must be provided)
+18. `list_merge_request_versions` - List all versions of a merge request
+19. `get_merge_request_version` - Get a specific version of a merge request
+20. `get_branch_diffs` - Get the changes/diffs between two branches or commits in a GitLab project
+21. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)
+22. `create_note` - Create a new note (comment) to an issue or merge request
+23. `create_merge_request_thread` - Create a new thread on a merge request
+24. `mr_discussions` - List discussion items for a merge request
+25. `resolve_merge_request_thread` - Resolve a thread on a merge request
+26. `update_merge_request_note` - Modify an existing merge request thread note
+27. `create_merge_request_note` - Add a new note to an existing merge request thread
+28. `delete_merge_request_discussion_note` - Delete a discussion note on a merge request
+29. `update_merge_request_discussion_note` - Update a discussion note on a merge request
+30. `create_merge_request_discussion_note` - Add a new discussion note to an existing merge request thread
+31. `delete_merge_request_note` - Delete an existing merge request note
+32. `get_merge_request_note` - Get a specific note for a merge request
+33. `get_merge_request_notes` - List notes for a merge request
+34. `get_draft_note` - Get a single draft note from a merge request
+35. `list_draft_notes` - List draft notes for a merge request
+36. `create_draft_note` - Create a draft note for a merge request
+37. `update_draft_note` - Update an existing draft note
+38. `delete_draft_note` - Delete a draft note
+39. `publish_draft_note` - Publish a single draft note
+40. `bulk_publish_draft_notes` - Publish all draft notes for a merge request
+41. `list_merge_requests` - List merge requests globally or in a specific GitLab project with filtering options (project_id is now optional)
+42. `approve_merge_request` - Approve a merge request (requires appropriate permissions)
+43. `unapprove_merge_request` - Unapprove a previously approved merge request
+44. `get_merge_request_approval_state` - Get merge request approval details including approvers (uses `approval_state` when available, otherwise falls back to `approvals`)
+45. `update_issue_note` - Modify an existing issue thread note
+46. `create_issue_note` - Add a new note to an existing issue thread
+47. `list_issues` - List issues (default: created by current user only; use scope='all' for all accessible issues)
+48. `my_issues` - List issues assigned to the authenticated user (defaults to open issues)
+49. `get_issue` - Get details of a specific issue in a GitLab project
+50. `update_issue` - Update an issue in a GitLab project
+51. `update_issue_description_patch` - Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by sending only the change instead of the full description. Supports `dry_run` to preview and `create_note` to summarize.
+52. `delete_issue` - Delete an issue from a GitLab project
+53. `list_todos` - List GitLab to-do items for the current user
+54. `mark_todo_done` - Mark a GitLab to-do item as done
+55. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
+56. `list_issue_links` - List all issue links for a specific issue
+57. `list_issue_discussions` - List discussions for an issue in a GitLab project
+58. `get_issue_link` - Get a specific issue link
+59. `create_issue_link` - Create an issue link between two issues
+60. `delete_issue_link` - Delete an issue link
+61. `list_namespaces` - List all namespaces available to the current user
+62. `get_namespace` - Get details of a namespace by ID or path
+63. `verify_namespace` - Verify if a namespace path exists
+64. `get_project` - Get details of a specific project
+65. `list_projects` - List projects accessible by the current user
+66. `list_project_members` - List members of a GitLab project
+67. `list_group_projects` - List projects in a GitLab group with filtering options
+68. `list_group_iterations` - List group iterations with filtering options
+69. `list_labels` - List labels for a project
+70. `get_label` - Get a single label from a project
+71. `create_label` - Create a new label in a project
+72. `update_label` - Update an existing label in a project
+73. `delete_label` - Delete a label from a project
+74. `list_pipelines` - List pipelines in a GitLab project with filtering options
+75. `get_pipeline` - Get details of a specific pipeline in a GitLab project
+76. `list_pipeline_jobs` - List all jobs in a specific pipeline
+77. `list_pipeline_trigger_jobs` - List all trigger jobs (bridges) in a specific pipeline that trigger downstream pipelines
+78. `get_pipeline_job` - Get details of a GitLab pipeline job number
+79. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job with optional pagination to limit context window usage
+80. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
+81. `validate_project_ci_lint` - Validate an existing `.gitlab-ci.yml` configuration for a project
+82. `create_pipeline` - Create a new pipeline for a branch or tag
+83. `retry_pipeline` - Retry a failed or canceled pipeline
+84. `cancel_pipeline` - Cancel a running pipeline
+85. `play_pipeline_job` - Run a manual pipeline job
+86. `retry_pipeline_job` - Retry a failed or canceled pipeline job
+87. `cancel_pipeline_job` - Cancel a running pipeline job
+88. `list_deployments` - List deployments in a GitLab project with filtering options
+89. `get_deployment` - Get details of a specific deployment in a GitLab project
+90. `list_environments` - List environments in a GitLab project
+91. `get_environment` - Get details of a specific environment in a GitLab project
+92. `list_job_artifacts` - List artifact files in a job's artifacts archive. Returns file names, paths, types, and sizes
+93. `download_job_artifacts` - Download the entire artifact archive (zip) for a job to a local path. Returns the saved file path
+94. `get_job_artifact_file` - Get the content of a single file from a job's artifacts by its path within the archive
+95. `list_milestones` - List milestones in a GitLab project with filtering options
+96. `get_milestone` - Get details of a specific milestone
+97. `create_milestone` - Create a new milestone in a GitLab project
+98. `edit_milestone` - Edit an existing milestone in a GitLab project
+99. `delete_milestone` - Delete a milestone from a GitLab project
+100. `get_milestone_issue` - Get issues associated with a specific milestone
+101. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
+102. `promote_milestone` - Promote a milestone to the next stage
+103. `get_milestone_burndown_events` - Get burndown events for a specific milestone
+104. `list_wiki_pages` - List wiki pages in a GitLab project
+105. `get_wiki_page` - Get details of a specific wiki page
+106. `create_wiki_page` - Create a new wiki page in a GitLab project
+107. `update_wiki_page` - Update an existing wiki page in a GitLab project
+108. `delete_wiki_page` - Delete a wiki page from a GitLab project
+109. `list_group_wiki_pages` - List wiki pages in a GitLab group
+110. `get_group_wiki_page` - Get details of a specific group wiki page
+111. `create_group_wiki_page` - Create a new wiki page in a GitLab group
+112. `update_group_wiki_page` - Update an existing wiki page in a GitLab group
+113. `delete_group_wiki_page` - Delete a wiki page from a GitLab group
+114. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)
+115. `list_commits` - List repository commits with filtering options
+116. `get_commit` - Get details of a specific commit
+117. `get_commit_diff` - Get changes/diffs of a specific commit
+118. `list_commit_statuses` - List statuses for a specific commit
+119. `create_commit_status` - Create or update the status of a specific commit
+120. `list_releases` - List all releases for a project
+121. `get_release` - Get a release by tag name
+122. `create_release` - Create a new release in a GitLab project
+123. `update_release` - Update an existing release in a GitLab project
+124. `delete_release` - Delete a release from a GitLab project (does not delete the associated tag)
+125. `create_release_evidence` - Create release evidence for an existing release (GitLab Premium/Ultimate only)
+126. `download_release_asset` - Download a release asset file by direct asset path
+127. `list_tags` - List repository tags with filtering and pagination support
+128. `get_tag` - Get details of a specific repository tag
+129. `create_tag` - Create a new tag in the repository
+130. `delete_tag` - Delete a tag from the repository
+131. `get_tag_signature` - Get the signature of a signed tag
+132. `get_users` - Get GitLab user details by usernames
+133. `list_events` - List all events for the currently authenticated user
+134. `get_project_events` - List all visible events for a specified project
+135. `upload_markdown` - Upload a file to a GitLab project for use in markdown content
+136. `download_attachment` - Download an uploaded file from a GitLab project by secret and filename
+137. `get_work_item` - Get a single work item with full details including status, hierarchy (parent/children), type, labels, assignees, and all widgets
+138. `list_work_items` - List work items in a project with filters (type, state, search, assignees, labels). Returns items with status and hierarchy info
+139. `create_work_item` - Create a new work item (issue, task, incident, test_case, epic, key_result, objective, requirement, ticket). Supports setting title, description, labels, assignees, weight, parent, health status, start/due dates, milestone, and confidentiality
+140. `update_work_item` - Update a work item. Can modify title, description, labels, assignees, weight, state, status, parent hierarchy, children, health status, start/due dates, milestone, confidentiality, linked items, and custom fields
+141. `convert_work_item_type` - Convert a work item to a different type (e.g. issue to task, task to incident)
+142. `list_work_item_statuses` - List available statuses for a work item type in a project. Requires GitLab Premium/Ultimate with configurable statuses
+143. `list_custom_field_definitions` - List available custom field definitions for a work item type in a project. Returns field names, types, and IDs needed for setting custom fields via update_work_item
+144. `move_work_item` - Move a work item (issue, task, etc.) to a different project. Uses GitLab GraphQL issueMove mutation
+145. `list_work_item_notes` - List notes and discussions on a work item. Returns threaded discussions with author, body, timestamps, and system/internal flags
+146. `create_work_item_note` - Add a note/comment to a work item. Supports Markdown, internal notes, and threaded replies
+147. `get_timeline_events` - List timeline events for an incident. Returns chronological events with notes, timestamps, and tags
+148. `create_timeline_event` - Create a timeline event on an incident. Supports tags: 'Start time', 'End time', 'Impact detected', 'Response initiated', 'Impact mitigated', 'Cause identified'
+149. `list_webhooks` - List all configured webhooks for a GitLab project or group. Provide either project_id or group_id
+150. `list_webhook_events` - List recent webhook events (past 7 days) for a project or group webhook. Use summary mode for overview, then get_webhook_event for full details
+151. `get_webhook_event` - Get full details of a specific webhook event by ID, including request/response payloads
+152. `search_code` - Search for code across all projects on the GitLab instance (requires advanced search or exact code search to be enabled)
+153. `search_project_code` - Search for code within a specific GitLab project (requires advanced search or exact code search to be enabled)
+154. `search_group_code` - Search for code within a specific GitLab group (requires advanced search or exact code search to be enabled)
+155. `execute_graphql` - Execute a GitLab GraphQL query
+156. `list_merge_request_pipelines` - List pipelines for a merge request with pagination support
 
 <!-- TOOLS-END -->