@zereight/mcp-gitlab 2.3.15-next.179 → 2.3.15

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
@@ -252,7 +252,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
252
252
 
253
253
  예시는 기존 `mcp-gitlab`보다 충돌 가능성이 낮은 `zereight-mcp-gitlab` 별칭을 사용합니다. MCP 클라이언트가 찾지 못하면 `which zereight-mcp-gitlab`의 절대 경로를 사용하세요.
254
254
 
255
- 전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.3.13`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. `main`에 머지된 수정을 다음 안정 버전 전에 확인하려면 프리릴리스 빌드인 `npx -y @zereight/mcp-gitlab@next`를 사용하세요(운영 환경용이 아닙니다). 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
255
+ 전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.3.14`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. `main`에 머지된 수정을 다음 안정 버전 전에 확인하려면 프리릴리스 빌드인 `npx -y @zereight/mcp-gitlab@next`를 사용하세요(운영 환경용이 아닙니다). 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
256
256
 
257
257
  #### Claude Desktop 원클릭 설치(MCP Bundle)
258
258
 
package/README.md CHANGED
@@ -258,7 +258,7 @@ The store path is pinned by your lock file; update it with `nix flake update git
258
258
 
259
259
  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`.
260
260
 
261
- No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.13`. 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`).
261
+ No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.14`. 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`).
262
262
 
263
263
  #### Claude Desktop one-click install (MCP Bundle)
264
264
 
package/README.pt-BR.md CHANGED
@@ -252,7 +252,7 @@ O caminho no store é fixado pelo seu lock file; atualize-o com `nix flake updat
252
252
 
253
253
  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`.
254
254
 
255
- 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.13`. 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`).
255
+ 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.14`. 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`).
256
256
 
257
257
  #### Instalação com um clique no Claude Desktop (MCP Bundle)
258
258
 
package/README.zh-CN.md CHANGED
@@ -252,7 +252,7 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
252
252
 
253
253
  示例使用 `zereight-mcp-gitlab`,这是比旧的 `mcp-gitlab` 更不容易冲突的别名。如果 MCP 客户端找不到它,请使用 `which zereight-mcp-gitlab` 输出的绝对路径。
254
254
 
255
- 如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.3.13`。如果始终想使用最新版本,请改用 `npx -y @zereight/mcp-gitlab@latest`。如需在下一个稳定版本发布前试用已合并到 `main` 的修复,请使用 `npx -y @zereight/mcp-gitlab@next`(预发布版本,不适用于生产环境)。有新版本发布时,服务器会在启动时通过 stderr 提示(可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭)。
255
+ 如果不想全局安装,请将 `npx` 固定到上一个稳定版本(即文档推荐的版本),例如 `npx -y @zereight/mcp-gitlab@2.3.14`。如果始终想使用最新版本,请改用 `npx -y @zereight/mcp-gitlab@latest`。如需在下一个稳定版本发布前试用已合并到 `main` 的修复,请使用 `npx -y @zereight/mcp-gitlab@next`(预发布版本,不适用于生产环境)。有新版本发布时,服务器会在启动时通过 stderr 提示(可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭)。
256
256
 
257
257
  #### Claude Desktop 一键安装(MCP Bundle)
258
258
 
package/build/index.js CHANGED
@@ -143,7 +143,7 @@ CreateMergeRequestNoteSchema, CreateMergeRequestDiscussionNoteSchema, CreateMerg
143
143
  GitLabDiscussionNoteSchema, // Added
144
144
  GitLabDiscussionSchema,
145
145
  // Draft Notes Schemas
146
- GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabProtectedTagSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabMilestonesSchema, GitLabGroupMilestonesSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineScheduleSchema, GitLabPipelineScheduleVariableSchema, GitLabPipelineSchedulePlayResultSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GitLabWikiPageSchema, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, ListGroupProjectsSchema, GitLabCiVariableSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListLabelsSchema, ListMergeRequestDiffsSchema, // Added
146
+ GitLabDraftNoteSchema, GitLabForkSchema, GitLabBranchSchema, GitLabProtectedBranchSchema, GitLabProtectedTagSchema, GitLabGroupSchema, GitLabIssueLinkSchema, GitLabIssueSchema, GitLabIssueWithLinkDetailsSchema, GitLabMarkdownUploadSchema, GitLabMergeRequestPipelineSchema, GitLabMergeRequestSchema, GitLabMilestonesSchema, GitLabGroupMilestonesSchema, GitLabNamespaceExistsResponseSchema, GitLabNamespaceSchema, GitLabPipelineJobSchema, GitLabDeploymentSchema, GitLabEnvironmentSchema, GitLabPipelineSchema, GitLabPipelineScheduleSchema, GitLabPipelineScheduleVariableSchema, GitLabPipelineSchedulePlayResultSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, GitLabPipelineTriggerJobSchema, GitLabProjectMemberSchema, GitLabProjectSchema, GitLabTodoSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabSearchBlobResultSchema, GitLabSearchResponseSchema, GitLabTreeItemSchema, GitLabUserSchema, GitLabUsersResponseSchema, GitLabWikiPageSchema, GroupIteration, ListCommitStatusesSchema, ListBranchesSchema, ListCommitsSchema, ListDraftNotesSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, GroupIterationCadence, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupProjectsSchema, GitLabCiVariableSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListTodosSchema, ListLabelsSchema, ListMergeRequestDiffsSchema, // Added
147
147
  GetMergeRequestFileDiffSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListMergeRequestVersionsSchema, GetMergeRequestVersionSchema, GitLabMergeRequestVersionSchema, GitLabMergeRequestVersionDetailSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelinesSchema, ListDeploymentsSchema, ListEnvironmentsSchema, ListProjectRunnersSchema, GetRunnerSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListProjectMembersSchema, ListGroupMembersSchema, ListProjectMilestonesSchema, ListGroupMilestonesSchema, ListProjectsSchema, ListWikiPagesSchema, GetGroupWikiPageSchema, ListGroupWikiPagesSchema, UpdateGroupWikiPageSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, DownloadAttachmentSchema, DownloadJobArtifactsSchema, GetJobArtifactFileSchema, GitLabArtifactEntrySchema, ListJobArtifactsSchema, MergeMergeRequestSchema, ApproveMergeRequestSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GitLabMergeRequestApprovalStateSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, MarkAllTodosDoneSchema, MarkTodoDoneSchema, PaginatedDiscussionsResponseSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PlayPipelineJobSchema, PushFilesSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, UpdateDraftNoteSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestSchema, UpdateWikiPageSchema, VerifyNamespaceSchema, GitLabEventSchema, ListEventsSchema, GetProjectEventsSchema, ExecuteGraphQLSchema, GitLabReleaseSchema, ListReleasesSchema, GetReleaseSchema, CreateReleaseSchema, UpdateReleaseSchema, DeleteReleaseSchema, CreateReleaseEvidenceSchema, DownloadReleaseAssetSchema, ListTagsSchema, GetTagSchema, CreateTagSchema, DeleteTagSchema, GetTagSignatureSchema, ListProtectedTagsSchema, GetProtectedTagSchema, ProtectTagSchema, UnprotectTagSchema, GitLabTagSchema, GitLabTagSignatureSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, GitLabSnippetSchema, GetMergeRequestNotesSchema, GetMergeRequestNoteSchema, GetMergeRequestDiscussionSchema, DeleteMergeRequestDiscussionNoteSchema, ResolveMergeRequestThreadSchema, GetWorkItemSchema, ListWorkItemsSchema, CreateWorkItemSchema, UpdateWorkItemSchema, ConvertWorkItemTypeSchema, ListWorkItemStatusesSchema, ListWorkItemNotesSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, MoveWorkItemSchema, ListCustomFieldDefinitionsSchema, GetTimelineEventsSchema, CreateTimelineEventSchema, ListWebhooksSchema, CreateWebhookSchema, UpdateWebhookSchema, DeleteWebhookSchema, ListWebhookEventsSchema, GetWebhookEventSchema, HealthCheckSchema, } from "./schemas.js";
148
148
  import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
149
149
  import { createLogger, flushBufferedLogs, flushStartupLogs } from "./utils/logger.js";
@@ -7014,6 +7014,18 @@ async function listGroupMembers(groupId, options = {}) {
7014
7014
  async function listGroupIterations(groupId, options = {}) {
7015
7015
  groupId = decodeURIComponent(groupId);
7016
7016
  const url = new URL(`${getEffectiveApiUrl()}/groups/${encodeGitLabPathSegment(groupId)}/iterations`);
7017
+ return fetchIterations(url, options);
7018
+ }
7019
+ /**
7020
+ * list project iterations (REST GET /projects/:id/iterations): the project's group
7021
+ * iterations, with the same filters as the group endpoint.
7022
+ */
7023
+ async function listProjectIterations(projectId, options = {}) {
7024
+ projectId = decodeURIComponent(projectId);
7025
+ const url = new URL(`${getEffectiveApiUrl()}/projects/${encodeGitLabPathSegment(getEffectiveProjectId(projectId))}/iterations`);
7026
+ return fetchIterations(url, options);
7027
+ }
7028
+ async function fetchIterations(url, options) {
7017
7029
  // クエリパラメータの追加
7018
7030
  if (options.state)
7019
7031
  url.searchParams.append("state", options.state);
@@ -7078,7 +7090,8 @@ async function getGroupIteration(groupId, iterationId) {
7078
7090
  iidMatch = iteration;
7079
7091
  }
7080
7092
  }
7081
- if (iterations.length < 100)
7093
+ // A GID matches only the primary id, so later pages cannot change the result.
7094
+ if (iterations.length < 100 || (isGraphqlGid && idMatch))
7082
7095
  break;
7083
7096
  }
7084
7097
  if (isGraphqlGid) {
@@ -7096,10 +7109,8 @@ async function updateGroupIteration(groupId, iterationId, options) {
7096
7109
  throw new ToolInputError("Provide at least one iteration field to update");
7097
7110
  }
7098
7111
  const current = await getGroupIteration(groupId, iterationId);
7099
- const groupReference = /^group:/i.test(groupId) ? groupId : `group:${groupId}`;
7100
- const { path: groupPath } = await resolveProjectOrGroupPath(groupReference);
7101
7112
  const input = {
7102
- groupPath,
7113
+ groupPath: await resolveGroupPath(groupId),
7103
7114
  id: `${ITERATION_GID_PREFIX}${current.id}`,
7104
7115
  };
7105
7116
  if (options.title !== undefined)
@@ -7128,6 +7139,227 @@ async function updateGroupIteration(groupId, iterationId, options) {
7128
7139
  }
7129
7140
  return getGroupIteration(groupId, `${ITERATION_GID_PREFIX}${current.id}`);
7130
7141
  }
7142
+ const ITERATION_CADENCE_GID_PREFIX = "gid://gitlab/Iterations::Cadence/";
7143
+ function normalizeIterationCadenceId(cadenceId) {
7144
+ const decoded = decodeURIComponent(cadenceId);
7145
+ return decoded.startsWith("gid://") ? decoded : `${ITERATION_CADENCE_GID_PREFIX}${decoded}`;
7146
+ }
7147
+ async function resolveGroupPath(groupId) {
7148
+ const groupReference = /^group:/i.test(groupId) ? groupId : `group:${groupId}`;
7149
+ const { path } = await resolveProjectOrGroupPath(groupReference);
7150
+ return path;
7151
+ }
7152
+ /**
7153
+ * Create a group iteration with GraphQL iterationCreate. Fields map one-to-one onto the
7154
+ * mutation input; GitLab validates them (for example, which cadence the iteration needs).
7155
+ */
7156
+ async function createGroupIteration(groupId, options) {
7157
+ const input = { groupPath: await resolveGroupPath(groupId) };
7158
+ if (options.title !== undefined)
7159
+ input.title = options.title;
7160
+ if (options.description !== undefined)
7161
+ input.description = options.description;
7162
+ if (options.start_date !== undefined)
7163
+ input.startDate = options.start_date;
7164
+ if (options.due_date !== undefined)
7165
+ input.dueDate = options.due_date;
7166
+ if (options.iterations_cadence_id !== undefined) {
7167
+ input.iterationsCadenceId = normalizeIterationCadenceId(options.iterations_cadence_id);
7168
+ }
7169
+ const mutation = `
7170
+ mutation CreateGroupIteration($input: iterationCreateInput!) {
7171
+ iterationCreate(input: $input) {
7172
+ iteration { id }
7173
+ errors
7174
+ }
7175
+ }
7176
+ `;
7177
+ const data = await executeGraphQL(mutation, { input });
7178
+ const result = data.iterationCreate;
7179
+ if (result.errors.length > 0) {
7180
+ throw new Error(`Failed to create group iteration: ${result.errors.join(", ")}`);
7181
+ }
7182
+ if (!result.iteration) {
7183
+ throw new Error("Failed to create group iteration: GitLab returned no iteration");
7184
+ }
7185
+ return getGroupIteration(groupId, result.iteration.id);
7186
+ }
7187
+ /** Delete a group iteration with GraphQL iterationDelete; it accepts an ID, IID, or GID. */
7188
+ async function deleteGroupIteration(groupId, iterationId) {
7189
+ const current = await getGroupIteration(groupId, iterationId);
7190
+ const mutation = `
7191
+ mutation DeleteGroupIteration($id: IterationID!) {
7192
+ iterationDelete(input: { id: $id }) {
7193
+ errors
7194
+ }
7195
+ }
7196
+ `;
7197
+ const data = await executeGraphQL(mutation, {
7198
+ id: `${ITERATION_GID_PREFIX}${current.id}`,
7199
+ });
7200
+ if (data.iterationDelete.errors.length > 0) {
7201
+ throw new Error(`Failed to delete group iteration: ${data.iterationDelete.errors.join(", ")}`);
7202
+ }
7203
+ }
7204
+ const ITERATION_CADENCE_FIELDS = `
7205
+ id title description automatic active startDate
7206
+ durationInWeeks iterationsInAdvance rollOver
7207
+ `;
7208
+ function toGroupIterationCadence(node) {
7209
+ return GroupIterationCadence.parse({
7210
+ id: node.id,
7211
+ title: node.title,
7212
+ description: node.description,
7213
+ automatic: node.automatic,
7214
+ active: node.active,
7215
+ start_date: node.startDate,
7216
+ duration_in_weeks: node.durationInWeeks,
7217
+ iterations_in_advance: node.iterationsInAdvance,
7218
+ roll_over: node.rollOver,
7219
+ });
7220
+ }
7221
+ /**
7222
+ * List a group's iteration cadences through GraphQL; GitLab has no REST endpoint for them.
7223
+ * Returned IDs are cadence GIDs, accepted as-is by the other iteration and cadence tools.
7224
+ */
7225
+ async function listGroupIterationCadences(groupId, options = {}) {
7226
+ const groupPath = await resolveGroupPath(groupId);
7227
+ const query = `
7228
+ query GroupIterationCadences(
7229
+ $fullPath: ID!
7230
+ $id: IterationsCadenceID
7231
+ $automatic: Boolean
7232
+ $active: Boolean
7233
+ $durationInWeeks: Int
7234
+ $title: String
7235
+ $includeAncestorGroups: Boolean
7236
+ $after: String
7237
+ ) {
7238
+ group(fullPath: $fullPath) {
7239
+ iterationCadences(
7240
+ id: $id
7241
+ automatic: $automatic
7242
+ active: $active
7243
+ durationInWeeks: $durationInWeeks
7244
+ title: $title
7245
+ includeAncestorGroups: $includeAncestorGroups
7246
+ first: 100
7247
+ after: $after
7248
+ ) {
7249
+ nodes { ${ITERATION_CADENCE_FIELDS} }
7250
+ pageInfo { hasNextPage endCursor }
7251
+ }
7252
+ }
7253
+ }
7254
+ `;
7255
+ const cadences = [];
7256
+ let after;
7257
+ do {
7258
+ const data = await executeGraphQL(query, {
7259
+ fullPath: groupPath,
7260
+ id: options.id !== undefined ? normalizeIterationCadenceId(options.id) : undefined,
7261
+ automatic: options.automatic,
7262
+ active: options.active,
7263
+ durationInWeeks: options.duration_in_weeks,
7264
+ title: options.title,
7265
+ includeAncestorGroups: options.include_ancestor_groups,
7266
+ after,
7267
+ });
7268
+ if (!data.group) {
7269
+ throw new Error(`Group ${groupPath} was not found`);
7270
+ }
7271
+ const { nodes, pageInfo } = data.group.iterationCadences;
7272
+ cadences.push(...nodes.map(toGroupIterationCadence));
7273
+ after = pageInfo.hasNextPage && pageInfo.endCursor ? pageInfo.endCursor : undefined;
7274
+ } while (after);
7275
+ return cadences;
7276
+ }
7277
+ /** Map the snake_case cadence fields onto the GraphQL cadence input, dropping unset ones. */
7278
+ function toIterationCadenceInput(options) {
7279
+ const input = {};
7280
+ if (options.title !== undefined)
7281
+ input.title = options.title;
7282
+ if (options.description !== undefined)
7283
+ input.description = options.description;
7284
+ if (options.automatic !== undefined)
7285
+ input.automatic = options.automatic;
7286
+ if (options.active !== undefined)
7287
+ input.active = options.active;
7288
+ if (options.duration_in_weeks !== undefined)
7289
+ input.durationInWeeks = options.duration_in_weeks;
7290
+ if (options.iterations_in_advance !== undefined) {
7291
+ input.iterationsInAdvance = options.iterations_in_advance;
7292
+ }
7293
+ if (options.start_date !== undefined)
7294
+ input.startDate = options.start_date;
7295
+ if (options.roll_over !== undefined)
7296
+ input.rollOver = options.roll_over;
7297
+ return input;
7298
+ }
7299
+ /** Create a group iteration cadence with GraphQL iterationCadenceCreate. */
7300
+ async function createGroupIterationCadence(groupId, options) {
7301
+ const input = {
7302
+ groupPath: await resolveGroupPath(groupId),
7303
+ ...toIterationCadenceInput(options),
7304
+ };
7305
+ const mutation = `
7306
+ mutation CreateGroupIterationCadence($input: IterationCadenceCreateInput!) {
7307
+ iterationCadenceCreate(input: $input) {
7308
+ iterationCadence { ${ITERATION_CADENCE_FIELDS} }
7309
+ errors
7310
+ }
7311
+ }
7312
+ `;
7313
+ const data = await executeGraphQL(mutation, { input });
7314
+ const result = data.iterationCadenceCreate;
7315
+ if (result.errors.length > 0) {
7316
+ throw new Error(`Failed to create iteration cadence: ${result.errors.join(", ")}`);
7317
+ }
7318
+ if (!result.iterationCadence) {
7319
+ throw new Error("Failed to create iteration cadence: GitLab returned no cadence");
7320
+ }
7321
+ return toGroupIterationCadence(result.iterationCadence);
7322
+ }
7323
+ /** Update an iteration cadence with GraphQL iterationCadenceUpdate. */
7324
+ async function updateGroupIterationCadence(cadenceId, options) {
7325
+ const fields = toIterationCadenceInput(options);
7326
+ if (Object.keys(fields).length === 0) {
7327
+ throw new ToolInputError("Provide at least one iteration cadence field to update");
7328
+ }
7329
+ const mutation = `
7330
+ mutation UpdateGroupIterationCadence($input: IterationCadenceUpdateInput!) {
7331
+ iterationCadenceUpdate(input: $input) {
7332
+ iterationCadence { ${ITERATION_CADENCE_FIELDS} }
7333
+ errors
7334
+ }
7335
+ }
7336
+ `;
7337
+ const data = await executeGraphQL(mutation, { input: { id: normalizeIterationCadenceId(cadenceId), ...fields } });
7338
+ const result = data.iterationCadenceUpdate;
7339
+ if (result.errors.length > 0) {
7340
+ throw new Error(`Failed to update iteration cadence: ${result.errors.join(", ")}`);
7341
+ }
7342
+ if (!result.iterationCadence) {
7343
+ throw new Error("Failed to update iteration cadence: GitLab returned no cadence");
7344
+ }
7345
+ return toGroupIterationCadence(result.iterationCadence);
7346
+ }
7347
+ /** Delete an iteration cadence with GraphQL iterationCadenceDestroy. */
7348
+ async function deleteGroupIterationCadence(cadenceId) {
7349
+ const mutation = `
7350
+ mutation DeleteGroupIterationCadence($id: IterationsCadenceID!) {
7351
+ iterationCadenceDestroy(input: { id: $id }) {
7352
+ errors
7353
+ }
7354
+ }
7355
+ `;
7356
+ const data = await executeGraphQL(mutation, {
7357
+ id: normalizeIterationCadenceId(cadenceId),
7358
+ });
7359
+ if (data.iterationCadenceDestroy.errors.length > 0) {
7360
+ throw new Error(`Failed to delete iteration cadence: ${data.iterationCadenceDestroy.errors.join(", ")}`);
7361
+ }
7362
+ }
7131
7363
  // --- CI/CD Variables ---
7132
7364
  async function listProjectVariables(projectId, options = {}) {
7133
7365
  projectId = decodeURIComponent(projectId);
@@ -10616,6 +10848,73 @@ async function handleToolCall(params) {
10616
10848
  content: [{ type: "text", text: JSON.stringify(iteration) }],
10617
10849
  };
10618
10850
  }
10851
+ case "create_group_iteration": {
10852
+ rejectIfStrictProjectScope("create_group_iteration");
10853
+ const args = CreateGroupIterationSchema.parse(params.arguments);
10854
+ const { group_id, ...options } = args;
10855
+ const iteration = await createGroupIteration(group_id, options);
10856
+ return {
10857
+ content: [{ type: "text", text: JSON.stringify(iteration) }],
10858
+ };
10859
+ }
10860
+ case "list_group_iteration_cadences": {
10861
+ rejectIfStrictProjectScope("list_group_iteration_cadences");
10862
+ const args = ListGroupIterationCadencesSchema.parse(params.arguments);
10863
+ const { group_id, ...options } = args;
10864
+ const cadences = await listGroupIterationCadences(group_id, options);
10865
+ return {
10866
+ content: [{ type: "text", text: JSON.stringify(cadences) }],
10867
+ };
10868
+ }
10869
+ case "delete_group_iteration": {
10870
+ rejectIfStrictProjectScope("delete_group_iteration");
10871
+ const { group_id, iteration_id } = DeleteGroupIterationSchema.parse(params.arguments);
10872
+ await deleteGroupIteration(group_id, iteration_id);
10873
+ return {
10874
+ content: [
10875
+ {
10876
+ type: "text",
10877
+ text: JSON.stringify({ status: "success", message: "Group iteration deleted successfully" }, null, 2),
10878
+ },
10879
+ ],
10880
+ };
10881
+ }
10882
+ case "list_project_iterations": {
10883
+ const { project_id, ...options } = ListProjectIterationsSchema.parse(params.arguments);
10884
+ const iterations = await listProjectIterations(project_id, options);
10885
+ return {
10886
+ content: [{ type: "text", text: JSON.stringify(iterations) }],
10887
+ };
10888
+ }
10889
+ case "create_group_iteration_cadence": {
10890
+ rejectIfStrictProjectScope("create_group_iteration_cadence");
10891
+ const { group_id, ...options } = CreateGroupIterationCadenceSchema.parse(params.arguments);
10892
+ const cadence = await createGroupIterationCadence(group_id, options);
10893
+ return {
10894
+ content: [{ type: "text", text: JSON.stringify(cadence) }],
10895
+ };
10896
+ }
10897
+ case "update_group_iteration_cadence": {
10898
+ rejectIfStrictProjectScope("update_group_iteration_cadence");
10899
+ const { iteration_cadence_id, ...options } = UpdateGroupIterationCadenceSchema.parse(params.arguments);
10900
+ const cadence = await updateGroupIterationCadence(iteration_cadence_id, options);
10901
+ return {
10902
+ content: [{ type: "text", text: JSON.stringify(cadence) }],
10903
+ };
10904
+ }
10905
+ case "delete_group_iteration_cadence": {
10906
+ rejectIfStrictProjectScope("delete_group_iteration_cadence");
10907
+ const { iteration_cadence_id } = DeleteGroupIterationCadenceSchema.parse(params.arguments);
10908
+ await deleteGroupIterationCadence(iteration_cadence_id);
10909
+ return {
10910
+ content: [
10911
+ {
10912
+ type: "text",
10913
+ text: JSON.stringify({ status: "success", message: "Iteration cadence deleted successfully" }, null, 2),
10914
+ },
10915
+ ],
10916
+ };
10917
+ }
10619
10918
  // --- CI/CD Variables ---
10620
10919
  case "list_project_variables": {
10621
10920
  const args = ListProjectVariablesSchema.parse(params.arguments);
package/build/schemas.js CHANGED
@@ -3614,6 +3614,10 @@ export const ListGroupIterationsSchema = z
3614
3614
  const requiredIterationIdentifier = (description) => z
3615
3615
  .preprocess(value => (typeof value === "number" ? String(value) : value), z.string().min(1))
3616
3616
  .describe(description);
3617
+ /** Same as {@link requiredIterationIdentifier}, for an optional identifier. */
3618
+ const optionalIterationIdentifier = (description) => z
3619
+ .preprocess(value => (typeof value === "number" ? String(value) : value), z.string().min(1).optional())
3620
+ .describe(description);
3617
3621
  export const GetGroupIterationSchema = z.object({
3618
3622
  group_id: requiredIterationIdentifier("Group ID or URL-encoded path"),
3619
3623
  iteration_id: requiredIterationIdentifier("Iteration ID, IID, or GraphQL GID"),
@@ -3630,6 +3634,84 @@ export const UpdateGroupIterationSchema = z.object({
3630
3634
  start_date: z.string().optional().describe("New start date in YYYY-MM-DD format"),
3631
3635
  due_date: z.string().optional().describe("New due date in YYYY-MM-DD format"),
3632
3636
  });
3637
+ export const CreateGroupIterationSchema = z.object({
3638
+ group_id: requiredIterationIdentifier("Group ID or URL-encoded path"),
3639
+ title: z.string().optional().describe("Iteration title"),
3640
+ description: z.string().optional().describe("Iteration description"),
3641
+ start_date: z.string().optional().describe("Start date in YYYY-MM-DD format"),
3642
+ due_date: z.string().optional().describe("Due date in YYYY-MM-DD format"),
3643
+ iterations_cadence_id: optionalIterationIdentifier("Iteration cadence ID or GraphQL GID (gid://gitlab/Iterations::Cadence/<id>) to assign the new iteration to. Use list_group_iteration_cadences to find it."),
3644
+ });
3645
+ export const DeleteGroupIterationSchema = z.object({
3646
+ group_id: requiredIterationIdentifier("Group ID or URL-encoded path"),
3647
+ iteration_id: requiredIterationIdentifier("Iteration ID, IID, or GraphQL GID"),
3648
+ });
3649
+ export const ListProjectIterationsSchema = ListGroupIterationsSchema.omit({
3650
+ group_id: true,
3651
+ }).extend({
3652
+ project_id: requiredIterationIdentifier("Project ID or URL-encoded path"),
3653
+ });
3654
+ export const GroupIterationCadence = z.object({
3655
+ id: z.string(),
3656
+ title: z.string(),
3657
+ description: z.string().optional().nullable(),
3658
+ automatic: z.boolean().optional().nullable(),
3659
+ active: z.boolean().optional().nullable(),
3660
+ start_date: z.string().optional().nullable(),
3661
+ duration_in_weeks: z.number().optional().nullable(),
3662
+ iterations_in_advance: z.number().optional().nullable(),
3663
+ roll_over: z.boolean().optional().nullable(),
3664
+ });
3665
+ export const ListGroupIterationCadencesSchema = z.object({
3666
+ group_id: requiredIterationIdentifier("Group ID or URL-encoded path"),
3667
+ id: optionalIterationIdentifier("Return only the cadence with this ID or GraphQL GID (gid://gitlab/Iterations::Cadence/<id>)."),
3668
+ automatic: flexibleBooleanOptional.describe("Return only cadences that do (true) or do not (false) generate upcoming iterations automatically."),
3669
+ active: flexibleBooleanOptional.describe("Return only active (true) or inactive (false) cadences."),
3670
+ duration_in_weeks: z.coerce
3671
+ .number()
3672
+ .int()
3673
+ .optional()
3674
+ .describe("Return only cadences whose iterations last this many weeks."),
3675
+ title: z.string().optional().describe("Fuzzy search by cadence title."),
3676
+ include_ancestor_groups: flexibleBooleanOptional.describe("Include cadences from the group's ancestor groups."),
3677
+ });
3678
+ const iterationCadenceFields = {
3679
+ title: z.string().optional().describe("Cadence title"),
3680
+ description: z
3681
+ .string()
3682
+ .optional()
3683
+ .describe("Cadence description. Maximum length is 5000 characters."),
3684
+ duration_in_weeks: z.coerce
3685
+ .number()
3686
+ .int()
3687
+ .optional()
3688
+ .describe("Duration in weeks of the iterations within the cadence"),
3689
+ iterations_in_advance: z.coerce
3690
+ .number()
3691
+ .int()
3692
+ .optional()
3693
+ .describe("Number of future iterations to schedule in addition to the current one"),
3694
+ start_date: z
3695
+ .string()
3696
+ .optional()
3697
+ .describe("Automation start date, as a date (YYYY-MM-DD) or ISO 8601 timestamp"),
3698
+ roll_over: flexibleBooleanOptional.describe("Whether unfinished issues roll over to the next iteration"),
3699
+ };
3700
+ export const CreateGroupIterationCadenceSchema = z.object({
3701
+ group_id: requiredIterationIdentifier("Group ID or URL-encoded path"),
3702
+ automatic: coerceBooleanString.describe("Whether the cadence generates upcoming iterations automatically"),
3703
+ active: coerceBooleanString.describe("Whether the cadence is active"),
3704
+ ...iterationCadenceFields,
3705
+ });
3706
+ export const UpdateGroupIterationCadenceSchema = z.object({
3707
+ iteration_cadence_id: requiredIterationIdentifier("Iteration cadence ID or GraphQL GID (gid://gitlab/Iterations::Cadence/<id>)"),
3708
+ automatic: flexibleBooleanOptional.describe("Whether the cadence generates upcoming iterations automatically"),
3709
+ active: flexibleBooleanOptional.describe("Whether the cadence is active"),
3710
+ ...iterationCadenceFields,
3711
+ });
3712
+ export const DeleteGroupIterationCadenceSchema = z.object({
3713
+ iteration_cadence_id: requiredIterationIdentifier("Iteration cadence ID or GraphQL GID (gid://gitlab/Iterations::Cadence/<id>)"),
3714
+ });
3633
3715
  // Events API schemas
3634
3716
  export const GitLabEventAuthorSchema = z.object({
3635
3717
  id: z.coerce.string(),
@@ -1,7 +1,7 @@
1
1
  import { toJSONSchema } from "../utils/schema.js";
2
2
  import { USE_GITLAB_WIKI, USE_MILESTONE, USE_PIPELINE, SSE, STREAMABLE_HTTP } from "../config.js";
3
3
  import { getToolDescription } from "./tool-descriptions.js";
4
- import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateGroupMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWebhookSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, GetProtectedBranchSchema, ListProtectedBranchesSchema, ProtectBranchSchema, UpdateProtectedBranchSchema, ProtectTagSchema, UnprotectBranchSchema, UnprotectTagSchema, UpdateDefaultBranchSchema, DeleteDraftNoteSchema, DeleteGroupMilestoneSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWebhookSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadAttachmentRemoteSchema, DownloadJobArtifactsSchema, DownloadJobArtifactsRemoteSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, EditGroupMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetFileBlameSchema, GetDeploymentSchema, CreateDeploymentSchema, UpdateDeploymentSchema, DeploymentApprovalSchema, ListDeploymentMergeRequestsSchema, GetDraftNoteSchema, GetEnvironmentSchema, UpdateEnvironmentSchema, StopEnvironmentSchema, StopStaleEnvironmentsSchema, DeleteReviewAppEnvironmentsSchema, PipelineTriggerIdSchema, ListPipelineTriggersSchema, CreatePipelineTriggerSchema, UpdatePipelineTriggerSchema, TriggerPipelineSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestDiscussionSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetGroupMilestoneSchema, GetGroupMilestoneIssuesSchema, GetGroupMilestoneMergeRequestsSchema, GetGroupMilestoneBurndownEventsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, PipelineJobControlSchema, GetPipelineSchema, GetRunnerSchema, GetPipelineVariablesSchema, UpdatePipelineMetadataSchema, DeletePipelineSchema, PipelineReportSchema, WaitForPipelineSchema, WaitForPipelineJobSchema, PlayPipelineJobsSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetProtectedTagSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, ListGroupMilestonesSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListPipelinesSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, ListGroupMembersSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListProjectRunnersSchema, ListReleasesSchema, ListTagsSchema, ListProtectedTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, UpdateLabelSchema, UpdateProjectSchema, UpdateMergeRequestDiscussionNoteSchema, UpdateMergeRequestNoteSchema, UpdateMergeRequestSchema, UpdateReleaseSchema, UpdateWebhookSchema, UpdateWikiPageSchema, UpdateWorkItemSchema, VerifyNamespaceSchema, ListProjectVariablesSchema, GetProjectVariableSchema, CreateProjectVariableSchema, UpdateProjectVariableSchema, DeleteProjectVariableSchema, ListGroupVariablesSchema, GetGroupVariableSchema, CreateGroupVariableSchema, UpdateGroupVariableSchema, DeleteGroupVariableSchema, GetDependencyProxySettingsSchema, UpdateDependencyProxySettingsSchema, ListDependencyProxyBlobsSchema, PurgeDependencyProxyCacheSchema, ListProjectVulnerabilitiesSchema, GetVulnerabilitySchema, DismissVulnerabilitySchema, ConfirmVulnerabilitySchema, } from "../schemas.js";
4
+ import { ApproveMergeRequestSchema, BulkPublishDraftNotesSchema, CancelPipelineJobSchema, ErasePipelineJobSchema, CancelPipelineSchema, ConvertWorkItemTypeSchema, CreateBranchSchema, CreateDraftNoteSchema, CreateGroupSchema, CreateGroupWikiPageSchema, CreateIssueLinkSchema, CreateIssueNoteSchema, CreateIssueSchema, CreateIssueEmojiReactionSchema, CreateIssueNoteEmojiReactionSchema, ListIssueEmojiReactionsSchema, ListIssueNoteEmojiReactionsSchema, CreateLabelSchema, MarkAllTodosDoneSchema, ListTodosSchema, MarkTodoDoneSchema, CreateMergeRequestDiscussionNoteSchema, CreateMergeRequestEmojiReactionSchema, ListMergeRequestEmojiReactionsSchema, ListMergeRequestNoteEmojiReactionsSchema, CreateMergeRequestNoteSchema, CreateMergeRequestNoteEmojiReactionSchema, CreateMergeRequestSchema, CreateMergeRequestThreadSchema, CreateNoteSchema, CreateCommitStatusSchema, CreateOrUpdateFileSchema, CreatePipelineSchema, CreateProjectMilestoneSchema, CreateGroupMilestoneSchema, CreateReleaseEvidenceSchema, CreateReleaseSchema, CreateRepositorySchema, CreateTagSchema, CreateTimelineEventSchema, CreateWebhookSchema, CreateWikiPageSchema, CreateWorkItemNoteSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, ListWorkItemEmojiReactionsSchema, ListWorkItemNoteEmojiReactionsSchema, CreateWorkItemSchema, DeleteBranchSchema, GetProtectedBranchSchema, ListProtectedBranchesSchema, ProtectBranchSchema, UpdateProtectedBranchSchema, ProtectTagSchema, UnprotectBranchSchema, UnprotectTagSchema, UpdateDefaultBranchSchema, DeleteDraftNoteSchema, DeleteGroupMilestoneSchema, DeleteGroupWikiPageSchema, DeleteIssueLinkSchema, DeleteIssueSchema, DeleteIssueEmojiReactionSchema, DeleteIssueNoteEmojiReactionSchema, DeleteLabelSchema, DeleteMergeRequestDiscussionNoteSchema, DeleteMergeRequestNoteSchema, DeleteMergeRequestEmojiReactionSchema, DeleteMergeRequestNoteEmojiReactionSchema, DeleteProjectMilestoneSchema, DeleteReleaseSchema, DeleteTagSchema, DeleteWebhookSchema, DeleteWikiPageSchema, DeleteWorkItemEmojiReactionSchema, DeleteWorkItemNoteEmojiReactionSchema, DownloadAttachmentSchema, DownloadAttachmentRemoteSchema, DownloadJobArtifactsSchema, DownloadJobArtifactsRemoteSchema, DownloadReleaseAssetSchema, EditProjectMilestoneSchema, EditGroupMilestoneSchema, ExecuteGraphQLSchema, ForkRepositorySchema, HealthCheckSchema, GetBranchSchema, GetBranchDiffsSchema, GetCommitDiffSchema, GetCommitSchema, GetFileBlameSchema, GetDeploymentSchema, CreateDeploymentSchema, UpdateDeploymentSchema, DeploymentApprovalSchema, ListDeploymentMergeRequestsSchema, GetDraftNoteSchema, GetEnvironmentSchema, UpdateEnvironmentSchema, StopEnvironmentSchema, StopStaleEnvironmentsSchema, DeleteReviewAppEnvironmentsSchema, PipelineTriggerIdSchema, ListPipelineTriggersSchema, CreatePipelineTriggerSchema, UpdatePipelineTriggerSchema, TriggerPipelineSchema, GetFileContentsSchema, GetGroupWikiPageSchema, GetIssueLinkSchema, GetIssueSchema, GetJobArtifactFileSchema, GetLabelSchema, GetMergeRequestApprovalStateSchema, GetMergeRequestConflictsSchema, GetMergeRequestDiffsSchema, GetMergeRequestFileDiffSchema, GetMergeRequestDiscussionSchema, GetMergeRequestNoteSchema, GetMergeRequestNotesSchema, GetMergeRequestSchema, GetMergeRequestVersionSchema, GetMilestoneBurndownEventsSchema, GetMilestoneIssuesSchema, GetMilestoneMergeRequestsSchema, GetGroupMilestoneSchema, GetGroupMilestoneIssuesSchema, GetGroupMilestoneMergeRequestsSchema, GetGroupMilestoneBurndownEventsSchema, GetNamespaceSchema, GetPipelineJobOutputSchema, PipelineJobControlSchema, GetPipelineSchema, GetRunnerSchema, GetPipelineVariablesSchema, UpdatePipelineMetadataSchema, DeletePipelineSchema, PipelineReportSchema, WaitForPipelineSchema, WaitForPipelineJobSchema, PlayPipelineJobsSchema, GetProjectEventsSchema, GetProjectMilestoneSchema, GetProjectSchema, GetReleaseSchema, GetRepositoryTreeSchema, GetTagSchema, GetTagSignatureSchema, GetProtectedTagSchema, GetTimelineEventsSchema, GetUsersSchema, GetUserSchema, WhoAmISchema, GetWebhookEventSchema, GetWikiPageSchema, GetWorkItemSchema, ListBranchesSchema, ListCommitsSchema, ListCommitStatusesSchema, ListCustomFieldDefinitionsSchema, ListDeploymentsSchema, ListDraftNotesSchema, ListEnvironmentsSchema, ListEventsSchema, ListGroupIterationsSchema, GetGroupIterationSchema, UpdateGroupIterationSchema, CreateGroupIterationSchema, ListGroupIterationCadencesSchema, DeleteGroupIterationSchema, ListProjectIterationsSchema, CreateGroupIterationCadenceSchema, UpdateGroupIterationCadenceSchema, DeleteGroupIterationCadenceSchema, ListGroupMilestonesSchema, ListGroupProjectsSchema, ListGroupWikiPagesSchema, ListIssueDiscussionsSchema, ListIssueLinksSchema, ListIssuesSchema, ListJobArtifactsSchema, ListLabelsSchema, ListMergeRequestChangedFilesSchema, ListMergeRequestDiffsSchema, ListMergeRequestDiscussionsSchema, ListMergeRequestPipelinesSchema, ListMergeRequestVersionsSchema, ListMergeRequestsSchema, ListGroupMergeRequestsSchema, ListNamespacesSchema, ListPipelineJobsSchema, ListPipelineTriggerJobsSchema, ValidateCiLintSchema, ValidateProjectCiLintSchema, ListCiCatalogResourcesSchema, GetCiCatalogResourceSchema, ListPipelinesSchema, ListPipelineSchedulesSchema, GetPipelineScheduleSchema, ListPipelineSchedulePipelinesSchema, CreatePipelineScheduleSchema, UpdatePipelineScheduleSchema, DeletePipelineScheduleSchema, PlayPipelineScheduleSchema, TakeOwnershipPipelineScheduleSchema, GetPipelineScheduleVariableSchema, CreatePipelineScheduleVariableSchema, UpdatePipelineScheduleVariableSchema, DeletePipelineScheduleVariableSchema, ListGroupMembersSchema, ListProjectMembersSchema, ListProjectMilestonesSchema, ListProjectsSchema, ListProjectRunnersSchema, ListReleasesSchema, ListTagsSchema, ListProtectedTagsSchema, ListWebhookEventsSchema, ListWebhooksSchema, ListWikiPagesSchema, ListWorkItemNotesSchema, ListWorkItemStatusesSchema, ListWorkItemsSchema, MarkdownUploadSchema, MarkdownUploadRemoteSchema, MergeMergeRequestSchema, MoveWorkItemSchema, MyIssuesSchema, OrbitQuerySchema, OrbitSchemaSchema, OrbitStatusSchema, OrbitToolsSchema, PlayPipelineJobSchema, PromoteProjectMilestoneSchema, PublishDraftNoteSchema, PushFilesSchema, ResolveMergeRequestThreadSchema, RetryPipelineJobSchema, RetryPipelineSchema, SearchCodeSchema, SearchGroupCodeSchema, SearchProjectCodeSchema, SearchRepositoriesSchema, ListSnippetsSchema, GetSnippetSchema, CreateSnippetSchema, UpdateSnippetSchema, DeleteSnippetSchema, UnapproveMergeRequestSchema, RebaseMergeRequestSchema, UpdateDraftNoteSchema, UpdateGroupWikiPageSchema, UpdateIssueNoteSchema, UpdateIssueSchema, UpdateIssueDescriptionPatchSchema, 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;
@@ -1010,6 +1010,41 @@ export const allTools = [
1010
1010
  description: "Update a manual group iteration's title, description, or dates. At least one of `title`, `description`, `start_date`, or `due_date` is required.",
1011
1011
  inputSchema: toJSONSchema(UpdateGroupIterationSchema),
1012
1012
  },
1013
+ {
1014
+ name: "create_group_iteration",
1015
+ description: "Create a group iteration, optionally in a given iteration cadence",
1016
+ inputSchema: toJSONSchema(CreateGroupIterationSchema),
1017
+ },
1018
+ {
1019
+ name: "delete_group_iteration",
1020
+ description: "Delete a group iteration by ID, IID, or GraphQL GID",
1021
+ inputSchema: toJSONSchema(DeleteGroupIterationSchema),
1022
+ },
1023
+ {
1024
+ name: "list_project_iterations",
1025
+ description: "List the iterations available to a project with filtering options",
1026
+ inputSchema: toJSONSchema(ListProjectIterationsSchema),
1027
+ },
1028
+ {
1029
+ name: "list_group_iteration_cadences",
1030
+ description: "List a group's iteration cadences with filtering options",
1031
+ inputSchema: toJSONSchema(ListGroupIterationCadencesSchema),
1032
+ },
1033
+ {
1034
+ name: "create_group_iteration_cadence",
1035
+ description: "Create an iteration cadence in a group",
1036
+ inputSchema: toJSONSchema(CreateGroupIterationCadenceSchema),
1037
+ },
1038
+ {
1039
+ name: "update_group_iteration_cadence",
1040
+ description: "Update an iteration cadence's title, description, schedule, or automation",
1041
+ inputSchema: toJSONSchema(UpdateGroupIterationCadenceSchema),
1042
+ },
1043
+ {
1044
+ name: "delete_group_iteration_cadence",
1045
+ description: "Delete an iteration cadence",
1046
+ inputSchema: toJSONSchema(DeleteGroupIterationCadenceSchema),
1047
+ },
1013
1048
  {
1014
1049
  name: "upload_markdown",
1015
1050
  description: IS_REMOTE
@@ -1551,6 +1586,8 @@ export const readOnlyTools = new Set([
1551
1586
  "list_commit_statuses",
1552
1587
  "list_group_iterations",
1553
1588
  "get_group_iteration",
1589
+ "list_group_iteration_cadences",
1590
+ "list_project_iterations",
1554
1591
  "download_attachment",
1555
1592
  "list_events",
1556
1593
  "get_project_events",
@@ -1627,6 +1664,8 @@ export const destructiveTools = new Set([
1627
1664
  "delete_group_wiki_page",
1628
1665
  "delete_milestone",
1629
1666
  "delete_group_milestone",
1667
+ "delete_group_iteration",
1668
+ "delete_group_iteration_cadence",
1630
1669
  "delete_release",
1631
1670
  "delete_tag",
1632
1671
  "delete_webhook",
@@ -1677,6 +1716,8 @@ export const deleteTools = new Set([
1677
1716
  "delete_group_variable",
1678
1717
  "delete_group_wiki_page",
1679
1718
  "delete_group_milestone",
1719
+ "delete_group_iteration",
1720
+ "delete_group_iteration_cadence",
1680
1721
  "delete_issue",
1681
1722
  "delete_issue_emoji_reaction",
1682
1723
  "delete_issue_link",
@@ -1982,6 +2023,13 @@ export const TOOLSET_DEFINITIONS = [
1982
2023
  "list_group_iterations",
1983
2024
  "get_group_iteration",
1984
2025
  "update_group_iteration",
2026
+ "create_group_iteration",
2027
+ "delete_group_iteration",
2028
+ "list_project_iterations",
2029
+ "list_group_iteration_cadences",
2030
+ "create_group_iteration_cadence",
2031
+ "update_group_iteration_cadence",
2032
+ "delete_group_iteration_cadence",
1985
2033
  "health_check",
1986
2034
  ]),
1987
2035
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zereight/mcp-gitlab",
3
- "version": "2.3.15-next.179",
3
+ "version": "2.3.15",
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": [