@zereight/mcp-gitlab 2.3.28-next.245 โ†’ 2.3.29-next.248

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์˜ ์ผ๋ถ€ |
@@ -262,7 +262,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
262
262
 
263
263
  ์˜ˆ์‹œ๋Š” ๊ธฐ์กด `mcp-gitlab`๋ณด๋‹ค ์ถฉ๋Œ ๊ฐ€๋Šฅ์„ฑ์ด ๋‚ฎ์€ `zereight-mcp-gitlab` ๋ณ„์นญ์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. MCP ํด๋ผ์ด์–ธํŠธ๊ฐ€ ์ฐพ์ง€ ๋ชปํ•˜๋ฉด `which zereight-mcp-gitlab`์˜ ์ ˆ๋Œ€ ๊ฒฝ๋กœ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.
264
264
 
265
- ์ „์—ญ ์„ค์น˜๋ฅผ ์“ฐ์ง€ ์•Š์œผ๋ ค๋ฉด `npx -y @zereight/mcp-gitlab@2.3.26`์ฒ˜๋Ÿผ ์ง์ „ ์•ˆ์ • ๋ฒ„์ „(๋ฌธ์„œ๊ฐ€ ๊ถŒ์žฅํ•˜๋Š” ๋ฒ„์ „)์œผ๋กœ ๊ณ ์ •ํ•˜์„ธ์š”. ํ•ญ์ƒ ์ตœ์‹  ๋ฒ„์ „์„ ์›ํ•˜๋ฉด `npx -y @zereight/mcp-gitlab@latest`๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. `main`์— ๋จธ์ง€๋œ ์ˆ˜์ •์„ ๋‹ค์Œ ์•ˆ์ • ๋ฒ„์ „ ์ „์— ํ™•์ธํ•˜๋ ค๋ฉด ํ”„๋ฆฌ๋ฆด๋ฆฌ์Šค ๋นŒ๋“œ์ธ `npx -y @zereight/mcp-gitlab@next`๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”(์šด์˜ ํ™˜๊ฒฝ์šฉ์ด ์•„๋‹™๋‹ˆ๋‹ค). ์ƒˆ ๋ฒ„์ „์ด ๋‚˜์˜ค๋ฉด ์„œ๋ฒ„๊ฐ€ ์‹œ์ž‘ ์‹œ stderr๋กœ ์•Œ๋ ค์ค๋‹ˆ๋‹ค(`GITLAB_DISABLE_VERSION_CHECK=true`๋กœ ๋น„ํ™œ์„ฑํ™” ๊ฐ€๋Šฅ).
265
+ ์ „์—ญ ์„ค์น˜๋ฅผ ์“ฐ์ง€ ์•Š์œผ๋ ค๋ฉด `npx -y @zereight/mcp-gitlab@2.3.27`์ฒ˜๋Ÿผ ์ง์ „ ์•ˆ์ • ๋ฒ„์ „(๋ฌธ์„œ๊ฐ€ ๊ถŒ์žฅํ•˜๋Š” ๋ฒ„์ „)์œผ๋กœ ๊ณ ์ •ํ•˜์„ธ์š”. ํ•ญ์ƒ ์ตœ์‹  ๋ฒ„์ „์„ ์›ํ•˜๋ฉด `npx -y @zereight/mcp-gitlab@latest`๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. `main`์— ๋จธ์ง€๋œ ์ˆ˜์ •์„ ๋‹ค์Œ ์•ˆ์ • ๋ฒ„์ „ ์ „์— ํ™•์ธํ•˜๋ ค๋ฉด ํ”„๋ฆฌ๋ฆด๋ฆฌ์Šค ๋นŒ๋“œ์ธ `npx -y @zereight/mcp-gitlab@next`๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”(์šด์˜ ํ™˜๊ฒฝ์šฉ์ด ์•„๋‹™๋‹ˆ๋‹ค). ์ƒˆ ๋ฒ„์ „์ด ๋‚˜์˜ค๋ฉด ์„œ๋ฒ„๊ฐ€ ์‹œ์ž‘ ์‹œ stderr๋กœ ์•Œ๋ ค์ค๋‹ˆ๋‹ค(`GITLAB_DISABLE_VERSION_CHECK=true`๋กœ ๋น„ํ™œ์„ฑํ™” ๊ฐ€๋Šฅ).
266
266
 
267
267
  #### Claude Desktop ์›ํด๋ฆญ ์„ค์น˜(MCP Bundle)
268
268
 
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 |
@@ -267,7 +267,7 @@ The store path is pinned by your lock file; update it with `nix flake update git
267
267
 
268
268
  The examples use `zereight-mcp-gitlab`, a less collision-prone alias for the legacy `mcp-gitlab` binary. If your MCP client cannot find it, use the absolute path from `which zereight-mcp-gitlab`.
269
269
 
270
- No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.26`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. To try a fix merged to `main` before the next stable release, use `npx -y @zereight/mcp-gitlab@next`, a pre-release build that is not meant for production. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
270
+ No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.27`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. To try a fix merged to `main` before the next stable release, use `npx -y @zereight/mcp-gitlab@next`, a pre-release build that is not meant for production. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
271
271
 
272
272
  #### Claude Desktop one-click install (MCP Bundle)
273
273
 
@@ -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 |
@@ -262,7 +262,7 @@ O caminho no store รฉ fixado pelo seu lock file; atualize-o com `nix flake updat
262
262
 
263
263
  Os exemplos usam `zereight-mcp-gitlab`, um alias com menor chance de conflito que o binรกrio legado `mcp-gitlab`. Se o seu cliente MCP nรฃo o encontrar, use o caminho absoluto retornado por `which zereight-mcp-gitlab`.
264
264
 
265
- Nรฃo quer instalar globalmente? Fixe o `npx` na versรฃo estรกvel anterior (a versรฃo recomendada por esta documentaรงรฃo), por exemplo `npx -y @zereight/mcp-gitlab@2.3.26`. Se quiser sempre a versรฃo mais recente, use `npx -y @zereight/mcp-gitlab@latest`. Para testar uma correรงรฃo jรก mesclada na `main` antes da prรณxima versรฃo estรกvel, use `npx -y @zereight/mcp-gitlab@next`, um build de prรฉ-lanรงamento que nรฃo รฉ indicado para produรงรฃo. O servidor exibe um aviso no stderr durante a inicializaรงรฃo quando existe uma versรฃo mais nova disponรญvel (desative com `GITLAB_DISABLE_VERSION_CHECK=true`).
265
+ Nรฃo quer instalar globalmente? Fixe o `npx` na versรฃo estรกvel anterior (a versรฃo recomendada por esta documentaรงรฃo), por exemplo `npx -y @zereight/mcp-gitlab@2.3.27`. Se quiser sempre a versรฃo mais recente, use `npx -y @zereight/mcp-gitlab@latest`. Para testar uma correรงรฃo jรก mesclada na `main` antes da prรณxima versรฃo estรกvel, use `npx -y @zereight/mcp-gitlab@next`, um build de prรฉ-lanรงamento que nรฃo รฉ indicado para produรงรฃo. O servidor exibe um aviso no stderr durante a inicializaรงรฃo quando existe uma versรฃo mais nova disponรญvel (desative com `GITLAB_DISABLE_VERSION_CHECK=true`).
266
266
 
267
267
  #### Instalaรงรฃo com um clique no Claude Desktop (MCP Bundle)
268
268
 
package/README.zh-CN.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 ไธชๅทฅๅ…ท**๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰ใ€‚ๆ€ปๅ…ฑ 288 ไธช๏ผˆtoolset ไธญ 285 ไธช + `execute_graphql` + `discover_tools` + `help`๏ผ‰ใ€‚ๅ…ˆ็”จ็ฒพ็ฎ€้›†๏ผŒๅ†ๅœจๆœฌไผš่ฏไธญ็”จ `discover_tools` ๆ‰ฉๅฑ•ใ€‚
17
+ **้ป˜่ฎคๆšด้œฒ 40 ไธชๅทฅๅ…ท**๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰ใ€‚ๆ€ปๅ…ฑ 290 ไธช๏ผˆtoolset ไธญ 287 ไธช + `execute_graphql` + `discover_tools` + `help`๏ผ‰ใ€‚ๅ…ˆ็”จ็ฒพ็ฎ€้›†๏ผŒๅ†ๅœจๆœฌไผš่ฏไธญ็”จ `discover_tools` ๆ‰ฉๅฑ•ใ€‚
18
18
 
19
19
  > **Token ้ข„็ฎ—๏ผš** MCP ๅฎขๆˆท็ซฏไผšๅœจไผš่ฏๅผ€ๅง‹ๆ—ถๆŠŠๆ•ดไปฝ `tools/list` ๅ‘็ป™ๆจกๅž‹ใ€‚่ฏทไฟๆŒ้ป˜่ฎค๏ผˆ็บฆ 40 ไธชๅทฅๅ…ท๏ผŒ็บฆ 12k schema token๏ผ‰ใ€‚็”จ `discover_tools` ไธบๆœฌไผš่ฏๆฟ€ๆดป็ฑปๅˆซ๏ผˆไป…้™ๆœฌไผš่ฏ๏ผ›`OAUTH_STATELESS_MODE=true` ๆ—ถ่ฏทๆ”น็”จๅ‘ฝๅ็š„ `GITLAB_TOOLSETS`๏ผ‰๏ผŒๆˆ–่ตฐ [Skill + CLI](./docs/getting-started/cli-without-mcp.md) ไปฅ่ทณ่ฟ‡ MCP schemaใ€‚**ไธ่ฆ่ฎพ็ฝฎ `GITLAB_TOOLSETS=all`** โ€” ๅฎƒไผšๅŠ ่ฝฝๅ‡ ไนŽๅ…จ้ƒจๅทฅๅ…ท๏ผŒschema ็บฆ 73k tokenใ€‚่ง [tools/list ไฝ“็งฏ](#toolslist-ไฝ“็งฏ2026-11-14-ๅฎžๆต‹) ๅ’Œ [ๅฏนๆฏ”](./docs/comparison/index.md)ใ€‚
20
20
 
@@ -148,7 +148,7 @@ GitLab ๅˆๅนถ่ฏทๆฑ‚ใ€่ฎฎ้ข˜ๅ’Œๆตๆฐด็บฟ่ตฐๆญค MCP๏ผˆ@zereight/mcp-gitlab๏ผ‰ใ€‚
148
148
 
149
149
  ### ไธบไป€ไนˆไฝฟ็”จ่ฟ™ไธช GitLab MCP๏ผŸ
150
150
 
151
- - **้ป˜่ฎค 40 ไธชๅทฅๅ…ท๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰๏ผ›ๅ…ฑ 288 ไธช** โ€” ๅ…ˆ็ฒพ็ฎ€๏ผŒๅ†็”จ `discover_tools` ๅœจๆœฌไผš่ฏๆ‰ฉๅฑ•ใ€‚`GITLAB_TOOLSETS=all` ็บฆ 73k schema token๏ผ›ๆŒ‰้œ€ๅ‘็Žฐๆˆ–ไฝฟ็”จ Skill + CLI
151
+ - **้ป˜่ฎค 40 ไธชๅทฅๅ…ท๏ผˆ38 ไธช `core` + `discover_tools` + `help`๏ผ‰๏ผ›ๅ…ฑ 290 ไธช** โ€” ๅ…ˆ็ฒพ็ฎ€๏ผŒๅ†็”จ `discover_tools` ๅœจๆœฌไผš่ฏๆ‰ฉๅฑ•ใ€‚`GITLAB_TOOLSETS=all` ็บฆ 73k schema token๏ผ›ๆŒ‰้œ€ๅ‘็Žฐๆˆ–ไฝฟ็”จ Skill + CLI
152
152
  - **MR ไธคๆญฅๅฎกๆŸฅ** โ€” `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 @@ GitLab ๅˆๅนถ่ฏทๆฑ‚ใ€่ฎฎ้ข˜ๅ’Œๆตๆฐด็บฟ่ตฐๆญค MCP๏ผˆ@zereight/mcp-gitlab๏ผ‰ใ€‚
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 ๅฎกๆŸฅ** | ไธคๆญฅๆ‰น้‡ diff | ๅ› ๆœๅŠกๅ™จ่€Œๅผ‚ | `get_merge_request` ๅธฆ diffs |
167
167
  | **Node.js** | >=20.0.0 | ้€šๅธธ >=24 | stdio ็ป `mcp-remote`๏ผŒ้œ€่ฆ Node.js 20+ |
168
168
  | **่ฎธๅฏ่ฏ** | MIT | ๅ› ๆœๅŠกๅ™จ่€Œๅผ‚ | GitLab ็š„ไธ€้ƒจๅˆ† |
@@ -262,7 +262,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
262
262
 
263
263
  ็คบไพ‹ไฝฟ็”จ `zereight-mcp-gitlab`๏ผŒ่ฟ™ๆ˜ฏๆฏ”ๆ—ง็š„ `mcp-gitlab` ๆ›ดไธๅฎนๆ˜“ๅ†ฒ็ช็š„ๅˆซๅใ€‚ๅฆ‚ๆžœ MCP ๅฎขๆˆท็ซฏๆ‰พไธๅˆฐๅฎƒ๏ผŒ่ฏทไฝฟ็”จ `which zereight-mcp-gitlab` ่พ“ๅ‡บ็š„็ปๅฏน่ทฏๅพ„ใ€‚
264
264
 
265
- ๅฆ‚ๆžœไธๆƒณๅ…จๅฑ€ๅฎ‰่ฃ…๏ผŒ่ฏทๅฐ† `npx` ๅ›บๅฎšๅˆฐไธŠไธ€ไธช็จณๅฎš็‰ˆๆœฌ๏ผˆๅณๆ–‡ๆกฃๆŽจ่็š„็‰ˆๆœฌ๏ผ‰๏ผŒไพ‹ๅฆ‚ `npx -y @zereight/mcp-gitlab@2.3.26`ใ€‚ๅฆ‚ๆžœๅง‹็ปˆๆƒณไฝฟ็”จๆœ€ๆ–ฐ็‰ˆๆœฌ๏ผŒ่ฏทๆ”น็”จ `npx -y @zereight/mcp-gitlab@latest`ใ€‚ๅฆ‚้œ€ๅœจไธ‹ไธ€ไธช็จณๅฎš็‰ˆๆœฌๅ‘ๅธƒๅ‰่ฏ•็”จๅทฒๅˆๅนถๅˆฐ `main` ็š„ไฟฎๅค๏ผŒ่ฏทไฝฟ็”จ `npx -y @zereight/mcp-gitlab@next`๏ผˆ้ข„ๅ‘ๅธƒ็‰ˆๆœฌ๏ผŒไธ้€‚็”จไบŽ็”Ÿไบง็Žฏๅขƒ๏ผ‰ใ€‚ๆœ‰ๆ–ฐ็‰ˆๆœฌๅ‘ๅธƒๆ—ถ๏ผŒๆœๅŠกๅ™จไผšๅœจๅฏๅŠจๆ—ถ้€š่ฟ‡ stderr ๆ็คบ๏ผˆๅฏ็”จ `GITLAB_DISABLE_VERSION_CHECK=true` ๅ…ณ้—ญ๏ผ‰ใ€‚
265
+ ๅฆ‚ๆžœไธๆƒณๅ…จๅฑ€ๅฎ‰่ฃ…๏ผŒ่ฏทๅฐ† `npx` ๅ›บๅฎšๅˆฐไธŠไธ€ไธช็จณๅฎš็‰ˆๆœฌ๏ผˆๅณๆ–‡ๆกฃๆŽจ่็š„็‰ˆๆœฌ๏ผ‰๏ผŒไพ‹ๅฆ‚ `npx -y @zereight/mcp-gitlab@2.3.27`ใ€‚ๅฆ‚ๆžœๅง‹็ปˆๆƒณไฝฟ็”จๆœ€ๆ–ฐ็‰ˆๆœฌ๏ผŒ่ฏทๆ”น็”จ `npx -y @zereight/mcp-gitlab@latest`ใ€‚ๅฆ‚้œ€ๅœจไธ‹ไธ€ไธช็จณๅฎš็‰ˆๆœฌๅ‘ๅธƒๅ‰่ฏ•็”จๅทฒๅˆๅนถๅˆฐ `main` ็š„ไฟฎๅค๏ผŒ่ฏทไฝฟ็”จ `npx -y @zereight/mcp-gitlab@next`๏ผˆ้ข„ๅ‘ๅธƒ็‰ˆๆœฌ๏ผŒไธ้€‚็”จไบŽ็”Ÿไบง็Žฏๅขƒ๏ผ‰ใ€‚ๆœ‰ๆ–ฐ็‰ˆๆœฌๅ‘ๅธƒๆ—ถ๏ผŒๆœๅŠกๅ™จไผšๅœจๅฏๅŠจๆ—ถ้€š่ฟ‡ stderr ๆ็คบ๏ผˆๅฏ็”จ `GITLAB_DISABLE_VERSION_CHECK=true` ๅ…ณ้—ญ๏ผ‰ใ€‚
266
266
 
267
267
  #### Claude Desktop ไธ€้”ฎๅฎ‰่ฃ…๏ผˆMCP Bundle๏ผ‰
268
268
 
package/build/index.js CHANGED
@@ -147,7 +147,7 @@ import { BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobS
147
147
  GitLabDiscussionNoteSchema, // Added
148
148
  GitLabDiscussionSchema,
149
149
  // Draft Notes Schemas
150
- GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, 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, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, GroupIterationCadence, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupProjectsSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListMergeRequestDiffsSchema, // Added
150
+ GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabResourceLabelEventSchema, GitLabResourceStateEventSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, 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, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, GroupIterationCadence, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupProjectsSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssueLabelEventsSchema, ListIssueStateEventsSchema, ListIssuesSchema, ListTodosSchema, ListMergeRequestDiffsSchema, // Added
151
151
  GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListProjectRunnersSchema, GetRunnerSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListProjectMembersSchema, ListGroupMembersSchema, ListProjectsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, ReorderIssueSchema, UpdateProjectSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, 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";
152
152
  import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
153
153
  import { createGraphQLAuditFailure, createToolCallAuditor, graphqlPayloadHasErrors, markToolResultAsAuditFailure, readKnownGitLabUserId, readKnownGitLabUsername, } from "./utils/audit-log.js";
@@ -3337,6 +3337,63 @@ async function listIssueLinks(projectId, issueIid) {
3337
3337
  const data = await response.json();
3338
3338
  return z.array(GitLabIssueWithLinkDetailsSchema).parse(data);
3339
3339
  }
3340
+ /** Reduce an event's author to `{ username }`; null for ghost or system events. */
3341
+ function toLeanEventUser(user) {
3342
+ return user ? { username: user.username } : null;
3343
+ }
3344
+ /** Map a GitLab resource label event to the lean shape; label is null when it was deleted. */
3345
+ function toLeanLabelEvent(event) {
3346
+ return {
3347
+ created_at: event.created_at,
3348
+ user: toLeanEventUser(event.user),
3349
+ action: event.action,
3350
+ label: event.label ? { name: event.label.name } : null,
3351
+ };
3352
+ }
3353
+ /** Map a GitLab resource state event to the lean shape. */
3354
+ function toLeanStateEvent(event) {
3355
+ return {
3356
+ created_at: event.created_at,
3357
+ user: toLeanEventUser(event.user),
3358
+ state: event.state,
3359
+ };
3360
+ }
3361
+ /**
3362
+ * Fetch one page of an issue's resource events (label or state) from GitLab.
3363
+ * Returns the raw JSON; callers parse and map it.
3364
+ */
3365
+ async function fetchIssueResourceEvents(projectId, issueIid, resource, options) {
3366
+ projectId = decodeURIComponent(projectId);
3367
+ const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeGitLabPathSegment(getEffectiveProjectId(projectId))}/issues/${encodeGitLabPathSegment(issueIid)}/${resource}`);
3368
+ appendFilterParams(url.searchParams, options);
3369
+ const response = await fetch(url.toString(), {
3370
+ ...getFetchConfig(),
3371
+ });
3372
+ await handleGitLabError(response);
3373
+ return response.json();
3374
+ }
3375
+ /**
3376
+ * List the label events of an issue (who added or removed which label, when)
3377
+ *
3378
+ * @param {string} projectId - The ID or URL-encoded path of the project
3379
+ * @param {number} issueIid - The internal ID of the project issue
3380
+ * @returns Lean label events in GitLab's order
3381
+ */
3382
+ async function listIssueLabelEvents(projectId, issueIid, options = {}) {
3383
+ const data = await fetchIssueResourceEvents(projectId, issueIid, "resource_label_events", options);
3384
+ return z.array(GitLabResourceLabelEventSchema).parse(data).map(toLeanLabelEvent);
3385
+ }
3386
+ /**
3387
+ * List the state events of an issue (who closed or reopened it, when)
3388
+ *
3389
+ * @param {string} projectId - The ID or URL-encoded path of the project
3390
+ * @param {number} issueIid - The internal ID of the project issue
3391
+ * @returns Lean state events in GitLab's order
3392
+ */
3393
+ async function listIssueStateEvents(projectId, issueIid, options = {}) {
3394
+ const data = await fetchIssueResourceEvents(projectId, issueIid, "resource_state_events", options);
3395
+ return z.array(GitLabResourceStateEventSchema).parse(data).map(toLeanStateEvent);
3396
+ }
3340
3397
  /**
3341
3398
  * Get a specific issue link
3342
3399
  * ํŠน์ • ์ด์Šˆ ๊ด€๊ณ„ ์กฐํšŒ
@@ -8874,6 +8931,20 @@ async function handleToolCall(params) {
8874
8931
  content: [{ type: "text", text: JSON.stringify(links) }],
8875
8932
  };
8876
8933
  }
8934
+ case "list_issue_label_events": {
8935
+ const { project_id, issue_iid, ...options } = ListIssueLabelEventsSchema.parse(params.arguments);
8936
+ const events = await listIssueLabelEvents(project_id, issue_iid, options);
8937
+ return {
8938
+ content: [{ type: "text", text: JSON.stringify(events) }],
8939
+ };
8940
+ }
8941
+ case "list_issue_state_events": {
8942
+ const { project_id, issue_iid, ...options } = ListIssueStateEventsSchema.parse(params.arguments);
8943
+ const events = await listIssueStateEvents(project_id, issue_iid, options);
8944
+ return {
8945
+ content: [{ type: "text", text: JSON.stringify(events) }],
8946
+ };
8947
+ }
8877
8948
  case "list_issue_discussions": {
8878
8949
  const args = ListIssueDiscussionsSchema.parse(params.arguments);
8879
8950
  const { project_id, issue_iid, ...options } = args;
package/build/schemas.js CHANGED
@@ -4661,6 +4661,25 @@ export const ListWorkItemNoteEmojiReactionsSchema = z.object({
4661
4661
  .string()
4662
4662
  .describe("The GraphQL GID of the note (e.g. 'gid://gitlab/Note/123' from list_work_item_notes)"),
4663
4663
  });
4664
+ // --- Resource event schemas (issue label and state history) ---
4665
+ // See https://docs.gitlab.com/api/resource_label_events/ and https://docs.gitlab.com/api/resource_state_events/
4666
+ export const ListIssueLabelEventsSchema = ProjectParamsSchema.extend({
4667
+ issue_iid: z.coerce.string().describe("The IID of an issue"),
4668
+ }).merge(PaginationOptionsSchema);
4669
+ export const ListIssueStateEventsSchema = ListIssueLabelEventsSchema;
4670
+ const GitLabResourceEventUserSchema = z.object({ username: z.string() }).nullable().optional();
4671
+ export const GitLabResourceLabelEventSchema = z.object({
4672
+ created_at: z.string(),
4673
+ action: z.string(), // "add" or "remove"
4674
+ user: GitLabResourceEventUserSchema,
4675
+ // GitLab returns null for a label that was deleted since the event.
4676
+ label: z.object({ name: z.string() }).nullable().optional(),
4677
+ });
4678
+ export const GitLabResourceStateEventSchema = z.object({
4679
+ created_at: z.string(),
4680
+ state: z.string(),
4681
+ user: GitLabResourceEventUserSchema,
4682
+ });
4664
4683
  // --- Incident Timeline Event schemas ---
4665
4684
  export const GetTimelineEventsSchema = z.object({
4666
4685
  project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
@@ -51,6 +51,7 @@ const GUIDES = {
51
51
  "Write: create_issue, update_issue, create_issue_note, list_issue_discussions.",
52
52
  "Small description edits: update_issue_description_patch instead of resending the full body.",
53
53
  "Board order: reorder_issue (move_after_id / move_before_id are global issue ids, not iids).",
54
+ "History: list_issue_label_events, list_issue_state_events (label-based board column flow).",
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 { lazyJSONSchema, withLazyInputSchemas } 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, 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";
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, ListIssueLabelEventsSchema, ListIssueStateEventsSchema, 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;
@@ -414,6 +414,16 @@ export const allTools = withLazyInputSchemas([
414
414
  description: "List discussions for an issue",
415
415
  inputSchema: lazyJSONSchema(ListIssueDiscussionsSchema),
416
416
  },
417
+ {
418
+ name: "list_issue_label_events",
419
+ description: "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.",
420
+ inputSchema: lazyJSONSchema(ListIssueLabelEventsSchema),
421
+ },
422
+ {
423
+ name: "list_issue_state_events",
424
+ description: "List an issue's state history: who closed or reopened it, when. Lean events: created_at, user.username, state. Paginated via page/per_page.",
425
+ inputSchema: lazyJSONSchema(ListIssueStateEventsSchema),
426
+ },
417
427
  {
418
428
  name: "get_issue_link",
419
429
  description: "Get a specific issue link",
@@ -1522,6 +1532,8 @@ export const readOnlyTools = new Set([
1522
1532
  "get_issue",
1523
1533
  "list_issue_links",
1524
1534
  "list_issue_discussions",
1535
+ "list_issue_label_events",
1536
+ "list_issue_state_events",
1525
1537
  "get_issue_link",
1526
1538
  "list_namespaces",
1527
1539
  "get_namespace",
@@ -1964,6 +1976,8 @@ export const TOOLSET_DEFINITIONS = [
1964
1976
  "update_issue_note",
1965
1977
  "list_issue_links",
1966
1978
  "list_issue_discussions",
1979
+ "list_issue_label_events",
1980
+ "list_issue_state_events",
1967
1981
  "get_issue_link",
1968
1982
  "create_issue_link",
1969
1983
  "delete_issue_link",
@@ -28,7 +28,7 @@ const SUMMARY_FIELDS = [
28
28
  ];
29
29
  /**
30
30
  * Extra fields a tool's summary keeps on top of SUMMARY_FIELDS: the access and
31
- * protection fields these tools exist to answer (#942).
31
+ * protection fields (#942) or the event fields these tools exist to answer.
32
32
  */
33
33
  const TOOL_SUMMARY_FIELDS = {
34
34
  list_branches: [
@@ -49,6 +49,8 @@ const TOOL_SUMMARY_FIELDS = {
49
49
  list_protected_tags: ["create_access_levels"],
50
50
  list_project_members: ["access_level", "expires_at"],
51
51
  list_group_members: ["access_level", "expires_at"],
52
+ list_issue_label_events: ["created_at", "user", "action", "label"],
53
+ list_issue_state_events: ["created_at", "user"],
52
54
  };
53
55
  /** Fields kept per note when a summarized item carries discussion `notes`. */
54
56
  const NOTE_SUMMARY_FIELDS = ["id", "body", "created_at", "resolved"];
@@ -70,11 +72,13 @@ const LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS = new Set([
70
72
  "list_group_iterations", // start_date, due_date
71
73
  "list_project_iterations", // start_date, due_date
72
74
  "list_group_iteration_cadences", // start_date, duration_in_weeks, iterations_in_advance
73
- // Small replies whose access fields are the point; summary: true keeps them (TOOL_SUMMARY_FIELDS).
75
+ // Small replies whose access or event fields are the point; summary: true keeps them (TOOL_SUMMARY_FIELDS).
74
76
  "list_protected_branches", // *_access_levels, allow_force_push
75
77
  "list_protected_tags", // create_access_levels
76
78
  "list_project_members", // access_level, expires_at
77
79
  "list_group_members", // access_level, expires_at
80
+ "list_issue_label_events", // created_at, user, action, label
81
+ "list_issue_state_events", // created_at, user, state
78
82
  // The reply is an envelope summarizeListPayload does not read.
79
83
  "list_project_vulnerabilities", // { vulnerabilities, pageInfo }
80
84
  "list_dependency_proxy_blobs", // { blobs, pageInfo }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zereight/mcp-gitlab",
3
- "version": "2.3.28-next.245",
3
+ "version": "2.3.29-next.248",
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": [
@@ -57,7 +57,7 @@
57
57
  "coverage:summary": "tsx scripts/code-coverage-summary.ts",
58
58
  "test:stateless": "npm run build && node --import tsx/esm --test --experimental-test-isolation=none test/stateless/codec.test.ts test/stateless/client-id.test.ts test/stateless/callback-proxy.test.ts test/stateless/session-id.test.ts test/stateless/session-id-integration.test.ts test/stateless/config-ttl.test.ts test/stateless/consumed-proxy-code-cache.test.ts",
59
59
  "test:mcp-oauth": "npm run build && node --import tsx/esm --test test/mcp-oauth-tests.ts",
60
- "test:live": "node test/validate-api.js",
60
+ "test:live": "node test/validate-api.js && node --import tsx/esm --test test/live/issue-resource-events.test.ts",
61
61
  "test:consumer-smoke": "bash scripts/consumer-install-smoke.sh",
62
62
  "test:remote-auth": "npm run build && node --import tsx/esm --test --experimental-test-isolation=none test/remote-auth-simple-test.ts",
63
63
  "test:schema": "tsx test/schema-tests.ts && tsx test/test-json-schema.ts && node --import tsx/esm --test --experimental-test-isolation=none --test-concurrency=1 test/*-schema.test.ts",