@zereight/mcp-gitlab 2.3.28 → 2.3.29-next.249

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
@@ -14,7 +14,7 @@
14
14
 
15
15
  📖 **[문서 →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
16
16
 
17
- **기본 노출: 40개 도구** (`core` 38개 + `discover_tools` + `help`). 전체는 288개(toolset 285개 + `execute_graphql` + `discover_tools` + `help`). 작게 시작하고, 세션에서 `discover_tools`로 확장하세요.
17
+ **기본 노출: 40개 도구** (`core` 38개 + `discover_tools` + `help`). 전체는 290개(toolset 287개 + `execute_graphql` + `discover_tools` + `help`). 작게 시작하고, 세션에서 `discover_tools`로 확장하세요.
18
18
 
19
19
  > **토큰 예산:** MCP 클라이언트는 세션 시작 때 `tools/list` 전체를 모델에 보냅니다. 기본값(~40개 도구, 스키마 ~12k 토큰)을 유지하세요. 확장은 `discover_tools`로 이 세션에만 카테고리를 켜거나(`OAUTH_STATELESS_MODE=true`면 `GITLAB_TOOLSETS`로 남기세요), [Skill + CLI](./docs/getting-started/cli-without-mcp.md)로 MCP 스키마를 건너뛰세요. **`GITLAB_TOOLSETS=all`은 쓰지 마세요** — 거의 모든 도구를 올려 스키마만 ~73k 토큰입니다. [tools/list 크기](#toolslist-크기-2026-11-14-실측)와 [비교](./docs/comparison/index.md)를 보세요.
20
20
 
@@ -148,7 +148,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
148
148
 
149
149
  ### 왜 이 GitLab MCP를 사용하나요?
150
150
 
151
- - **기본 40개 도구(`core` 38 + `discover_tools` + `help`); 전체 288개** — 작게 시작하고, `discover_tools`로 세션에서 확장. `GITLAB_TOOLSETS=all`은 스키마 ~73k 토큰; 필요할 때만 켜거나 Skill + CLI를 쓰세요
151
+ - **기본 40개 도구(`core` 38 + `discover_tools` + `help`); 전체 290개** — 작게 시작하고, `discover_tools`로 세션에서 확장. `GITLAB_TOOLSETS=all`은 스키마 ~73k 토큰; 필요할 때만 켜거나 Skill + CLI를 쓰세요
152
152
  - **MR 2단계 리뷰** — `list_merge_request_changed_files` → 배치 `get_merge_request_file_diff`
153
153
  - **Agent Skill 내장** — `skills/gitlab-mcp/` 워크플로우 가이드
154
154
  - **유연한 인증** — Personal Access Token, 로컬 OAuth2 브라우저 플로우, MCP OAuth 프록시, 요청별 원격 인증
@@ -162,7 +162,7 @@ PAT, OAuth, 읽기 전용 모드, 동적 API URL, 원격 인증을 지원하며
162
162
  | | @zereight/mcp-gitlab | GitLab MCP A (커뮤니티 CQRS형) | GitLab 공식 MCP 서버 |
163
163
  | --------------- | ---------------------------------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
164
164
  | **적합한 경우** | AI 에이전트 워크플로우 | 엔터프라이즈 멀티 인스턴스 / 그룹형 도구 | GitLab에 내장, 별도 설치 없음 |
165
- | **도구 모델** | 288개 도구: toolset 285개 + `execute_graphql` + `discover_tools` + `help` | ~50–60개 `browse_*` / `manage_*` 그룹 도구 | HTTP 헤더로 고르는 toolset |
165
+ | **도구 모델** | 290개 도구: toolset 287개 + `execute_graphql` + `discover_tools` + `help` | ~50–60개 `browse_*` / `manage_*` 그룹 도구 | HTTP 헤더로 고르는 toolset |
166
166
  | **MR 리뷰** | 2단계 배치 diff | 서버마다 다름 | `get_merge_request`에 diffs |
167
167
  | **Node.js** | >=20.0.0 | 보통 >=24 | stdio는 `mcp-remote`, Node.js 20+ |
168
168
  | **라이선스** | MIT | 서버마다 다름 | GitLab의 일부 |
package/README.md CHANGED
@@ -19,7 +19,7 @@
19
19
 
20
20
  📖 **[Documentation →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
21
21
 
22
- **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.
22
+ **Default: 40 tools** (38 `core` + `discover_tools` + `help`). 290 tools exist in total (287 in toolsets + `execute_graphql` + `discover_tools` + `help`). Start lean; call `discover_tools` to activate more for this session.
23
23
 
24
24
  > **Token budget:** MCP clients send the whole `tools/list` to the model at session start. Keep the default (~40 tools, ~12k schema tokens). Call `discover_tools` to activate a category for this session (session-only; with `OAUTH_STATELESS_MODE=true` persist a named `GITLAB_TOOLSETS` list), or use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) and skip MCP schemas. **Do not set `GITLAB_TOOLSETS=all`** — it loads ~all tools and costs ~73k schema tokens. See [tools/list size](#toolslist-size-measured-2026-11-14) and [comparison](./docs/comparison/index.md).
25
25
 
@@ -153,7 +153,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
153
153
 
154
154
  ### Why use this GitLab MCP?
155
155
 
156
- - **Default 40 tools (38 `core` + `discover_tools` + `help`); 288 total** — start lean; call `discover_tools` to activate more without CQRS-style grouping. `GITLAB_TOOLSETS=all` loads ~all schemas (~73k tokens); prefer discover-on-demand or Skill + CLI
156
+ - **Default 40 tools (38 `core` + `discover_tools` + `help`); 290 total** — start lean; call `discover_tools` to activate more without CQRS-style grouping. `GITLAB_TOOLSETS=all` loads ~all schemas (~73k tokens); prefer discover-on-demand or Skill + CLI
157
157
  - **MR 2-step review** — `list_merge_request_changed_files` → batched `get_merge_request_file_diff`
158
158
  - **Agent Skill built in** — workflow guidance in `skills/gitlab-mcp/`
159
159
  - **Flexible auth** — Personal Access Token, local OAuth2 browser flow, MCP OAuth proxy, and per-request remote authorization
@@ -167,7 +167,7 @@ Supports PAT, OAuth, read-only mode, dynamic API URLs, and remote authorization
167
167
  | | @zereight/mcp-gitlab | GitLab MCP A (community CQRS-style) | GitLab official MCP server |
168
168
  | -------------- | ----------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
169
169
  | **Best for** | AI agent workflows | Enterprise multi-instance / grouped tools | Built into GitLab, no separate install |
170
- | **Tool model** | 288 tools: 285 in toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 grouped `browse_*` / `manage_*` tools | Toolsets chosen with an HTTP header |
170
+ | **Tool model** | 290 tools: 287 in toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 grouped `browse_*` / `manage_*` tools | Toolsets chosen with an HTTP header |
171
171
  | **MR review** | 2-step batched diff | Varies | `get_merge_request` with diffs |
172
172
  | **Node.js** | >=20.0.0 | Often >=24 | Node.js 20+ for stdio via `mcp-remote` |
173
173
  | **License** | MIT | Varies | Part of GitLab |
@@ -874,213 +874,215 @@ Register the skill directory in your AI client to get optimal tool usage guidanc
874
874
  79. `mark_all_todos_done` - Mark all pending GitLab to-do items as done for the current user
875
875
  80. `list_issue_links` - List all issue links for a specific issue
876
876
  81. `list_issue_discussions` - List discussions for an issue
877
- 82. `get_issue_link` - Get a specific issue link
878
- 83. `create_issue_link` - Create an issue link between two issues
879
- 84. `delete_issue_link` - Delete an issue link
880
- 85. `list_namespaces` - List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only.
881
- 86. `get_namespace` - Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='group'.
882
- 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.
883
- 88. `get_project` - Get details of a specific project
884
- 89. `list_projects` - List projects accessible by the current user
885
- 90. `update_project` - Update project settings such as description, visibility, default branch, and feature access levels
886
- 91. `list_project_members` - List members of a GitLab project
887
- 92. `list_group_members` - List members of a GitLab group with optional name or username search
888
- 93. `list_labels` - List labels for a project
889
- 94. `get_label` - Get a single label from a project
890
- 95. `create_label` - Create a new label in a project
891
- 96. `update_label` - Update an existing label in a project
892
- 97. `delete_label` - Delete a label from a project
893
- 98. `list_group_projects` - List projects in a group
894
- 99. `list_wiki_pages` - List wiki pages in a project
895
- 100. `get_wiki_page` - Get details of a specific wiki page
896
- 101. `create_wiki_page` - Create a wiki page in a project
897
- 102. `update_wiki_page` - Update a wiki page in a project
898
- 103. `delete_wiki_page` - Delete a wiki page from a project
899
- 104. `list_group_wiki_pages` - List wiki pages in a group
900
- 105. `get_group_wiki_page` - Get details of a specific group wiki page
901
- 106. `create_group_wiki_page` - Create a wiki page in a group
902
- 107. `update_group_wiki_page` - Update a wiki page in a group
903
- 108. `delete_group_wiki_page` - Delete a wiki page from a group
904
- 109. `get_repository_tree` - List files and directories in a repository
905
- 110. `list_pipelines` - List pipelines with filtering options
906
- 111. `get_pipeline` - Get details of a specific pipeline
907
- 112. `get_pipeline_variables` - Get variables configured for a pipeline
908
- 113. `get_pipeline_test_report` - Get pipeline test report
909
- 114. `get_pipeline_test_report_summary` - Get pipeline test report summary
910
- 115. `delete_pipeline` - Delete a pipeline. Requires the project Owner role, cannot be undone, and does not automatically delete child pipelines.
911
- 116. `update_pipeline_metadata` - Update pipeline metadata
912
- 117. `list_deployments` - List deployments with filtering options
913
- 118. `get_deployment` - Get deployment details, including approval_summary, approvals, and pending_approval_count when GitLab provides them
914
- 119. `create_deployment` - Create a deployment
915
- 120. `update_deployment` - Update a deployment status
916
- 121. `delete_deployment` - Delete a deployment
917
- 122. `list_deployment_merge_requests` - List merge requests shipped with a deployment
918
- 123. `approve_deployment` - Approve or reject a protected-environment deployment
919
- 124. `list_environments` - List environments in a project
920
- 125. `get_environment` - Get details of a specific environment
921
- 126. `update_environment` - Update an environment
922
- 127. `delete_environment` - Delete a stopped environment
923
- 128. `stop_environment` - Stop an environment
924
- 129. `stop_stale_environments` - Stop eligible stale environments; protected environments are excluded and environments are stopped, not deleted
925
- 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
926
- 131. `list_pipeline_triggers` - List project pipeline trigger tokens
927
- 132. `get_pipeline_trigger` - Get a project pipeline trigger
928
- 133. `create_pipeline_trigger` - Create a project pipeline trigger
929
- 134. `update_pipeline_trigger` - Update a project pipeline trigger
930
- 135. `delete_pipeline_trigger` - Delete a project pipeline trigger
931
- 136. `trigger_pipeline` - Trigger a pipeline with a pipeline trigger token
932
- 137. `list_pipeline_jobs` - List all jobs in a specific pipeline
933
- 138. `list_pipeline_trigger_jobs` - List trigger jobs (bridges) in a pipeline
934
- 139. `get_pipeline_job` - Get details of a GitLab pipeline job number
935
- 140. `get_pipeline_job_output` - Get a pipeline job trace, with end-based pagination or full-log substring/regex search
936
- 141. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
937
- 142. `validate_project_ci_lint` - Validate an existing .gitlab-ci.yml configuration for a project
938
- 143. `list_ci_catalog_resources` - List GitLab CI/CD Catalog resources/components visible to the user
939
- 144. `get_ci_catalog_resource` - Get details for a GitLab CI/CD Catalog resource, including versions and components
940
- 145. `create_pipeline` - Create a new pipeline for a branch or tag
941
- 146. `retry_pipeline` - Retry a failed or canceled pipeline
942
- 147. `cancel_pipeline` - Cancel a running pipeline
943
- 148. `list_pipeline_schedules` - List pipeline schedules in a project, optionally filtered to active or inactive
944
- 149. `get_pipeline_schedule` - Get details of a specific pipeline schedule, including its variables and last pipeline
945
- 150. `list_pipeline_schedule_pipelines` - List the pipelines that a pipeline schedule has triggered
946
- 151. `create_pipeline_schedule` - Create a new pipeline schedule for a branch or tag
947
- 152. `update_pipeline_schedule` - Update an existing pipeline schedule
948
- 153. `delete_pipeline_schedule` - Delete a pipeline schedule
949
- 154. `play_pipeline_schedule` - Run a pipeline schedule immediately
950
- 155. `take_ownership_pipeline_schedule` - Take ownership of a pipeline schedule
951
- 156. `get_pipeline_schedule_variable` - Get a single variable of a pipeline schedule
952
- 157. `create_pipeline_schedule_variable` - Create a variable for a pipeline schedule
953
- 158. `update_pipeline_schedule_variable` - Update a variable of a pipeline schedule
954
- 159. `delete_pipeline_schedule_variable` - Delete a variable from a pipeline schedule
955
- 160. `play_pipeline_job` - Run a manual pipeline job
956
- 161. `play_pipeline_jobs` - Play multiple manual pipeline jobs sequentially
957
- 162. `retry_pipeline_job` - Retry a failed or canceled pipeline job
958
- 163. `cancel_pipeline_job` - Cancel a running pipeline job
959
- 164. `erase_pipeline_job` - Erase a pipeline job log and artifacts
960
- 165. `wait_for_pipeline` - Wait for a pipeline to reach a terminal status
961
- 166. `wait_for_job` - Wait for a job to reach a terminal status
962
- 167. `list_job_artifacts` - List artifact files in a job's archive
963
- 168. `download_job_artifacts` - Download job artifact archive (zip) and save it under the download directory
964
- 169. `get_job_artifact_file` - Get content of a single file from a job's artifacts
965
- 170. `list_merge_requests` - List merge requests (without project_id: user's MRs; with project_id: project MRs)
966
- 171. `list_group_merge_requests` - List merge requests across all projects of a group and its subgroups
967
- 172. `list_milestones` - List milestones with filtering options
968
- 173. `get_milestone` - Get details of a specific milestone
969
- 174. `create_milestone` - Create a new milestone
970
- 175. `edit_milestone` - Edit an existing milestone
971
- 176. `delete_milestone` - Delete a milestone
972
- 177. `get_milestone_issue` - Get issues associated with a specific milestone
973
- 178. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
974
- 179. `promote_milestone` - Promote a milestone to the next stage
975
- 180. `get_milestone_burndown_events` - Get burndown events for a specific milestone
976
- 181. `list_group_milestones` - List group milestones with filtering options
977
- 182. `get_group_milestone` - Get details of a specific group milestone
978
- 183. `create_group_milestone` - Create a new group milestone
979
- 184. `edit_group_milestone` - Edit an existing group milestone
980
- 185. `delete_group_milestone` - Delete a group milestone
981
- 186. `get_group_milestone_issue` - Get issues associated with a specific group milestone
982
- 187. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
983
- 188. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
984
- 189. `get_users` - Get GitLab user details by usernames
985
- 190. `get_user` - Get user details by ID
986
- 191. `whoami` - Get current authenticated user details
987
- 192. `list_commits` - List repository commits with filtering options
988
- 193. `get_commit` - Get details of a specific commit
989
- 194. `get_commit_diff` - Get changes/diffs of a specific commit
990
- 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.
991
- 196. `list_commit_statuses` - List statuses for a commit
992
- 197. `create_commit_status` - Create or update the status of a commit
993
- 198. `list_group_iterations` - List group iterations with filtering options
994
- 199. `get_group_iteration` - Get a group iteration by ID, IID, or GraphQL GID
995
- 200. `update_group_iteration` - Update a manual group iteration's title, description, or dates
996
- 201. `create_group_iteration` - Create a group iteration, optionally in a given iteration cadence
997
- 202. `delete_group_iteration` - Delete a group iteration by ID, IID, or GraphQL GID
998
- 203. `list_project_iterations` - List the iterations available to a project with filtering options
999
- 204. `list_group_iteration_cadences` - List a group's iteration cadences with filtering options
1000
- 205. `create_group_iteration_cadence` - Create an iteration cadence in a group
1001
- 206. `update_group_iteration_cadence` - Update an iteration cadence's title, description, schedule, or automation
1002
- 207. `delete_group_iteration_cadence` - Delete an iteration cadence
1003
- 208. `upload_markdown` - Upload a file for use in markdown content
1004
- 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)
1005
- 210. `health_check` - Check auth and versions. Always includes mcp_server_version. When authenticated, also GitLab version, revision, and enterprise from GET /api/v4/version. Version lookup failures omit those fields instead of failing
1006
- 211. `list_events` - List events for the authenticated user (before/after: YYYY-MM-DD)
1007
- 212. `get_project_events` - List events for a project (before/after: YYYY-MM-DD)
1008
- 213. `list_releases` - List all releases for a project
1009
- 214. `get_release` - Get a release by tag name
1010
- 215. `create_release` - Create a new release
1011
- 216. `update_release` - Update an existing release
1012
- 217. `delete_release` - Delete a release (does not delete the tag)
1013
- 218. `create_release_evidence` - Create release evidence (Premium/Ultimate)
1014
- 219. `download_release_asset` - Download a release asset file by direct asset path
1015
- 220. `list_tags` - List repository tags for a project
1016
- 221. `get_tag` - Get a repository tag by name
1017
- 222. `create_tag` - Create a new repository tag
1018
- 223. `delete_tag` - Delete a repository tag
1019
- 224. `get_tag_signature` - Get the X.509 signature of a signed tag (404 if unsigned)
1020
- 225. `list_protected_tags` - List protected tags in a project
1021
- 226. `get_protected_tag` - Get details of a single protected tag or wildcard (create access levels)
1022
- 227. `protect_tag` - Protect a repository tag or wildcard (set who can create it)
1023
- 228. `unprotect_tag` - Remove protection from a previously protected tag or wildcard
1024
- 229. `get_work_item` - Get a work item with full details including status, hierarchy, type, and widgets
1025
- 230. `list_work_items` - List work items with filters (type, state, search, assignees, labels)
1026
- 231. `create_work_item` - Create a work item (issue, task, incident, epic, etc.) with full field support
1027
- 232. `update_work_item` - Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)
1028
- 233. `convert_work_item_type` - Convert a work item to a different type
1029
- 234. `list_work_item_statuses` - List available statuses for a work item type (Premium/Ultimate)
1030
- 235. `list_custom_field_definitions` - List custom field definitions for a work item type
1031
- 236. `move_work_item` - Move a work item to a different project
1032
- 237. `list_work_item_notes` - List notes and discussions on a work item
1033
- 238. `create_work_item_note` - Add a note to a work item (supports Markdown, internal notes, threads)
1034
- 239. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
1035
- 240. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
1036
- 241. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
1037
- 242. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
1038
- 243. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
1039
- 244. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
1040
- 245. `get_timeline_events` - List timeline events for an incident
1041
- 246. `create_timeline_event` - Create a timeline event on an incident
1042
- 247. `list_webhooks` - List webhooks for a project or group
1043
- 248. `create_webhook` - Create a webhook on a project or group
1044
- 249. `update_webhook` - Update an existing project or group webhook
1045
- 250. `delete_webhook` - Delete a project or group webhook
1046
- 251. `list_webhook_events` - List recent webhook events (past 7 days)
1047
- 252. `get_webhook_event` - Get full details of a specific webhook event
1048
- 253. `search_code` - Search for code across all projects (requires advanced search or Zoekt)
1049
- 254. `search_project_code` - Search for code within a specific project (requires advanced search or Zoekt)
1050
- 255. `search_group_code` - Search for code within a specific group (requires advanced search or Zoekt)
1051
- 256. `list_project_variables` - List CI/CD variables for a project
1052
- 257. `get_project_variable` - Get a single CI/CD variable from a project
1053
- 258. `create_project_variable` - Create a CI/CD variable for a project
1054
- 259. `update_project_variable` - Update an existing CI/CD variable in a project
1055
- 260. `delete_project_variable` - Delete a CI/CD variable from a project
1056
- 261. `list_group_variables` - List CI/CD variables for a group
1057
- 262. `get_group_variable` - Get a single CI/CD variable from a group
1058
- 263. `create_group_variable` - Create a CI/CD variable for a group
1059
- 264. `update_group_variable` - Update an existing CI/CD variable in a group
1060
- 265. `delete_group_variable` - Delete a CI/CD variable from a group
1061
- 266. `get_dependency_proxy_settings` - Get dependency proxy settings for a group
1062
- 267. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
1063
- 268. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group
1064
- 269. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
1065
- 270. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
1066
- 271. `get_vulnerability` - Get full details of a specific vulnerability
1067
- 272. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
1068
- 273. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
1069
- 274. `orbit_query` - Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph
1070
- 275. `orbit_get_schema` - Fetch the current GitLab Orbit graph schema (node and edge types)
1071
- 276. `orbit_get_status` - Check GitLab Orbit indexing status for the enabled scope
1072
- 277. `orbit_list_tools` - List the MCP tool definitions exposed by GitLab Orbit
1073
- 278. `list_snippets` - List snippets — project snippets when project_id is given, otherwise personal snippets
1074
- 279. `get_snippet` - Get a snippet's metadata. Set include_content=true to also fetch the raw file content.
1075
- 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.
1076
- 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.
1077
- 282. `delete_snippet` - Delete a snippet
1078
- 283. `list_project_runners` - List runners available to a project (type, status, paused, tag_list). Omits registration and authentication tokens.
1079
- 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.
1080
- 285. `rebase_merge_request` - Rebase the source branch of a merge request onto its target branch
1081
- 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.
1082
- 287. `discover_tools` - List or activate a toolset for this session. Omit category to list; pass one to enable. Prefer this over GITLAB_TOOLSETS=all (loads ~all schemas). Session-only; with OAUTH_STATELESS_MODE=true persist GITLAB_TOOLSETS.
1083
- 288. `help` - Return a short GitLab workflow guide. Omit topic for the overview and topic list.
877
+ 82. `list_issue_label_events` - List an issue's label history: who added or removed which label, when. Lean events: created_at, user.username, action, label.name (label is null if deleted). Paginated via page/per_page.
878
+ 83. `list_issue_state_events` - List an issue's state history: who closed or reopened it, when. Lean events: created_at, user.username, state. Paginated via page/per_page.
879
+ 84. `get_issue_link` - Get a specific issue link
880
+ 85. `create_issue_link` - Create an issue link between two issues
881
+ 86. `delete_issue_link` - Delete an issue link
882
+ 87. `list_namespaces` - List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only.
883
+ 88. `get_namespace` - Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='group'.
884
+ 89. `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.
885
+ 90. `get_project` - Get details of a specific project
886
+ 91. `list_projects` - List projects accessible by the current user
887
+ 92. `update_project` - Update project settings such as description, visibility, default branch, and feature access levels
888
+ 93. `list_project_members` - List members of a GitLab project
889
+ 94. `list_group_members` - List members of a GitLab group with optional name or username search
890
+ 95. `list_labels` - List labels for a project
891
+ 96. `get_label` - Get a single label from a project
892
+ 97. `create_label` - Create a new label in a project
893
+ 98. `update_label` - Update an existing label in a project
894
+ 99. `delete_label` - Delete a label from a project
895
+ 100. `list_group_projects` - List projects in a group
896
+ 101. `list_wiki_pages` - List wiki pages in a project
897
+ 102. `get_wiki_page` - Get details of a specific wiki page
898
+ 103. `create_wiki_page` - Create a wiki page in a project
899
+ 104. `update_wiki_page` - Update a wiki page in a project
900
+ 105. `delete_wiki_page` - Delete a wiki page from a project
901
+ 106. `list_group_wiki_pages` - List wiki pages in a group
902
+ 107. `get_group_wiki_page` - Get details of a specific group wiki page
903
+ 108. `create_group_wiki_page` - Create a wiki page in a group
904
+ 109. `update_group_wiki_page` - Update a wiki page in a group
905
+ 110. `delete_group_wiki_page` - Delete a wiki page from a group
906
+ 111. `get_repository_tree` - List files and directories in a repository
907
+ 112. `list_pipelines` - List pipelines with filtering options
908
+ 113. `get_pipeline` - Get details of a specific pipeline
909
+ 114. `get_pipeline_variables` - Get variables configured for a pipeline
910
+ 115. `get_pipeline_test_report` - Get pipeline test report
911
+ 116. `get_pipeline_test_report_summary` - Get pipeline test report summary
912
+ 117. `delete_pipeline` - Delete a pipeline. Requires the project Owner role, cannot be undone, and does not automatically delete child pipelines.
913
+ 118. `update_pipeline_metadata` - Update pipeline metadata
914
+ 119. `list_deployments` - List deployments with filtering options
915
+ 120. `get_deployment` - Get deployment details, including approval_summary, approvals, and pending_approval_count when GitLab provides them
916
+ 121. `create_deployment` - Create a deployment
917
+ 122. `update_deployment` - Update a deployment status
918
+ 123. `delete_deployment` - Delete a deployment
919
+ 124. `list_deployment_merge_requests` - List merge requests shipped with a deployment
920
+ 125. `approve_deployment` - Approve or reject a protected-environment deployment
921
+ 126. `list_environments` - List environments in a project
922
+ 127. `get_environment` - Get details of a specific environment
923
+ 128. `update_environment` - Update an environment
924
+ 129. `delete_environment` - Delete a stopped environment
925
+ 130. `stop_environment` - Stop an environment
926
+ 131. `stop_stale_environments` - Stop eligible stale environments; protected environments are excluded and environments are stopped, not deleted
927
+ 132. `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
928
+ 133. `list_pipeline_triggers` - List project pipeline trigger tokens
929
+ 134. `get_pipeline_trigger` - Get a project pipeline trigger
930
+ 135. `create_pipeline_trigger` - Create a project pipeline trigger
931
+ 136. `update_pipeline_trigger` - Update a project pipeline trigger
932
+ 137. `delete_pipeline_trigger` - Delete a project pipeline trigger
933
+ 138. `trigger_pipeline` - Trigger a pipeline with a pipeline trigger token
934
+ 139. `list_pipeline_jobs` - List all jobs in a specific pipeline
935
+ 140. `list_pipeline_trigger_jobs` - List trigger jobs (bridges) in a pipeline
936
+ 141. `get_pipeline_job` - Get details of a GitLab pipeline job number
937
+ 142. `get_pipeline_job_output` - Get a pipeline job trace, with end-based pagination or full-log substring/regex search
938
+ 143. `validate_ci_lint` - Validate provided GitLab CI/CD YAML content for a project
939
+ 144. `validate_project_ci_lint` - Validate an existing .gitlab-ci.yml configuration for a project
940
+ 145. `list_ci_catalog_resources` - List GitLab CI/CD Catalog resources/components visible to the user
941
+ 146. `get_ci_catalog_resource` - Get details for a GitLab CI/CD Catalog resource, including versions and components
942
+ 147. `create_pipeline` - Create a new pipeline for a branch or tag
943
+ 148. `retry_pipeline` - Retry a failed or canceled pipeline
944
+ 149. `cancel_pipeline` - Cancel a running pipeline
945
+ 150. `list_pipeline_schedules` - List pipeline schedules in a project, optionally filtered to active or inactive
946
+ 151. `get_pipeline_schedule` - Get details of a specific pipeline schedule, including its variables and last pipeline
947
+ 152. `list_pipeline_schedule_pipelines` - List the pipelines that a pipeline schedule has triggered
948
+ 153. `create_pipeline_schedule` - Create a new pipeline schedule for a branch or tag
949
+ 154. `update_pipeline_schedule` - Update an existing pipeline schedule
950
+ 155. `delete_pipeline_schedule` - Delete a pipeline schedule
951
+ 156. `play_pipeline_schedule` - Run a pipeline schedule immediately
952
+ 157. `take_ownership_pipeline_schedule` - Take ownership of a pipeline schedule
953
+ 158. `get_pipeline_schedule_variable` - Get a single variable of a pipeline schedule
954
+ 159. `create_pipeline_schedule_variable` - Create a variable for a pipeline schedule
955
+ 160. `update_pipeline_schedule_variable` - Update a variable of a pipeline schedule
956
+ 161. `delete_pipeline_schedule_variable` - Delete a variable from a pipeline schedule
957
+ 162. `play_pipeline_job` - Run a manual pipeline job
958
+ 163. `play_pipeline_jobs` - Play multiple manual pipeline jobs sequentially
959
+ 164. `retry_pipeline_job` - Retry a failed or canceled pipeline job
960
+ 165. `cancel_pipeline_job` - Cancel a running pipeline job
961
+ 166. `erase_pipeline_job` - Erase a pipeline job log and artifacts
962
+ 167. `wait_for_pipeline` - Wait for a pipeline to reach a terminal status
963
+ 168. `wait_for_job` - Wait for a job to reach a terminal status
964
+ 169. `list_job_artifacts` - List artifact files in a job's archive
965
+ 170. `download_job_artifacts` - Download job artifact archive (zip) and save it under the download directory
966
+ 171. `get_job_artifact_file` - Get content of a single file from a job's artifacts
967
+ 172. `list_merge_requests` - List merge requests (without project_id: user's MRs; with project_id: project MRs)
968
+ 173. `list_group_merge_requests` - List merge requests across all projects of a group and its subgroups
969
+ 174. `list_milestones` - List milestones with filtering options
970
+ 175. `get_milestone` - Get details of a specific milestone
971
+ 176. `create_milestone` - Create a new milestone
972
+ 177. `edit_milestone` - Edit an existing milestone
973
+ 178. `delete_milestone` - Delete a milestone
974
+ 179. `get_milestone_issue` - Get issues associated with a specific milestone
975
+ 180. `get_milestone_merge_requests` - Get merge requests associated with a specific milestone
976
+ 181. `promote_milestone` - Promote a milestone to the next stage
977
+ 182. `get_milestone_burndown_events` - Get burndown events for a specific milestone
978
+ 183. `list_group_milestones` - List group milestones with filtering options
979
+ 184. `get_group_milestone` - Get details of a specific group milestone
980
+ 185. `create_group_milestone` - Create a new group milestone
981
+ 186. `edit_group_milestone` - Edit an existing group milestone
982
+ 187. `delete_group_milestone` - Delete a group milestone
983
+ 188. `get_group_milestone_issue` - Get issues associated with a specific group milestone
984
+ 189. `get_group_milestone_merge_requests` - Get merge requests associated with a specific group milestone
985
+ 190. `get_group_milestone_burndown_events` - Get burndown events for a specific group milestone
986
+ 191. `get_users` - Get GitLab user details by usernames
987
+ 192. `get_user` - Get user details by ID
988
+ 193. `whoami` - Get current authenticated user details
989
+ 194. `list_commits` - List repository commits with filtering options
990
+ 195. `get_commit` - Get details of a specific commit
991
+ 196. `get_commit_diff` - Get changes/diffs of a specific commit
992
+ 197. `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.
993
+ 198. `list_commit_statuses` - List statuses for a commit
994
+ 199. `create_commit_status` - Create or update the status of a commit
995
+ 200. `list_group_iterations` - List group iterations with filtering options
996
+ 201. `get_group_iteration` - Get a group iteration by ID, IID, or GraphQL GID
997
+ 202. `update_group_iteration` - Update a manual group iteration's title, description, or dates
998
+ 203. `create_group_iteration` - Create a group iteration, optionally in a given iteration cadence
999
+ 204. `delete_group_iteration` - Delete a group iteration by ID, IID, or GraphQL GID
1000
+ 205. `list_project_iterations` - List the iterations available to a project with filtering options
1001
+ 206. `list_group_iteration_cadences` - List a group's iteration cadences with filtering options
1002
+ 207. `create_group_iteration_cadence` - Create an iteration cadence in a group
1003
+ 208. `update_group_iteration_cadence` - Update an iteration cadence's title, description, schedule, or automation
1004
+ 209. `delete_group_iteration_cadence` - Delete an iteration cadence
1005
+ 210. `upload_markdown` - Upload a file for use in markdown content
1006
+ 211. `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)
1007
+ 212. `health_check` - Check auth and versions. Always includes mcp_server_version. When authenticated, also GitLab version, revision, and enterprise from GET /api/v4/version. Version lookup failures omit those fields instead of failing
1008
+ 213. `list_events` - List events for the authenticated user (before/after: YYYY-MM-DD)
1009
+ 214. `get_project_events` - List events for a project (before/after: YYYY-MM-DD)
1010
+ 215. `list_releases` - List all releases for a project
1011
+ 216. `get_release` - Get a release by tag name
1012
+ 217. `create_release` - Create a new release
1013
+ 218. `update_release` - Update an existing release
1014
+ 219. `delete_release` - Delete a release (does not delete the tag)
1015
+ 220. `create_release_evidence` - Create release evidence (Premium/Ultimate)
1016
+ 221. `download_release_asset` - Download a release asset file by direct asset path
1017
+ 222. `list_tags` - List repository tags for a project
1018
+ 223. `get_tag` - Get a repository tag by name
1019
+ 224. `create_tag` - Create a new repository tag
1020
+ 225. `delete_tag` - Delete a repository tag
1021
+ 226. `get_tag_signature` - Get the X.509 signature of a signed tag (404 if unsigned)
1022
+ 227. `list_protected_tags` - List protected tags in a project
1023
+ 228. `get_protected_tag` - Get details of a single protected tag or wildcard (create access levels)
1024
+ 229. `protect_tag` - Protect a repository tag or wildcard (set who can create it)
1025
+ 230. `unprotect_tag` - Remove protection from a previously protected tag or wildcard
1026
+ 231. `get_work_item` - Get a work item with full details including status, hierarchy, type, and widgets
1027
+ 232. `list_work_items` - List work items with filters (type, state, search, assignees, labels)
1028
+ 233. `create_work_item` - Create a work item (issue, task, incident, epic, etc.) with full field support
1029
+ 234. `update_work_item` - Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)
1030
+ 235. `convert_work_item_type` - Convert a work item to a different type
1031
+ 236. `list_work_item_statuses` - List available statuses for a work item type (Premium/Ultimate)
1032
+ 237. `list_custom_field_definitions` - List custom field definitions for a work item type
1033
+ 238. `move_work_item` - Move a work item to a different project
1034
+ 239. `list_work_item_notes` - List notes and discussions on a work item
1035
+ 240. `create_work_item_note` - Add a note to a work item (supports Markdown, internal notes, threads)
1036
+ 241. `list_work_item_emoji_reactions` - List all emoji reactions on a work item
1037
+ 242. `list_work_item_note_emoji_reactions` - List all emoji reactions on a work item note (comment, thread, or thread reply)
1038
+ 243. `create_work_item_emoji_reaction` - Add an emoji reaction to a work item (e.g. thumbsup, rocket, eyes)
1039
+ 244. `delete_work_item_emoji_reaction` - Remove an emoji reaction from a work item
1040
+ 245. `create_work_item_note_emoji_reaction` - Add an emoji reaction to a work item note (comment, thread, or thread reply)
1041
+ 246. `delete_work_item_note_emoji_reaction` - Remove an emoji reaction from a work item note (comment, thread, or thread reply)
1042
+ 247. `get_timeline_events` - List timeline events for an incident
1043
+ 248. `create_timeline_event` - Create a timeline event on an incident
1044
+ 249. `list_webhooks` - List webhooks for a project or group
1045
+ 250. `create_webhook` - Create a webhook on a project or group
1046
+ 251. `update_webhook` - Update an existing project or group webhook
1047
+ 252. `delete_webhook` - Delete a project or group webhook
1048
+ 253. `list_webhook_events` - List recent webhook events (past 7 days)
1049
+ 254. `get_webhook_event` - Get full details of a specific webhook event
1050
+ 255. `search_code` - Search for code across all projects (requires advanced search or Zoekt)
1051
+ 256. `search_project_code` - Search for code within a specific project (requires advanced search or Zoekt)
1052
+ 257. `search_group_code` - Search for code within a specific group (requires advanced search or Zoekt)
1053
+ 258. `list_project_variables` - List CI/CD variables for a project
1054
+ 259. `get_project_variable` - Get a single CI/CD variable from a project
1055
+ 260. `create_project_variable` - Create a CI/CD variable for a project
1056
+ 261. `update_project_variable` - Update an existing CI/CD variable in a project
1057
+ 262. `delete_project_variable` - Delete a CI/CD variable from a project
1058
+ 263. `list_group_variables` - List CI/CD variables for a group
1059
+ 264. `get_group_variable` - Get a single CI/CD variable from a group
1060
+ 265. `create_group_variable` - Create a CI/CD variable for a group
1061
+ 266. `update_group_variable` - Update an existing CI/CD variable in a group
1062
+ 267. `delete_group_variable` - Delete a CI/CD variable from a group
1063
+ 268. `get_dependency_proxy_settings` - Get dependency proxy settings for a group
1064
+ 269. `update_dependency_proxy_settings` - Update dependency proxy settings for a group (enable/disable, credentials for authenticated Docker Hub pulls)
1065
+ 270. `list_dependency_proxy_blobs` - List cached dependency proxy blobs for a group
1066
+ 271. `purge_dependency_proxy_cache` - Schedule purge of all cached dependency proxy blobs for a group
1067
+ 272. `list_project_vulnerabilities` - List vulnerabilities for a project with optional state, severity, and report type filters (GraphQL-backed, cursor pagination)
1068
+ 273. `get_vulnerability` - Get full details of a specific vulnerability
1069
+ 274. `dismiss_vulnerability` - Dismiss a vulnerability with a reason (acceptable_risk, false_positive, used_in_tests, mitigating_control, not_applicable) and optional comment
1070
+ 275. `confirm_vulnerability` - Confirm a vulnerability as a real finding requiring remediation
1071
+ 276. `orbit_query` - Execute a GitLab Orbit graph query over the indexed SDLC knowledge graph
1072
+ 277. `orbit_get_schema` - Fetch the current GitLab Orbit graph schema (node and edge types)
1073
+ 278. `orbit_get_status` - Check GitLab Orbit indexing status for the enabled scope
1074
+ 279. `orbit_list_tools` - List the MCP tool definitions exposed by GitLab Orbit
1075
+ 280. `list_snippets` - List snippets — project snippets when project_id is given, otherwise personal snippets
1076
+ 281. `get_snippet` - Get a snippet's metadata. Set include_content=true to also fetch the raw file content.
1077
+ 282. `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.
1078
+ 283. `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.
1079
+ 284. `delete_snippet` - Delete a snippet
1080
+ 285. `list_project_runners` - List runners available to a project (type, status, paused, tag_list). Omits registration and authentication tokens.
1081
+ 286. `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.
1082
+ 287. `rebase_merge_request` - Rebase the source branch of a merge request onto its target branch
1083
+ 288. `gitlab_api_request` - Send one GitLab REST call under /api/v4. Enabled only when GITLAB_TOOLSETS lists api. Readonly allows GET; modify rejects DELETE.
1084
+ 289. `discover_tools` - List or activate a toolset for this session. Omit category to list; pass one to enable. Prefer this over GITLAB_TOOLSETS=all (loads ~all schemas). Session-only; with OAUTH_STATELESS_MODE=true persist GITLAB_TOOLSETS.
1085
+ 290. `help` - Return a short GitLab workflow guide. Omit topic for the overview and topic list.
1084
1086
 
1085
1087
  <!-- TOOLS-END -->
1086
1088
 
package/README.pt-BR.md CHANGED
@@ -14,7 +14,7 @@
14
14
 
15
15
  📖 **[Documentação →](https://zereight.github.io/gitlab-mcp/)** · [llms.txt](./llms.txt) · [llms-full.txt](./llms-full.txt)
16
16
 
17
- **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.
17
+ **Padrão: 40 ferramentas** (38 `core` + `discover_tools` + `help`). Existem 290 no total (287 em toolsets + `execute_graphql` + `discover_tools` + `help`). Comece enxuto; chame `discover_tools` para ativar mais nesta sessão.
18
18
 
19
19
  > **Orçamento de tokens:** clientes MCP enviam o `tools/list` inteiro ao modelo no início da sessão. Mantenha o padrão (~40 ferramentas, ~12k tokens de schema). Chame `discover_tools` para ativar uma categoria nesta sessão (somente nesta sessão; com `OAUTH_STATELESS_MODE=true` persista uma lista `GITLAB_TOOLSETS`), ou use [Skill + CLI](./docs/getting-started/cli-without-mcp.md) e pule os schemas MCP. **Não defina `GITLAB_TOOLSETS=all`** — carrega quase todas as ferramentas e custa ~73k tokens de schema. Veja [tamanho do tools/list](#tamanho-do-toolslist-medido-em-2026-11-14) e [comparação](./docs/comparison/index.md).
20
20
 
@@ -148,7 +148,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinâmicas e autorização
148
148
 
149
149
  ### Por que usar este GitLab MCP?
150
150
 
151
- - **40 ferramentas por padrão (38 `core` + `discover_tools` + `help`); 288 no total** — comece enxuto; chame `discover_tools` para expandir nesta sessão. `GITLAB_TOOLSETS=all` custa ~73k tokens de schema; prefira descoberta sob demanda ou Skill + CLI
151
+ - **40 ferramentas por padrão (38 `core` + `discover_tools` + `help`); 290 no total** — comece enxuto; chame `discover_tools` para expandir nesta sessão. `GITLAB_TOOLSETS=all` custa ~73k tokens de schema; prefira descoberta sob demanda ou Skill + CLI
152
152
  - **Revisão de MR em 2 etapas** — `list_merge_request_changed_files` → `get_merge_request_file_diff` em lote
153
153
  - **Agent Skill integrado** — orientação de workflows em `skills/gitlab-mcp/`
154
154
  - **Autenticação flexível** — Personal Access Token, fluxo OAuth2 local no navegador, proxy MCP OAuth e autorização remota por requisição
@@ -162,7 +162,7 @@ Suporta PAT, OAuth, modo somente leitura, URLs de API dinâmicas e autorização
162
162
  | | @zereight/mcp-gitlab | GitLab MCP A (comunidade, estilo CQRS) | Servidor MCP oficial do GitLab |
163
163
  | ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
164
164
  | **Mais indicado para** | Workflows de agentes de IA | Múltiplas instâncias corporativas / ferramentas agrupadas | Integrado ao GitLab, sem instalação separada |
165
- | **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 |
165
+ | **Modelo de ferramentas** | 290 ferramentas: 287 em toolsets + `execute_graphql` + `discover_tools` + `help` | ~50–60 ferramentas agrupadas `browse_*` / `manage_*` | Toolsets escolhidos por cabeçalho HTTP |
166
166
  | **Revisão de MR** | Diff em lote em 2 etapas | Varia | `get_merge_request` com diffs |
167
167
  | **Node.js** | >=20.0.0 | Frequentemente >=24 | Node.js 20+ para stdio via `mcp-remote` |
168
168
  | **Licença** | MIT | Varia | Parte do GitLab |