@zereight/mcp-gitlab 2.3.18 โ†’ 2.3.19-next.194

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ko.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  ๐Ÿ“– **[๋ฌธ์„œ โ†’](https://zereight.github.io/gitlab-mcp/)** ยท [llms.txt](./llms.txt) ยท [llms-full.txt](./llms-full.txt)
8
8
 
9
- **๊ธฐ๋ณธ ๋…ธ์ถœ: 40๊ฐœ ๋„๊ตฌ** (`core` 38๊ฐœ + `discover_tools` + `help`). ์ „์ฒด๋Š” 287๊ฐœ(toolset 284๊ฐœ + `execute_graphql` + `discover_tools` + `help`). ์ž‘๊ฒŒ ์‹œ์ž‘ํ•˜๊ณ , ์„ธ์…˜์—์„œ `discover_tools`๋กœ ํ™•์žฅํ•˜์„ธ์š”.
9
+ **๊ธฐ๋ณธ ๋…ธ์ถœ: 40๊ฐœ ๋„๊ตฌ** (`core` 38๊ฐœ + `discover_tools` + `help`). ์ „์ฒด๋Š” 288๊ฐœ(toolset 285๊ฐœ + `execute_graphql` + `discover_tools` + `help`). ์ž‘๊ฒŒ ์‹œ์ž‘ํ•˜๊ณ , ์„ธ์…˜์—์„œ `discover_tools`๋กœ ํ™•์žฅํ•˜์„ธ์š”.
10
10
 
11
11
  `zereight-mcp-gitlab` ๋ฐ”์ด๋„ˆ๋ฆฌ๋ฅผ ๋จผ์ € ์„ค์น˜ํ•˜์„ธ์š”. `npm install -g @zereight/mcp-gitlab`, ๋˜๋Š” Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` ๋‹ค์Œ `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. ๊ณต์‹ MCP Registry ํ•ญ๋ชฉ: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). ํ•œ ์ค„ ์„ค์น˜: `npx -y @zereight/mcp-gitlab@latest`.
12
12
 
@@ -138,7 +138,7 @@ PAT, OAuth, ์ฝ๊ธฐ ์ „์šฉ ๋ชจ๋“œ, ๋™์  API URL, ์›๊ฒฉ ์ธ์ฆ์„ ์ง€์›ํ•˜๋ฉฐ
138
138
 
139
139
  ### ์™œ ์ด GitLab MCP๋ฅผ ์‚ฌ์šฉํ•˜๋‚˜์š”?
140
140
 
141
- - **๊ธฐ๋ณธ 40๊ฐœ ๋„๊ตฌ(`core` 38 + `discover_tools` + `help`); ์ „์ฒด 287๊ฐœ** โ€” ์ž‘๊ฒŒ ์‹œ์ž‘ํ•˜๊ณ , `discover_tools`๋กœ ์„ธ์…˜์—์„œ ํ™•์žฅ
141
+ - **๊ธฐ๋ณธ 40๊ฐœ ๋„๊ตฌ(`core` 38 + `discover_tools` + `help`); ์ „์ฒด 288๊ฐœ** โ€” ์ž‘๊ฒŒ ์‹œ์ž‘ํ•˜๊ณ , `discover_tools`๋กœ ์„ธ์…˜์—์„œ ํ™•์žฅ
142
142
  - **MR 2๋‹จ๊ณ„ ๋ฆฌ๋ทฐ** โ€” `list_merge_request_changed_files` โ†’ ๋ฐฐ์น˜ `get_merge_request_file_diff`
143
143
  - **Agent Skill ๋‚ด์žฅ** โ€” `skills/gitlab-mcp/` ์›Œํฌํ”Œ๋กœ์šฐ ๊ฐ€์ด๋“œ
144
144
  - **์œ ์—ฐํ•œ ์ธ์ฆ** โ€” Personal Access Token, ๋กœ์ปฌ OAuth2 ๋ธŒ๋ผ์šฐ์ € ํ”Œ๋กœ์šฐ, MCP OAuth ํ”„๋ก์‹œ, ์š”์ฒญ๋ณ„ ์›๊ฒฉ ์ธ์ฆ
@@ -152,7 +152,7 @@ PAT, OAuth, ์ฝ๊ธฐ ์ „์šฉ ๋ชจ๋“œ, ๋™์  API URL, ์›๊ฒฉ ์ธ์ฆ์„ ์ง€์›ํ•˜๋ฉฐ
152
152
  | | @zereight/mcp-gitlab | GitLab MCP A (์ปค๋ฎค๋‹ˆํ‹ฐ CQRSํ˜•) | GitLab ๊ณต์‹ MCP ์„œ๋ฒ„ |
153
153
  | --------------- | ---------------------------------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
154
154
  | **์ ํ•ฉํ•œ ๊ฒฝ์šฐ** | AI ์—์ด์ „ํŠธ ์›Œํฌํ”Œ๋กœ์šฐ | ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ๋ฉ€ํ‹ฐ ์ธ์Šคํ„ด์Šค / ๊ทธ๋ฃนํ˜• ๋„๊ตฌ | GitLab์— ๋‚ด์žฅ, ๋ณ„๋„ ์„ค์น˜ ์—†์Œ |
155
- | **๋„๊ตฌ ๋ชจ๋ธ** | 287๊ฐœ ๋„๊ตฌ: toolset 284๊ฐœ + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60๊ฐœ `browse_*` / `manage_*` ๊ทธ๋ฃน ๋„๊ตฌ | HTTP ํ—ค๋”๋กœ ๊ณ ๋ฅด๋Š” toolset |
155
+ | **๋„๊ตฌ ๋ชจ๋ธ** | 288๊ฐœ ๋„๊ตฌ: toolset 285๊ฐœ + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60๊ฐœ `browse_*` / `manage_*` ๊ทธ๋ฃน ๋„๊ตฌ | HTTP ํ—ค๋”๋กœ ๊ณ ๋ฅด๋Š” toolset |
156
156
  | **MR ๋ฆฌ๋ทฐ** | 2๋‹จ๊ณ„ ๋ฐฐ์น˜ diff | ์„œ๋ฒ„๋งˆ๋‹ค ๋‹ค๋ฆ„ | `get_merge_request`์— diffs |
157
157
  | **Node.js** | >=20.0.0 | ๋ณดํ†ต >=24 | stdio๋Š” `mcp-remote`, Node.js 20+ |
158
158
  | **๋ผ์ด์„ ์Šค** | MIT | ์„œ๋ฒ„๋งˆ๋‹ค ๋‹ค๋ฆ„ | GitLab์˜ ์ผ๋ถ€ |
package/README.md CHANGED
@@ -12,7 +12,7 @@
12
12
 
13
13
  ๐Ÿ“– **[Documentation โ†’](https://zereight.github.io/gitlab-mcp/)** ยท [llms.txt](./llms.txt) ยท [llms-full.txt](./llms-full.txt)
14
14
 
15
- **Default: 40 tools** (38 `core` + `discover_tools` + `help`). 287 tools exist in total (284 in toolsets + `execute_graphql` + `discover_tools` + `help`). Start lean; call `discover_tools` to activate more for this session.
15
+ **Default: 40 tools** (38 `core` + `discover_tools` + `help`). 288 tools exist in total (285 in toolsets + `execute_graphql` + `discover_tools` + `help`). Start lean; call `discover_tools` to activate more for this session.
16
16
 
17
17
  Install the `zereight-mcp-gitlab` binary first with `npm install -g @zereight/mcp-gitlab`, or Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` and `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. Official MCP Registry listing: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). One-liner: `npx -y @zereight/mcp-gitlab@latest`.
18
18
 
@@ -144,7 +144,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
144
144
 
145
145
  ### Why use this GitLab MCP?
146
146
 
147
- - **Default 40 tools (38 `core` + `discover_tools` + `help`); 287 total** โ€” start lean; call `discover_tools` to activate more without CQRS-style grouping
147
+ - **Default 40 tools (38 `core` + `discover_tools` + `help`); 288 total** โ€” start lean; call `discover_tools` to activate more without CQRS-style grouping
148
148
  - **MR 2-step review** โ€” `list_merge_request_changed_files` โ†’ batched `get_merge_request_file_diff`
149
149
  - **Agent Skill built in** โ€” workflow guidance in `skills/gitlab-mcp/`
150
150
  - **Flexible auth** โ€” Personal Access Token, local OAuth2 browser flow, MCP OAuth proxy, and per-request remote authorization
@@ -158,7 +158,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
158
158
  | | @zereight/mcp-gitlab | GitLab MCP A (community CQRS-style) | GitLab official MCP server |
159
159
  | -------------- | ----------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
160
160
  | **Best for** | AI agent workflows | Enterprise multi-instance / grouped tools | Built into GitLab, no separate install |
161
- | **Tool model** | 287 tools: 284 in toolsets + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60 grouped `browse_*` / `manage_*` tools | Toolsets chosen with an HTTP header |
161
+ | **Tool model** | 288 tools: 285 in toolsets + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60 grouped `browse_*` / `manage_*` tools | Toolsets chosen with an HTTP header |
162
162
  | **MR review** | 2-step batched diff | Varies | `get_merge_request` with diffs |
163
163
  | **Node.js** | >=20.0.0 | Often >=24 | Node.js 20+ for stdio via `mcp-remote` |
164
164
  | **License** | MIT | Varies | Part of GitLab |
@@ -851,219 +851,220 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
851
851
  72. `get_issue` - Get details of a specific issue. Returns the issue with a slim nested milestone by default; set full_response=true for the complete milestone object
852
852
  73. `update_issue` - Update an issue. Returns a slim confirmation by default; set full_response=true for the complete updated issue object
853
853
  74. `update_issue_description_patch` - Apply a patch (search/replace or unified diff) to an issue description. Reduces token usage by allowing small changes without sending the full description. Supports dry_run to preview changes and create_note to summarize updates.
854
- 75. `delete_issue` - Delete an issue
855
- 76. `list_todos` - List GitLab to-do items for the current user
856
- 77. `mark_todo_done` - Mark a GitLab to-do item as done
857
- 78. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
858
- 79. `list_issue_links` - List all issue links for a specific issue
859
- 80. `list_issue_discussions` - List discussions for an issue
860
- 81. `get_issue_link` - Get a specific issue link
861
- 82. `create_issue_link` - Create an issue link between two issues
862
- 83. `delete_issue_link` - Delete an issue link
863
- 84. `list_namespaces` - List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only.
864
- 85. `get_namespace` - Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='group'.
865
- 86. `verify_namespace` - Verify if a namespace path exists. Use parent_id to scope the check to a specific parent namespace โ€” required for nested namespaces where the same path may exist under different parents.
866
- 87. `get_project` - Get details of a specific project
867
- 88. `list_projects` - List projects accessible by the current user
868
- 89. `update_project` - Update project settings such as description, visibility, default branch, and feature access levels
869
- 90. `list_project_members` - List members of a GitLab project
870
- 91. `list_group_members` - List members of a GitLab group with optional name or username search
871
- 92. `list_labels` - List labels for a project
872
- 93. `get_label` - Get a single label from a project
873
- 94. `create_label` - Create a new label in a project
874
- 95. `update_label` - Update an existing label in a project
875
- 96. `delete_label` - Delete a label from a project
876
- 97. `list_group_projects` - List projects in a group
877
- 98. `list_wiki_pages` - List wiki pages in a project
878
- 99. `get_wiki_page` - Get details of a specific wiki page
879
- 100. `create_wiki_page` - Create a wiki page in a project
880
- 101. `update_wiki_page` - Update a wiki page in a project
881
- 102. `delete_wiki_page` - Delete a wiki page from a project
882
- 103. `list_group_wiki_pages` - List wiki pages in a group
883
- 104. `get_group_wiki_page` - Get details of a specific group wiki page
884
- 105. `create_group_wiki_page` - Create a wiki page in a group
885
- 106. `update_group_wiki_page` - Update a wiki page in a group
886
- 107. `delete_group_wiki_page` - Delete a wiki page from a group
887
- 108. `get_repository_tree` - List files and directories in a repository
888
- 109. `list_pipelines` - List pipelines with filtering options
889
- 110. `get_pipeline` - Get details of a specific pipeline
890
- 111. `get_pipeline_variables` - Get variables configured for a pipeline
891
- 112. `get_pipeline_test_report` - Get pipeline test report
892
- 113. `get_pipeline_test_report_summary` - Get pipeline test report summary
893
- 114. `delete_pipeline` - Delete a pipeline. Requires the project Owner role, cannot be undone, and does not automatically delete child pipelines.
894
- 115. `update_pipeline_metadata` - Update pipeline metadata
895
- 116. `list_deployments` - List deployments with filtering options
896
- 117. `get_deployment` - Get deployment details, including approval_summary, approvals, and pending_approval_count when GitLab provides them
897
- 118. `create_deployment` - Create a deployment
898
- 119. `update_deployment` - Update a deployment status
899
- 120. `delete_deployment` - Delete a deployment
900
- 121. `list_deployment_merge_requests` - List merge requests shipped with a deployment
901
- 122. `approve_deployment` - Approve or reject a protected-environment deployment
902
- 123. `list_environments` - List environments in a project
903
- 124. `get_environment` - Get details of a specific environment
904
- 125. `update_environment` - Update an environment
905
- 126. `delete_environment` - Delete a stopped environment
906
- 127. `stop_environment` - Stop an environment
907
- 128. `stop_stale_environments` - Stop eligible stale environments; protected environments are excluded and environments are stopped, not deleted
908
- 129. `delete_review_app_environments` - Schedule deletion of stopped review-app environments one week later; dry_run defaults to true and actual scheduling requires dry_run=false
909
- 130. `list_pipeline_triggers` - List project pipeline trigger tokens
910
- 131. `get_pipeline_trigger` - Get a project pipeline trigger
911
- 132. `create_pipeline_trigger` - Create a project pipeline trigger
912
- 133. `update_pipeline_trigger` - Update a project pipeline trigger
913
- 134. `delete_pipeline_trigger` - Delete a project pipeline trigger
914
- 135. `trigger_pipeline` - Trigger a pipeline with a pipeline trigger token
915
- 136. `list_pipeline_jobs` - List all jobs in a specific pipeline
916
- 137. `list_pipeline_trigger_jobs` - List trigger jobs (bridges) in a pipeline
917
- 138. `get_pipeline_job` - Get details of a GitLab pipeline job number
918
- 139. `get_pipeline_job_output` - Get a pipeline job trace, with end-based pagination or full-log substring/regex search
919
- 140. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
920
- 141. `validate_project_ci_lint` - Validate an existing .gitlab-ci.yml configuration for a project
921
- 142. `list_ci_catalog_resources` - List GitLab CI/CD Catalog resources/components visible to the user
922
- 143. `get_ci_catalog_resource` - Get details for a GitLab CI/CD Catalog resource, including versions and components
923
- 144. `create_pipeline` - Create a new pipeline for a branch or tag
924
- 145. `retry_pipeline` - Retry a failed or canceled pipeline
925
- 146. `cancel_pipeline` - Cancel a running pipeline
926
- 147. `list_pipeline_schedules` - List pipeline schedules in a project, optionally filtered to active or inactive
927
- 148. `get_pipeline_schedule` - Get details of a specific pipeline schedule, including its variables and last pipeline
928
- 149. `list_pipeline_schedule_pipelines` - List the pipelines that a pipeline schedule has triggered
929
- 150. `create_pipeline_schedule` - Create a new pipeline schedule for a branch or tag
930
- 151. `update_pipeline_schedule` - Update an existing pipeline schedule
931
- 152. `delete_pipeline_schedule` - Delete a pipeline schedule
932
- 153. `play_pipeline_schedule` - Run a pipeline schedule immediately
933
- 154. `take_ownership_pipeline_schedule` - Take ownership of a pipeline schedule
934
- 155. `get_pipeline_schedule_variable` - Get a single variable of a pipeline schedule
935
- 156. `create_pipeline_schedule_variable` - Create a variable for a pipeline schedule
936
- 157. `update_pipeline_schedule_variable` - Update a variable of a pipeline schedule
937
- 158. `delete_pipeline_schedule_variable` - Delete a variable from a pipeline schedule
938
- 159. `play_pipeline_job` - Run a manual pipeline job
939
- 160. `play_pipeline_jobs` - Play multiple manual pipeline jobs sequentially
940
- 161. `retry_pipeline_job` - Retry a failed or canceled pipeline job
941
- 162. `cancel_pipeline_job` - Cancel a running pipeline job
942
- 163. `erase_pipeline_job` - Erase a pipeline job log and artifacts
943
- 164. `wait_for_pipeline` - Wait for a pipeline to reach a terminal status
944
- 165. `wait_for_job` - Wait for a job to reach a terminal status
945
- 166. `list_job_artifacts` - List artifact files in a job's archive
946
- 167. `download_job_artifacts` - Download job artifact archive (zip) and save it under the download directory
947
- 168. `get_job_artifact_file` - Get content of a single file from a job's artifacts
948
- 169. `list_merge_requests` - List merge requests (without project_id: user's MRs; with project_id: project MRs)
949
- 170. `list_group_merge_requests` - List merge requests across all projects of a group and its subgroups
950
- 171. `list_milestones` - List milestones with filtering options
951
- 172. `get_milestone` - Get details of a specific milestone
952
- 173. `create_milestone` - Create a new milestone
953
- 174. `edit_milestone` - Edit an existing milestone
954
- 175. `delete_milestone` - Delete a milestone
955
- 176. `get_milestone_issue` - Get issues associated with a specific milestone
956
- 177. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
957
- 178. `promote_milestone` - Promote a milestone to the next stage
958
- 179. `get_milestone_burndown_events` - Get burndown events for a specific milestone
959
- 180. `list_group_milestones` - List group milestones with filtering options
960
- 181. `get_group_milestone` - Get details of a specific group milestone
961
- 182. `create_group_milestone` - Create a new group milestone
962
- 183. `edit_group_milestone` - Edit an existing group milestone
963
- 184. `delete_group_milestone` - Delete a group milestone
964
- 185. `get_group_milestone_issue` - Get issues associated with a specific group milestone
965
- 186. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
966
- 187. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
967
- 188. `get_users` - Get GitLab user details by usernames
968
- 189. `get_user` - Get user details by ID
969
- 190. `whoami` - Get current authenticated user details
970
- 191. `list_commits` - List repository commits with filtering options
971
- 192. `get_commit` - Get details of a specific commit
972
- 193. `get_commit_diff` - Get changes/diffs of a specific commit
973
- 194. `get_file_blame` - Get git blame for a file at a given ref. Each entry maps a contiguous range of source lines to the commit that last changed them (id, author, authored_date, message). Use range_start/range_end to limit blame to specific lines.
974
- 195. `list_commit_statuses` - List statuses for a commit
975
- 196. `create_commit_status` - Create or update the status of a commit
976
- 197. `list_group_iterations` - List group iterations with filtering options
977
- 198. `get_group_iteration` - Get a group iteration by ID, IID, or GraphQL GID
978
- 199. `update_group_iteration` - Update a manual group iteration's title, description, or dates
979
- 200. `create_group_iteration` - Create a group iteration, optionally in a given iteration cadence
980
- 201. `delete_group_iteration` - Delete a group iteration by ID, IID, or GraphQL GID
981
- 202. `list_project_iterations` - List the iterations available to a project with filtering options
982
- 203. `list_group_iteration_cadences` - List a group's iteration cadences with filtering options
983
- 204. `create_group_iteration_cadence` - Create an iteration cadence in a group
984
- 205. `update_group_iteration_cadence` - Update an iteration cadence's title, description, schedule, or automation
985
- 206. `delete_group_iteration_cadence` - Delete an iteration cadence
986
- 207. `upload_markdown` - Upload a file for use in markdown content
987
- 208. `download_attachment` - Download an uploaded file from a project (images returned as base64; other files, or images with local_path, are saved as new files under the download directory)
988
- 209. `health_check` - Verify server status and authentication. Always reports the MCP server version (mcp_server_version). When authenticated, also reports the GitLab instance version from GET /api/v4/version (version, revision, enterprise). Version lookup failures do not fail the health check โ€” those fields are omitted.
989
- 210. `list_events` - List events for the authenticated user (before/after: YYYY-MM-DD)
990
- 211. `get_project_events` - List events for a project (before/after: YYYY-MM-DD)
991
- 212. `list_releases` - List all releases for a project
992
- 213. `get_release` - Get a release by tag name
993
- 214. `create_release` - Create a new release
994
- 215. `update_release` - Update an existing release
995
- 216. `delete_release` - Delete a release (does not delete the tag)
996
- 217. `create_release_evidence` - Create release evidence (Premium/Ultimate)
997
- 218. `download_release_asset` - Download a release asset file by direct asset path
998
- 219. `list_tags` - List repository tags for a project
999
- 220. `get_tag` - Get a repository tag by name
1000
- 221. `create_tag` - Create a new repository tag
1001
- 222. `delete_tag` - Delete a repository tag
1002
- 223. `get_tag_signature` - Get the X.509 signature of a signed tag (404 if unsigned)
1003
- 224. `list_protected_tags` - List protected tags in a project
1004
- 225. `get_protected_tag` - Get details of a single protected tag or wildcard (create access levels)
1005
- 226. `protect_tag` - Protect a repository tag or wildcard (set who can create it)
1006
- 227. `unprotect_tag` - Remove protection from a previously protected tag or wildcard
1007
- 228. `get_work_item` - Get a work item with full details including status, hierarchy, type, and widgets
1008
- 229. `list_work_items` - List work items with filters (type, state, search, assignees, labels)
1009
- 230. `create_work_item` - Create a work item (issue, task, incident, epic, etc.) with full field support
1010
- 231. `update_work_item` - Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)
1011
- 232. `convert_work_item_type` - Convert a work item to a different type
1012
- 233. `list_work_item_statuses` - List available statuses for a work item type (Premium/Ultimate)
1013
- 234. `list_custom_field_definitions` - List custom field definitions for a work item type
1014
- 235. `move_work_item` - Move a work item to a different project
1015
- 236. `list_work_item_notes` - List notes and discussions on a work item
1016
- 237. `create_work_item_note` - Add a note to a work item (supports Markdown, internal notes, threads)
1017
- 238. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
1018
- 239. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
1019
- 240. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
1020
- 241. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
1021
- 242. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
1022
- 243. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
1023
- 244. `get_timeline_events` - List timeline events for an incident
1024
- 245. `create_timeline_event` - Create a timeline event on an incident
1025
- 246. `list_webhooks` - List webhooks for a project or group
1026
- 247. `create_webhook` - Create a webhook on a project or group
1027
- 248. `update_webhook` - Update an existing project or group webhook
1028
- 249. `delete_webhook` - Delete a project or group webhook
1029
- 250. `list_webhook_events` - List recent webhook events (past 7 days)
1030
- 251. `get_webhook_event` - Get full details of a specific webhook event
1031
- 252. `search_code` - Search for code across all projects (requires advanced search or Zoekt)
1032
- 253. `search_project_code` - Search for code within a specific project (requires advanced search or Zoekt)
1033
- 254. `search_group_code` - Search for code within a specific group (requires advanced search or Zoekt)
1034
- 255. `list_project_variables` - List CI/CD variables for a project
1035
- 256. `get_project_variable` - Get a single CI/CD variable from a project
1036
- 257. `create_project_variable` - Create a CI/CD variable for a project
1037
- 258. `update_project_variable` - Update an existing CI/CD variable in a project
1038
- 259. `delete_project_variable` - Delete a CI/CD variable from a project
1039
- 260. `list_group_variables` - List CI/CD variables for a group
1040
- 261. `get_group_variable` - Get a single CI/CD variable from a group
1041
- 262. `create_group_variable` - Create a CI/CD variable for a group
1042
- 263. `update_group_variable` - Update an existing CI/CD variable in a group
1043
- 264. `delete_group_variable` - Delete a CI/CD variable from a group
1044
- 265. `get_dependency_proxy_settings` - Get dependency proxy settings for a group
1045
- 266. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
1046
- 267. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group
1047
- 268. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
1048
- 269. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
1049
- 270. `get_vulnerability` - Get full details of a specific vulnerability
1050
- 271. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
1051
- 272. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
1052
- 273. `orbit_query` - Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph
1053
- 274. `orbit_get_schema` - Fetch the current GitLab Orbit graph schema (node and edge types)
1054
- 275. `orbit_get_status` - Check GitLab Orbit indexing status for the enabled scope
1055
- 276. `orbit_list_tools` - List the MCP tool definitions exposed by GitLab Orbit
1056
- 277. `list_snippets` - List snippets โ€” project snippets when project_id is given, otherwise personal snippets
1057
- 278. `get_snippet` - Get a snippet's metadata. Set include_content=true to also fetch the raw file content.
1058
- 279. `create_snippet` - Create a snippet โ€” project-scoped when project_id is given, otherwise a personal snippet. Requires title plus either file_name + content (single file) or files[] (multi-file); the two shapes cannot be mixed.
1059
- 280. `update_snippet` - Update an existing snippet (provide at least one field to change). For multi-file edits โ€” renames, deletions, additions โ€” pass files[] with action (create/update/delete/move) and previous_path. The file_name + content shortcut still works for single-file content replacement.
1060
- 281. `delete_snippet` - Delete a snippet
1061
- 282. `list_project_runners` - List runners available to a project (type, status, paused, tag_list). Omits registration and authentication tokens.
1062
- 283. `get_runner` - Get a runner's tag_list, run_untagged, locked, and access_level. When a project allowlist is active, the runner must be available to an allowed project. Omits registration and authentication tokens.
1063
- 284. `rebase_merge_request` - Rebase the source branch of a merge request onto its target branch
1064
- 285. `gitlab_api_request` - Send one GitLab REST call under /api/v4. Enabled only when GITLAB_TOOLSETS lists api. Readonly allows GET; modify rejects DELETE.
1065
- 286. `discover_tools` - Discover and activate additional tool categories for this session. Available categories: core, merge_requests, issues, repositories, branches, projects, labels, ci, groups, pipelines, milestones, wiki, releases, tags, snippets, users, workitems, webhooks, search, variables, dependency_proxy, vulnerabilities, orbit. Already-active categories are listed in the response.
1066
- 287. `help` - Return a short GitLab workflow guide. Omit topic for the overview and topic list.
854
+ 75. `reorder_issue` - Move an issue within the manual sort order shown on issue boards. move_after_id and move_before_id take the neighbor issue's global id (the `id` field), not its iid; pass at least one. Returns the reordered issue.
855
+ 76. `delete_issue` - Delete an issue
856
+ 77. `list_todos` - List GitLab to-do items for the current user
857
+ 78. `mark_todo_done` - Mark a GitLab to-do item as done
858
+ 79. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
859
+ 80. `list_issue_links` - List all issue links for a specific issue
860
+ 81. `list_issue_discussions` - List discussions for an issue
861
+ 82. `get_issue_link` - Get a specific issue link
862
+ 83. `create_issue_link` - Create an issue link between two issues
863
+ 84. `delete_issue_link` - Delete an issue link
864
+ 85. `list_namespaces` - List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only.
865
+ 86. `get_namespace` - Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='group'.
866
+ 87. `verify_namespace` - Verify if a namespace path exists. Use parent_id to scope the check to a specific parent namespace โ€” required for nested namespaces where the same path may exist under different parents.
867
+ 88. `get_project` - Get details of a specific project
868
+ 89. `list_projects` - List projects accessible by the current user
869
+ 90. `update_project` - Update project settings such as description, visibility, default branch, and feature access levels
870
+ 91. `list_project_members` - List members of a GitLab project
871
+ 92. `list_group_members` - List members of a GitLab group with optional name or username search
872
+ 93. `list_labels` - List labels for a project
873
+ 94. `get_label` - Get a single label from a project
874
+ 95. `create_label` - Create a new label in a project
875
+ 96. `update_label` - Update an existing label in a project
876
+ 97. `delete_label` - Delete a label from a project
877
+ 98. `list_group_projects` - List projects in a group
878
+ 99. `list_wiki_pages` - List wiki pages in a project
879
+ 100. `get_wiki_page` - Get details of a specific wiki page
880
+ 101. `create_wiki_page` - Create a wiki page in a project
881
+ 102. `update_wiki_page` - Update a wiki page in a project
882
+ 103. `delete_wiki_page` - Delete a wiki page from a project
883
+ 104. `list_group_wiki_pages` - List wiki pages in a group
884
+ 105. `get_group_wiki_page` - Get details of a specific group wiki page
885
+ 106. `create_group_wiki_page` - Create a wiki page in a group
886
+ 107. `update_group_wiki_page` - Update a wiki page in a group
887
+ 108. `delete_group_wiki_page` - Delete a wiki page from a group
888
+ 109. `get_repository_tree` - List files and directories in a repository
889
+ 110. `list_pipelines` - List pipelines with filtering options
890
+ 111. `get_pipeline` - Get details of a specific pipeline
891
+ 112. `get_pipeline_variables` - Get variables configured for a pipeline
892
+ 113. `get_pipeline_test_report` - Get pipeline test report
893
+ 114. `get_pipeline_test_report_summary` - Get pipeline test report summary
894
+ 115. `delete_pipeline` - Delete a pipeline. Requires the project Owner role, cannot be undone, and does not automatically delete child pipelines.
895
+ 116. `update_pipeline_metadata` - Update pipeline metadata
896
+ 117. `list_deployments` - List deployments with filtering options
897
+ 118. `get_deployment` - Get deployment details, including approval_summary, approvals, and pending_approval_count when GitLab provides them
898
+ 119. `create_deployment` - Create a deployment
899
+ 120. `update_deployment` - Update a deployment status
900
+ 121. `delete_deployment` - Delete a deployment
901
+ 122. `list_deployment_merge_requests` - List merge requests shipped with a deployment
902
+ 123. `approve_deployment` - Approve or reject a protected-environment deployment
903
+ 124. `list_environments` - List environments in a project
904
+ 125. `get_environment` - Get details of a specific environment
905
+ 126. `update_environment` - Update an environment
906
+ 127. `delete_environment` - Delete a stopped environment
907
+ 128. `stop_environment` - Stop an environment
908
+ 129. `stop_stale_environments` - Stop eligible stale environments; protected environments are excluded and environments are stopped, not deleted
909
+ 130. `delete_review_app_environments` - Schedule deletion of stopped review-app environments one week later; dry_run defaults to true and actual scheduling requires dry_run=false
910
+ 131. `list_pipeline_triggers` - List project pipeline trigger tokens
911
+ 132. `get_pipeline_trigger` - Get a project pipeline trigger
912
+ 133. `create_pipeline_trigger` - Create a project pipeline trigger
913
+ 134. `update_pipeline_trigger` - Update a project pipeline trigger
914
+ 135. `delete_pipeline_trigger` - Delete a project pipeline trigger
915
+ 136. `trigger_pipeline` - Trigger a pipeline with a pipeline trigger token
916
+ 137. `list_pipeline_jobs` - List all jobs in a specific pipeline
917
+ 138. `list_pipeline_trigger_jobs` - List trigger jobs (bridges) in a pipeline
918
+ 139. `get_pipeline_job` - Get details of a GitLab pipeline job number
919
+ 140. `get_pipeline_job_output` - Get a pipeline job trace, with end-based pagination or full-log substring/regex search
920
+ 141. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
921
+ 142. `validate_project_ci_lint` - Validate an existing .gitlab-ci.yml configuration for a project
922
+ 143. `list_ci_catalog_resources` - List GitLab CI/CD Catalog resources/components visible to the user
923
+ 144. `get_ci_catalog_resource` - Get details for a GitLab CI/CD Catalog resource, including versions and components
924
+ 145. `create_pipeline` - Create a new pipeline for a branch or tag
925
+ 146. `retry_pipeline` - Retry a failed or canceled pipeline
926
+ 147. `cancel_pipeline` - Cancel a running pipeline
927
+ 148. `list_pipeline_schedules` - List pipeline schedules in a project, optionally filtered to active or inactive
928
+ 149. `get_pipeline_schedule` - Get details of a specific pipeline schedule, including its variables and last pipeline
929
+ 150. `list_pipeline_schedule_pipelines` - List the pipelines that a pipeline schedule has triggered
930
+ 151. `create_pipeline_schedule` - Create a new pipeline schedule for a branch or tag
931
+ 152. `update_pipeline_schedule` - Update an existing pipeline schedule
932
+ 153. `delete_pipeline_schedule` - Delete a pipeline schedule
933
+ 154. `play_pipeline_schedule` - Run a pipeline schedule immediately
934
+ 155. `take_ownership_pipeline_schedule` - Take ownership of a pipeline schedule
935
+ 156. `get_pipeline_schedule_variable` - Get a single variable of a pipeline schedule
936
+ 157. `create_pipeline_schedule_variable` - Create a variable for a pipeline schedule
937
+ 158. `update_pipeline_schedule_variable` - Update a variable of a pipeline schedule
938
+ 159. `delete_pipeline_schedule_variable` - Delete a variable from a pipeline schedule
939
+ 160. `play_pipeline_job` - Run a manual pipeline job
940
+ 161. `play_pipeline_jobs` - Play multiple manual pipeline jobs sequentially
941
+ 162. `retry_pipeline_job` - Retry a failed or canceled pipeline job
942
+ 163. `cancel_pipeline_job` - Cancel a running pipeline job
943
+ 164. `erase_pipeline_job` - Erase a pipeline job log and artifacts
944
+ 165. `wait_for_pipeline` - Wait for a pipeline to reach a terminal status
945
+ 166. `wait_for_job` - Wait for a job to reach a terminal status
946
+ 167. `list_job_artifacts` - List artifact files in a job's archive
947
+ 168. `download_job_artifacts` - Download job artifact archive (zip) and save it under the download directory
948
+ 169. `get_job_artifact_file` - Get content of a single file from a job's artifacts
949
+ 170. `list_merge_requests` - List merge requests (without project_id: user's MRs; with project_id: project MRs)
950
+ 171. `list_group_merge_requests` - List merge requests across all projects of a group and its subgroups
951
+ 172. `list_milestones` - List milestones with filtering options
952
+ 173. `get_milestone` - Get details of a specific milestone
953
+ 174. `create_milestone` - Create a new milestone
954
+ 175. `edit_milestone` - Edit an existing milestone
955
+ 176. `delete_milestone` - Delete a milestone
956
+ 177. `get_milestone_issue` - Get issues associated with a specific milestone
957
+ 178. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
958
+ 179. `promote_milestone` - Promote a milestone to the next stage
959
+ 180. `get_milestone_burndown_events` - Get burndown events for a specific milestone
960
+ 181. `list_group_milestones` - List group milestones with filtering options
961
+ 182. `get_group_milestone` - Get details of a specific group milestone
962
+ 183. `create_group_milestone` - Create a new group milestone
963
+ 184. `edit_group_milestone` - Edit an existing group milestone
964
+ 185. `delete_group_milestone` - Delete a group milestone
965
+ 186. `get_group_milestone_issue` - Get issues associated with a specific group milestone
966
+ 187. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
967
+ 188. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
968
+ 189. `get_users` - Get GitLab user details by usernames
969
+ 190. `get_user` - Get user details by ID
970
+ 191. `whoami` - Get current authenticated user details
971
+ 192. `list_commits` - List repository commits with filtering options
972
+ 193. `get_commit` - Get details of a specific commit
973
+ 194. `get_commit_diff` - Get changes/diffs of a specific commit
974
+ 195. `get_file_blame` - Get git blame for a file at a given ref. Each entry maps a contiguous range of source lines to the commit that last changed them (id, author, authored_date, message). Use range_start/range_end to limit blame to specific lines.
975
+ 196. `list_commit_statuses` - List statuses for a commit
976
+ 197. `create_commit_status` - Create or update the status of a commit
977
+ 198. `list_group_iterations` - List group iterations with filtering options
978
+ 199. `get_group_iteration` - Get a group iteration by ID, IID, or GraphQL GID
979
+ 200. `update_group_iteration` - Update a manual group iteration's title, description, or dates
980
+ 201. `create_group_iteration` - Create a group iteration, optionally in a given iteration cadence
981
+ 202. `delete_group_iteration` - Delete a group iteration by ID, IID, or GraphQL GID
982
+ 203. `list_project_iterations` - List the iterations available to a project with filtering options
983
+ 204. `list_group_iteration_cadences` - List a group's iteration cadences with filtering options
984
+ 205. `create_group_iteration_cadence` - Create an iteration cadence in a group
985
+ 206. `update_group_iteration_cadence` - Update an iteration cadence's title, description, schedule, or automation
986
+ 207. `delete_group_iteration_cadence` - Delete an iteration cadence
987
+ 208. `upload_markdown` - Upload a file for use in markdown content
988
+ 209. `download_attachment` - Download an uploaded file from a project (images returned as base64; other files, or images with local_path, are saved as new files under the download directory)
989
+ 210. `health_check` - Verify server status and authentication. Always reports the MCP server version (mcp_server_version). When authenticated, also reports the GitLab instance version from GET /api/v4/version (version, revision, enterprise). Version lookup failures do not fail the health check โ€” those fields are omitted.
990
+ 211. `list_events` - List events for the authenticated user (before/after: YYYY-MM-DD)
991
+ 212. `get_project_events` - List events for a project (before/after: YYYY-MM-DD)
992
+ 213. `list_releases` - List all releases for a project
993
+ 214. `get_release` - Get a release by tag name
994
+ 215. `create_release` - Create a new release
995
+ 216. `update_release` - Update an existing release
996
+ 217. `delete_release` - Delete a release (does not delete the tag)
997
+ 218. `create_release_evidence` - Create release evidence (Premium/Ultimate)
998
+ 219. `download_release_asset` - Download a release asset file by direct asset path
999
+ 220. `list_tags` - List repository tags for a project
1000
+ 221. `get_tag` - Get a repository tag by name
1001
+ 222. `create_tag` - Create a new repository tag
1002
+ 223. `delete_tag` - Delete a repository tag
1003
+ 224. `get_tag_signature` - Get the X.509 signature of a signed tag (404 if unsigned)
1004
+ 225. `list_protected_tags` - List protected tags in a project
1005
+ 226. `get_protected_tag` - Get details of a single protected tag or wildcard (create access levels)
1006
+ 227. `protect_tag` - Protect a repository tag or wildcard (set who can create it)
1007
+ 228. `unprotect_tag` - Remove protection from a previously protected tag or wildcard
1008
+ 229. `get_work_item` - Get a work item with full details including status, hierarchy, type, and widgets
1009
+ 230. `list_work_items` - List work items with filters (type, state, search, assignees, labels)
1010
+ 231. `create_work_item` - Create a work item (issue, task, incident, epic, etc.) with full field support
1011
+ 232. `update_work_item` - Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)
1012
+ 233. `convert_work_item_type` - Convert a work item to a different type
1013
+ 234. `list_work_item_statuses` - List available statuses for a work item type (Premium/Ultimate)
1014
+ 235. `list_custom_field_definitions` - List custom field definitions for a work item type
1015
+ 236. `move_work_item` - Move a work item to a different project
1016
+ 237. `list_work_item_notes` - List notes and discussions on a work item
1017
+ 238. `create_work_item_note` - Add a note to a work item (supports Markdown, internal notes, threads)
1018
+ 239. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
1019
+ 240. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
1020
+ 241. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
1021
+ 242. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
1022
+ 243. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
1023
+ 244. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
1024
+ 245. `get_timeline_events` - List timeline events for an incident
1025
+ 246. `create_timeline_event` - Create a timeline event on an incident
1026
+ 247. `list_webhooks` - List webhooks for a project or group
1027
+ 248. `create_webhook` - Create a webhook on a project or group
1028
+ 249. `update_webhook` - Update an existing project or group webhook
1029
+ 250. `delete_webhook` - Delete a project or group webhook
1030
+ 251. `list_webhook_events` - List recent webhook events (past 7 days)
1031
+ 252. `get_webhook_event` - Get full details of a specific webhook event
1032
+ 253. `search_code` - Search for code across all projects (requires advanced search or Zoekt)
1033
+ 254. `search_project_code` - Search for code within a specific project (requires advanced search or Zoekt)
1034
+ 255. `search_group_code` - Search for code within a specific group (requires advanced search or Zoekt)
1035
+ 256. `list_project_variables` - List CI/CD variables for a project
1036
+ 257. `get_project_variable` - Get a single CI/CD variable from a project
1037
+ 258. `create_project_variable` - Create a CI/CD variable for a project
1038
+ 259. `update_project_variable` - Update an existing CI/CD variable in a project
1039
+ 260. `delete_project_variable` - Delete a CI/CD variable from a project
1040
+ 261. `list_group_variables` - List CI/CD variables for a group
1041
+ 262. `get_group_variable` - Get a single CI/CD variable from a group
1042
+ 263. `create_group_variable` - Create a CI/CD variable for a group
1043
+ 264. `update_group_variable` - Update an existing CI/CD variable in a group
1044
+ 265. `delete_group_variable` - Delete a CI/CD variable from a group
1045
+ 266. `get_dependency_proxy_settings` - Get dependency proxy settings for a group
1046
+ 267. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
1047
+ 268. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group
1048
+ 269. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
1049
+ 270. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
1050
+ 271. `get_vulnerability` - Get full details of a specific vulnerability
1051
+ 272. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
1052
+ 273. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
1053
+ 274. `orbit_query` - Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph
1054
+ 275. `orbit_get_schema` - Fetch the current GitLab Orbit graph schema (node and edge types)
1055
+ 276. `orbit_get_status` - Check GitLab Orbit indexing status for the enabled scope
1056
+ 277. `orbit_list_tools` - List the MCP tool definitions exposed by GitLab Orbit
1057
+ 278. `list_snippets` - List snippets โ€” project snippets when project_id is given, otherwise personal snippets
1058
+ 279. `get_snippet` - Get a snippet's metadata. Set include_content=true to also fetch the raw file content.
1059
+ 280. `create_snippet` - Create a snippet โ€” project-scoped when project_id is given, otherwise a personal snippet. Requires title plus either file_name + content (single file) or files[] (multi-file); the two shapes cannot be mixed.
1060
+ 281. `update_snippet` - Update an existing snippet (provide at least one field to change). For multi-file edits โ€” renames, deletions, additions โ€” pass files[] with action (create/update/delete/move) and previous_path. The file_name + content shortcut still works for single-file content replacement.
1061
+ 282. `delete_snippet` - Delete a snippet
1062
+ 283. `list_project_runners` - List runners available to a project (type, status, paused, tag_list). Omits registration and authentication tokens.
1063
+ 284. `get_runner` - Get a runner's tag_list, run_untagged, locked, and access_level. When a project allowlist is active, the runner must be available to an allowed project. Omits registration and authentication tokens.
1064
+ 285. `rebase_merge_request` - Rebase the source branch of a merge request onto its target branch
1065
+ 286. `gitlab_api_request` - Send one GitLab REST call under /api/v4. Enabled only when GITLAB_TOOLSETS lists api. Readonly allows GET; modify rejects DELETE.
1066
+ 287. `discover_tools` - Discover and activate additional tool categories for this session. Available categories: core, merge_requests, issues, repositories, branches, projects, labels, ci, groups, pipelines, milestones, wiki, releases, tags, snippets, users, workitems, webhooks, search, variables, dependency_proxy, vulnerabilities, orbit. Already-active categories are listed in the response.
1067
+ 288. `help` - Return a short GitLab workflow guide. Omit topic for the overview and topic list.
1067
1068
 
1068
1069
  <!-- TOOLS-END -->
1069
1070
 
package/README.pt-BR.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  ๐Ÿ“– **[Documentaรงรฃo โ†’](https://zereight.github.io/gitlab-mcp/)** ยท [llms.txt](./llms.txt) ยท [llms-full.txt](./llms-full.txt)
8
8
 
9
- **Padrรฃo: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem 287 no total (284 em toolsets + `execute_graphql` + `discover_tools` + `help`). Comece enxuto; chame `discover_tools` para ativar mais nesta sessรฃo.
9
+ **Padrรฃo: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem 288 no total (285 em toolsets + `execute_graphql` + `discover_tools` + `help`). Comece enxuto; chame `discover_tools` para ativar mais nesta sessรฃo.
10
10
 
11
11
  Instale o binรกrio `zereight-mcp-gitlab` antes. `npm install -g @zereight/mcp-gitlab`, ou Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` e `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`. Listagem oficial no MCP Registry: [`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp). Instalaรงรฃo em uma linha: `npx -y @zereight/mcp-gitlab@latest`.
12
12
 
@@ -138,7 +138,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinรขmicas e autorizaรงรฃo
138
138
 
139
139
  ### Por que usar este GitLab MCP?
140
140
 
141
- - **40 ferramentas por padrรฃo (38 `core` + `discover_tools` + `help`); 287 no total** โ€” comece enxuto; chame `discover_tools` para expandir nesta sessรฃo
141
+ - **40 ferramentas por padrรฃo (38 `core` + `discover_tools` + `help`); 288 no total** โ€” comece enxuto; chame `discover_tools` para expandir nesta sessรฃo
142
142
  - **Revisรฃo de MR em 2 etapas** โ€” `list_merge_request_changed_files` โ†’ `get_merge_request_file_diff` em lote
143
143
  - **Agent Skill integrado** โ€” orientaรงรฃo de workflows em `skills/gitlab-mcp/`
144
144
  - **Autenticaรงรฃo flexรญvel** โ€” Personal Access Token, fluxo OAuth2 local no navegador, proxy MCP OAuth e autorizaรงรฃo remota por requisiรงรฃo
@@ -152,7 +152,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinรขmicas e autorizaรงรฃo
152
152
  | | @zereight/mcp-gitlab | GitLab MCP A (comunidade, estilo CQRS) | Servidor MCP oficial do GitLab |
153
153
  | ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
154
154
  | **Mais indicado para** | Workflows de agentes de IA | Mรบltiplas instรขncias corporativas / ferramentas agrupadas | Integrado ao GitLab, sem instalaรงรฃo separada |
155
- | **Modelo de ferramentas** | 287 ferramentas: 284 em toolsets + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60 ferramentas agrupadas `browse_*` / `manage_*` | Toolsets escolhidos por cabeรงalho HTTP |
155
+ | **Modelo de ferramentas** | 288 ferramentas: 285 em toolsets + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60 ferramentas agrupadas `browse_*` / `manage_*` | Toolsets escolhidos por cabeรงalho HTTP |
156
156
  | **Revisรฃo de MR** | Diff em lote em 2 etapas | Varia | `get_merge_request` com diffs |
157
157
  | **Node.js** | >=20.0.0 | Frequentemente >=24 | Node.js 20+ para stdio via `mcp-remote` |
158
158
  | **Licenรงa** | MIT | Varia | Parte do GitLab |
package/README.zh-CN.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  ๐Ÿ“– **[ๆ–‡ๆกฃ โ†’](https://zereight.github.io/gitlab-mcp/)** ยท [llms.txt](./llms.txt) ยท [llms-full.txt](./llms-full.txt)
8
8
 
9
- **้ป˜่ฎคๆšด้œฒ 40 ไธชๅทฅๅ…ท**๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰ใ€‚ๆ€ปๅ…ฑ 287 ไธช๏ผˆtoolset ไธญ 284 ไธช + `execute_graphql` + `discover_tools` + `help`๏ผ‰ใ€‚ๅ…ˆ็”จ็ฒพ็ฎ€้›†๏ผŒๅ†ๅœจๆœฌไผš่ฏไธญ็”จ `discover_tools` ๆ‰ฉๅฑ•ใ€‚
9
+ **้ป˜่ฎคๆšด้œฒ 40 ไธชๅทฅๅ…ท**๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰ใ€‚ๆ€ปๅ…ฑ 288 ไธช๏ผˆtoolset ไธญ 285 ไธช + `execute_graphql` + `discover_tools` + `help`๏ผ‰ใ€‚ๅ…ˆ็”จ็ฒพ็ฎ€้›†๏ผŒๅ†ๅœจๆœฌไผš่ฏไธญ็”จ `discover_tools` ๆ‰ฉๅฑ•ใ€‚
10
10
 
11
11
  ๅ…ˆๅฎ‰่ฃ… `zereight-mcp-gitlab` ไบŒ่ฟ›ๅˆถใ€‚`npm install -g @zereight/mcp-gitlab`๏ผŒๆˆ– Homebrew `brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp` ็„ถๅŽ `brew install zereight/gitlab-mcp/zereight-mcp-gitlab`ใ€‚ๅฎ˜ๆ–น MCP Registry ๆก็›ฎ๏ผš[`io.github.zereight/gitlab-mcp`](https://registry.modelcontextprotocol.io/?q=io.github.zereight%2Fgitlab-mcp)ใ€‚ไธ€้”ฎๅฎ‰่ฃ…๏ผš`npx -y @zereight/mcp-gitlab@latest`ใ€‚
12
12
 
@@ -138,7 +138,7 @@ GitLab ๅˆๅนถ่ฏทๆฑ‚ใ€่ฎฎ้ข˜ๅ’Œๆตๆฐด็บฟ่ตฐๆญค MCP๏ผˆ@zereight/mcp-gitlab๏ผ‰ใ€‚
138
138
 
139
139
  ### ไธบไป€ไนˆไฝฟ็”จ่ฟ™ไธช GitLab MCP๏ผŸ
140
140
 
141
- - **้ป˜่ฎค 40 ไธชๅทฅๅ…ท๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰๏ผ›ๅ…ฑ 287 ไธช** โ€” ๅ…ˆ็ฒพ็ฎ€๏ผŒๅ†็”จ `discover_tools` ๅœจๆœฌไผš่ฏๆ‰ฉๅฑ•
141
+ - **้ป˜่ฎค 40 ไธชๅทฅๅ…ท๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰๏ผ›ๅ…ฑ 288 ไธช** โ€” ๅ…ˆ็ฒพ็ฎ€๏ผŒๅ†็”จ `discover_tools` ๅœจๆœฌไผš่ฏๆ‰ฉๅฑ•
142
142
  - **MR ไธคๆญฅๅฎกๆŸฅ** โ€” `list_merge_request_changed_files` โ†’ ๆ‰น้‡ `get_merge_request_file_diff`
143
143
  - **ๅ†…็ฝฎ Agent Skill** โ€” `skills/gitlab-mcp/` ๅทฅไฝœๆตๆŒ‡ๅ—
144
144
  - **่ฎค่ฏ็ตๆดป** โ€” Personal Access Tokenใ€ๆœฌๅœฐ OAuth2 ๆต่งˆๅ™จๆต็จ‹ใ€MCP OAuth ไปฃ็†ใ€ๆŒ‰่ฏทๆฑ‚่ฟœ็จ‹ๆŽˆๆƒ
@@ -152,7 +152,7 @@ GitLab ๅˆๅนถ่ฏทๆฑ‚ใ€่ฎฎ้ข˜ๅ’Œๆตๆฐด็บฟ่ตฐๆญค MCP๏ผˆ@zereight/mcp-gitlab๏ผ‰ใ€‚
152
152
  | | @zereight/mcp-gitlab | GitLab MCP A๏ผˆ็คพๅŒบ CQRS ๅž‹๏ผ‰ | GitLab ๅฎ˜ๆ–น MCP ๆœๅŠกๅ™จ |
153
153
  | ------------ | -------------------------------------------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
154
154
  | **ๆ›ด้€‚ๅˆ** | AI ไปฃ็†ๅทฅไฝœๆต | ไผไธšๅคšๅฎžไพ‹ / ๅˆ†็ป„ๅทฅๅ…ท | ๅ†…็ฝฎไบŽ GitLab๏ผŒๆ— ้œ€ๅ•็‹ฌๅฎ‰่ฃ… |
155
- | **ๅทฅๅ…ทๆจกๅž‹** | 287 ไธชๅทฅๅ…ท๏ผštoolset ไธญ 284 ไธช + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60 ไธช `browse_*` / `manage_*` ๅˆ†็ป„ๅทฅๅ…ท | ็”จ HTTP ๅคด้€‰ๆ‹ฉ toolset |
155
+ | **ๅทฅๅ…ทๆจกๅž‹** | 288 ไธชๅทฅๅ…ท๏ผštoolset ไธญ 285 ไธช + `execute_graphql` + `discover_tools` + `help` | ~50โ€“60 ไธช `browse_*` / `manage_*` ๅˆ†็ป„ๅทฅๅ…ท | ็”จ HTTP ๅคด้€‰ๆ‹ฉ toolset |
156
156
  | **MR ๅฎกๆŸฅ** | ไธคๆญฅๆ‰น้‡ diff | ๅ› ๆœๅŠกๅ™จ่€Œๅผ‚ | `get_merge_request` ๅธฆ diffs |
157
157
  | **Node.js** | >=20.0.0 | ้€šๅธธ >=24 | stdio ็ป `mcp-remote`๏ผŒ้œ€่ฆ Node.js 20+ |
158
158
  | **่ฎธๅฏ่ฏ** | MIT | ๅ› ๆœๅŠกๅ™จ่€Œๅผ‚ | GitLab ็š„ไธ€้ƒจๅˆ† |
package/build/index.js CHANGED
@@ -145,7 +145,7 @@ GitLabDiscussionNoteSchema, // Added
145
145
  GitLabDiscussionSchema,
146
146
  // Draft Notes Schemas
147
147
  GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabProtectedTagSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabMilestonesSchema, GitLabGroupMilestonesSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineScheduleSchema, GitLabPipelineScheduleVariableSchema, GitLabPipelineSchedulePlayResultSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GitLabWikiPageSchema, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, GroupIterationCadence, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupProjectsSchema, GitLabCiVariableSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListLabelsSchema, ListMergeRequestDiffsSchema, // Added
148
- GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListProjectRunnersSchema, GetRunnerSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListProjectMembersSchema, ListGroupMembersSchema, ListProjectMilestonesSchema, ListGroupMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, GetGroupWikiPageSchema, ListGroupWikiPagesSchema, UpdateGroupWikiPageSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListTagsSchema, GetTagSchema, CreateTagSchema, DeleteTagSchema, GetTagSignatureSchema, ListProtectedTagsSchema, GetProtectedTagSchema, ProtectTagSchema, UnprotectTagSchema, GitLabTagSchema, GitLabTagSignatureSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, GitLabSnippetSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, GetMergeRequestDiscussionSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, CreateWebhookSchema, UpdateWebhookSchema, DeleteWebhookSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
148
+ GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListProjectRunnersSchema, GetRunnerSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListProjectMembersSchema, ListGroupMembersSchema, ListProjectMilestonesSchema, ListGroupMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, GetGroupWikiPageSchema, ListGroupWikiPagesSchema, UpdateGroupWikiPageSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, ReorderIssueSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListTagsSchema, GetTagSchema, CreateTagSchema, DeleteTagSchema, GetTagSignatureSchema, ListProtectedTagsSchema, GetProtectedTagSchema, ProtectTagSchema, UnprotectTagSchema, GitLabTagSchema, GitLabTagSignatureSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, GitLabSnippetSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, GetMergeRequestDiscussionSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, CreateWebhookSchema, UpdateWebhookSchema, DeleteWebhookSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
149
149
  import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
150
150
  import { createLogger, flushBufferedLogs, flushStartupLogs } from "./utils/logger.js";
151
151
  const logger = createLogger();
@@ -1765,6 +1765,27 @@ async function updateIssue(projectId, issueIid, options) {
1765
1765
  const data = await response.json();
1766
1766
  return GitLabIssueSchema.parse(data);
1767
1767
  }
1768
+ /**
1769
+ * Reorder an issue within the project's manual sort order (issue boards)
1770
+ * ์ด์Šˆ ์ˆ˜๋™ ์ •๋ ฌ ์ˆœ์„œ ๋ณ€๊ฒฝ
1771
+ *
1772
+ * @param {string} projectId - The ID or URL-encoded path of the project
1773
+ * @param {number|string} issueIid - The internal ID of the project issue
1774
+ * @param {Object} options - move_after_id / move_before_id (global issue ids)
1775
+ * @returns {Promise<GitLabIssue>} The reordered issue
1776
+ */
1777
+ async function reorderIssue(projectId, issueIid, options) {
1778
+ projectId = decodeURIComponent(projectId); // Decode project ID
1779
+ const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeGitLabPathSegment(getEffectiveProjectId(projectId))}/issues/${encodeGitLabPathSegment(issueIid)}/reorder`);
1780
+ const response = await fetch(url.toString(), {
1781
+ ...getFetchConfig(),
1782
+ method: "PUT",
1783
+ body: JSON.stringify(options),
1784
+ });
1785
+ await handleGitLabError(response);
1786
+ const data = await response.json();
1787
+ return GitLabIssueSchema.parse(data);
1788
+ }
1768
1789
  /**
1769
1790
  * Delete an issue from a GitLab project
1770
1791
  * ์ด์Šˆ ์‚ญ์ œ
@@ -9391,6 +9412,14 @@ async function handleToolCall(params) {
9391
9412
  content: [{ type: "text", text: JSON.stringify(responseBody) }],
9392
9413
  };
9393
9414
  }
9415
+ case "reorder_issue": {
9416
+ const args = ReorderIssueSchema.parse(params.arguments);
9417
+ const { project_id, issue_iid, ...options } = args;
9418
+ const issue = await reorderIssue(project_id, issue_iid, options);
9419
+ return {
9420
+ content: [{ type: "text", text: JSON.stringify(issue) }],
9421
+ };
9422
+ }
9394
9423
  case "update_issue_description_patch": {
9395
9424
  const args = UpdateIssueDescriptionPatchSchema.parse(params.arguments);
9396
9425
  const { project_id, issue_iid, patch_type, patch, dry_run, create_note, allow_multiple } = args;
package/build/schemas.js CHANGED
@@ -2694,6 +2694,24 @@ export const DeleteIssueSchema = z.object({
2694
2694
  project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
2695
2695
  issue_iid: z.coerce.string().describe("The internal ID of the project issue"),
2696
2696
  });
2697
+ export const ReorderIssueSchema = z
2698
+ .object({
2699
+ project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
2700
+ issue_iid: z.coerce.string().describe("The internal ID of the project issue"),
2701
+ move_after_id: z.coerce
2702
+ .number()
2703
+ .int()
2704
+ .optional()
2705
+ .describe("Global issue id (the `id` field, not the project-scoped `iid`) of the issue that should come after this one"),
2706
+ move_before_id: z.coerce
2707
+ .number()
2708
+ .int()
2709
+ .optional()
2710
+ .describe("Global issue id (the `id` field, not the project-scoped `iid`) of the issue that should come before this one"),
2711
+ })
2712
+ .refine(data => data.move_after_id !== undefined || data.move_before_id !== undefined, {
2713
+ message: "At least one of 'move_after_id' or 'move_before_id' must be provided",
2714
+ });
2697
2715
  export const UpdateIssueDescriptionPatchSchema = z.object({
2698
2716
  project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
2699
2717
  issue_iid: z.coerce.string().describe("The internal ID of the project issue"),
@@ -51,6 +51,7 @@ const GUIDES = {
51
51
  "Issues: list_issues (default scope is issues you created; use scope=all), my_issues, get_issue.",
52
52
  "Write: create_issue, update_issue, create_issue_note, list_issue_discussions.",
53
53
  "Small description edits: update_issue_description_patch instead of resending the full body.",
54
+ "Board order: reorder_issue (move_after_id / move_before_id are global issue ids, not iids).",
54
55
  "project_id is a numeric ID or URL-encoded path.",
55
56
  ].join("\n"),
56
57
  pipelines: [
@@ -1,7 +1,7 @@
1
1
  import { toJSONSchema } from "../utils/schema.js";
2
2
  import { USE_GITLAB_WIKI, USE_MILESTONE, USE_PIPELINE, SSE, STREAMABLE_HTTP } from "../config.js";
3
3
  import { getToolDescription } from "./tool-descriptions.js";
4
- import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateGroupMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWebhookSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, GetProtectedBranchSchema, ListProtectedBranchesSchema, ProtectBranchSchema, UpdateProtectedBranchSchema, ProtectTagSchema, UnprotectBranchSchema, UnprotectTagSchema, UpdateDefaultBranchSchema, DeleteDraftNoteSchema, DeleteGroupMilestoneSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWebhookSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadAttachmentRemoteSchema, DownloadJobArtifactsSchema, DownloadJobArtifactsRemoteSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, EditGroupMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetFileBlameSchema, GetDeploymentSchema, CreateDeploymentSchema, UpdateDeploymentSchema, DeploymentApprovalSchema, ListDeploymentMergeRequestsSchema, GetDraftNoteSchema, GetEnvironmentSchema, UpdateEnvironmentSchema, StopEnvironmentSchema, StopStaleEnvironmentsSchema, DeleteReviewAppEnvironmentsSchema, PipelineTriggerIdSchema, ListPipelineTriggersSchema, CreatePipelineTriggerSchema, UpdatePipelineTriggerSchema, TriggerPipelineSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestDiscussionSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetGroupMilestoneSchema, GetGroupMilestoneIssuesSchema, GetGroupMilestoneMergeRequestsSchema, GetGroupMilestoneBurndownEventsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, PipelineJobControlSchema, GetPipelineSchema, GetRunnerSchema, GetPipelineVariablesSchema, UpdatePipelineMetadataSchema, DeletePipelineSchema, PipelineReportSchema, WaitForPipelineSchema, WaitForPipelineJobSchema, PlayPipelineJobsSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetProtectedTagSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupMilestonesSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListPipelinesSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, ListGroupMembersSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListProjectRunnersSchema, ListReleasesSchema, ListTagsSchema, ListProtectedTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWebhookSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, } from "../schemas.js";
4
+ import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateGroupMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWebhookSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, GetProtectedBranchSchema, ListProtectedBranchesSchema, ProtectBranchSchema, UpdateProtectedBranchSchema, ProtectTagSchema, UnprotectBranchSchema, UnprotectTagSchema, UpdateDefaultBranchSchema, DeleteDraftNoteSchema, DeleteGroupMilestoneSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWebhookSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadAttachmentRemoteSchema, DownloadJobArtifactsSchema, DownloadJobArtifactsRemoteSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, EditGroupMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetFileBlameSchema, GetDeploymentSchema, CreateDeploymentSchema, UpdateDeploymentSchema, DeploymentApprovalSchema, ListDeploymentMergeRequestsSchema, GetDraftNoteSchema, GetEnvironmentSchema, UpdateEnvironmentSchema, StopEnvironmentSchema, StopStaleEnvironmentsSchema, DeleteReviewAppEnvironmentsSchema, PipelineTriggerIdSchema, ListPipelineTriggersSchema, CreatePipelineTriggerSchema, UpdatePipelineTriggerSchema, TriggerPipelineSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestDiscussionSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetGroupMilestoneSchema, GetGroupMilestoneIssuesSchema, GetGroupMilestoneMergeRequestsSchema, GetGroupMilestoneBurndownEventsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, PipelineJobControlSchema, GetPipelineSchema, GetRunnerSchema, GetPipelineVariablesSchema, UpdatePipelineMetadataSchema, DeletePipelineSchema, PipelineReportSchema, WaitForPipelineSchema, WaitForPipelineJobSchema, PlayPipelineJobsSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetProtectedTagSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupMilestonesSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListPipelinesSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, ListGroupMembersSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListProjectRunnersSchema, ListReleasesSchema, ListTagsSchema, ListProtectedTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, ReorderIssueSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWebhookSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, } from "../schemas.js";
5
5
  import { GitLabApiRequestSchema } from "./gitlab-api-request.js";
6
6
  import { HelpInputSchema } from "../server/mcp-help.js";
7
7
  const IS_REMOTE = SSE || STREAMABLE_HTTP;
@@ -381,6 +381,11 @@ export const allTools = [
381
381
  "Supports dry_run to preview changes and create_note to summarize updates.",
382
382
  inputSchema: toJSONSchema(UpdateIssueDescriptionPatchSchema),
383
383
  },
384
+ {
385
+ name: "reorder_issue",
386
+ description: "Move an issue within the manual sort order shown on issue boards. move_after_id and move_before_id take the neighbor issue's global id (the `id` field), not its iid; pass at least one. Returns the reordered issue.",
387
+ inputSchema: toJSONSchema(ReorderIssueSchema),
388
+ },
384
389
  {
385
390
  name: "delete_issue",
386
391
  description: "Delete an issue",
@@ -1952,6 +1957,7 @@ export const TOOLSET_DEFINITIONS = [
1952
1957
  "get_issue",
1953
1958
  "update_issue",
1954
1959
  "update_issue_description_patch",
1960
+ "reorder_issue",
1955
1961
  "delete_issue",
1956
1962
  "list_todos",
1957
1963
  "mark_todo_done",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zereight/mcp-gitlab",
3
- "version": "2.3.18",
3
+ "version": "2.3.19-next.194",
4
4
  "mcpName": "io.github.zereight/gitlab-mcp",
5
5
  "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
6
6
  "keywords": [