@zereight/mcp-gitlab 2.3.15-next.176 → 2.3.15-next.178

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/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, 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, 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";
@@ -2964,7 +2964,10 @@ async function updateWorkItem(projectId, iid, options) {
2964
2964
  inputParts.push("milestoneWidget: { milestoneId: $milestoneId }");
2965
2965
  variables.milestoneId = milestoneGID;
2966
2966
  }
2967
- if (options.iteration_id !== undefined) {
2967
+ if (options.remove_iteration) {
2968
+ inputParts.push("iterationWidget: { iterationId: null }");
2969
+ }
2970
+ else if (options.iteration_id !== undefined) {
2968
2971
  const iterationGID = options.iteration_id.startsWith("gid://")
2969
2972
  ? options.iteration_id
2970
2973
  : `gid://gitlab/Iteration/${options.iteration_id}`;
@@ -3031,6 +3034,7 @@ async function updateWorkItem(projectId, iid, options) {
3031
3034
  ... on WorkItemWidgetHealthStatus { healthStatus }
3032
3035
  ... on WorkItemWidgetStartAndDueDate { startDate dueDate }
3033
3036
  ... on WorkItemWidgetMilestone { milestone { id title } }
3037
+ ... on WorkItemWidgetIteration { iteration { id iid title } }
3034
3038
  }
3035
3039
  }
3036
3040
  errors
@@ -3118,6 +3122,7 @@ async function updateWorkItem(projectId, iid, options) {
3118
3122
  const healthStatusW = widgets.find((w) => w.__typename === "WorkItemWidgetHealthStatus");
3119
3123
  const datesW = widgets.find((w) => w.__typename === "WorkItemWidgetStartAndDueDate");
3120
3124
  const milestoneW = widgets.find((w) => w.__typename === "WorkItemWidgetMilestone");
3125
+ const iterationW = widgets.find((w) => w.__typename === "WorkItemWidgetIteration");
3121
3126
  return {
3122
3127
  id: wi.id,
3123
3128
  iid: wi.iid,
@@ -3134,6 +3139,7 @@ async function updateWorkItem(projectId, iid, options) {
3134
3139
  startDate: datesW?.startDate || null,
3135
3140
  dueDate: datesW?.dueDate || null,
3136
3141
  milestone: milestoneW?.milestone || null,
3142
+ iteration: iterationW?.iteration || null,
3137
3143
  children_added: options.children_to_add?.length || 0,
3138
3144
  children_removed: options.children_to_remove?.length || 0,
3139
3145
  linked_items_added: options.linked_items_to_add?.length || 0,
@@ -7001,6 +7007,94 @@ async function listGroupIterations(groupId, options = {}) {
7001
7007
  const data = await response.json();
7002
7008
  return z.array(GroupIteration).parse(data);
7003
7009
  }
7010
+ const ITERATION_GID_PREFIX = "gid://gitlab/Iteration/";
7011
+ function normalizeIterationLookupId(iterationId) {
7012
+ const decoded = decodeURIComponent(iterationId);
7013
+ const isGraphqlGid = decoded.startsWith(ITERATION_GID_PREFIX);
7014
+ return {
7015
+ targetId: isGraphqlGid ? decoded.slice(ITERATION_GID_PREFIX.length) : decoded,
7016
+ isGraphqlGid,
7017
+ };
7018
+ }
7019
+ function selectGroupIterationMatch(idMatch, iidMatch, iterationId, groupId) {
7020
+ if (idMatch && iidMatch && idMatch.id !== iidMatch.id) {
7021
+ throw new ToolInputError(`Group iteration ${iterationId} is ambiguous in group ${groupId}`);
7022
+ }
7023
+ if (idMatch)
7024
+ return idMatch;
7025
+ if (iidMatch)
7026
+ return iidMatch;
7027
+ throw new ToolInputError(`Group iteration ${iterationId} was not found in group ${groupId}`);
7028
+ }
7029
+ async function getGroupIteration(groupId, iterationId) {
7030
+ const { targetId, isGraphqlGid } = normalizeIterationLookupId(iterationId);
7031
+ let idMatch;
7032
+ let iidMatch;
7033
+ for (let page = 1;; page += 1) {
7034
+ const iterations = await listGroupIterations(groupId, {
7035
+ state: "all",
7036
+ include_ancestors: false,
7037
+ page,
7038
+ per_page: 100,
7039
+ });
7040
+ for (const iteration of iterations) {
7041
+ if (iteration.id === targetId) {
7042
+ idMatch = iteration;
7043
+ }
7044
+ else if (!isGraphqlGid && iteration.iid === targetId) {
7045
+ iidMatch = iteration;
7046
+ }
7047
+ }
7048
+ if (iterations.length < 100)
7049
+ break;
7050
+ }
7051
+ if (isGraphqlGid) {
7052
+ if (idMatch)
7053
+ return idMatch;
7054
+ throw new ToolInputError(`Group iteration ${iterationId} was not found in group ${groupId}`);
7055
+ }
7056
+ return selectGroupIterationMatch(idMatch, iidMatch, iterationId, groupId);
7057
+ }
7058
+ async function updateGroupIteration(groupId, iterationId, options) {
7059
+ if (options.title === undefined &&
7060
+ options.description === undefined &&
7061
+ options.start_date === undefined &&
7062
+ options.due_date === undefined) {
7063
+ throw new ToolInputError("Provide at least one iteration field to update");
7064
+ }
7065
+ const current = await getGroupIteration(groupId, iterationId);
7066
+ const groupReference = /^group:/i.test(groupId) ? groupId : `group:${groupId}`;
7067
+ const { path: groupPath } = await resolveProjectOrGroupPath(groupReference);
7068
+ const input = {
7069
+ groupPath,
7070
+ id: `${ITERATION_GID_PREFIX}${current.id}`,
7071
+ };
7072
+ if (options.title !== undefined)
7073
+ input.title = options.title;
7074
+ if (options.description !== undefined)
7075
+ input.description = options.description;
7076
+ if (options.start_date !== undefined)
7077
+ input.startDate = options.start_date;
7078
+ if (options.due_date !== undefined)
7079
+ input.dueDate = options.due_date;
7080
+ const mutation = `
7081
+ mutation UpdateGroupIteration($input: UpdateIterationInput!) {
7082
+ updateIteration(input: $input) {
7083
+ iteration { id }
7084
+ errors
7085
+ }
7086
+ }
7087
+ `;
7088
+ const data = await executeGraphQL(mutation, { input });
7089
+ const result = data.updateIteration;
7090
+ if (result.errors.length > 0) {
7091
+ throw new ToolInputError(`Failed to update group iteration: ${result.errors.join(", ")}`);
7092
+ }
7093
+ if (!result.iteration) {
7094
+ throw new ToolInputError("Failed to update group iteration: GitLab returned no iteration");
7095
+ }
7096
+ return getGroupIteration(groupId, `${ITERATION_GID_PREFIX}${current.id}`);
7097
+ }
7004
7098
  // --- CI/CD Variables ---
7005
7099
  async function listProjectVariables(projectId, options = {}) {
7006
7100
  projectId = decodeURIComponent(projectId);
@@ -10468,6 +10562,23 @@ async function handleToolCall(params) {
10468
10562
  content: [{ type: "text", text: JSON.stringify(iterations) }],
10469
10563
  };
10470
10564
  }
10565
+ case "get_group_iteration": {
10566
+ rejectIfStrictProjectScope("get_group_iteration");
10567
+ const args = GetGroupIterationSchema.parse(params.arguments);
10568
+ const iteration = await getGroupIteration(args.group_id, args.iteration_id);
10569
+ return {
10570
+ content: [{ type: "text", text: JSON.stringify(iteration) }],
10571
+ };
10572
+ }
10573
+ case "update_group_iteration": {
10574
+ rejectIfStrictProjectScope("update_group_iteration");
10575
+ const args = UpdateGroupIterationSchema.parse(params.arguments);
10576
+ const { group_id, iteration_id, ...options } = args;
10577
+ const iteration = await updateGroupIteration(group_id, iteration_id, options);
10578
+ return {
10579
+ content: [{ type: "text", text: JSON.stringify(iteration) }],
10580
+ };
10581
+ }
10471
10582
  // --- CI/CD Variables ---
10472
10583
  case "list_project_variables": {
10473
10584
  const args = ListProjectVariablesSchema.parse(params.arguments);
package/build/schemas.js CHANGED
@@ -3604,6 +3604,32 @@ export const ListGroupIterationsSchema = z
3604
3604
  .describe("Return only iterations updated after the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z)."),
3605
3605
  })
3606
3606
  .merge(PaginationOptionsSchema);
3607
+ /**
3608
+ * A required identifier that also accepts a numeric JSON value.
3609
+ *
3610
+ * `z.coerce.string()` would accept numbers too, but it turns a missing value into the
3611
+ * string "undefined", so an omitted ID would pass validation. Converting only numbers
3612
+ * keeps a missing or empty ID a validation error.
3613
+ */
3614
+ const requiredIterationIdentifier = (description) => z
3615
+ .preprocess(value => (typeof value === "number" ? String(value) : value), z.string().min(1))
3616
+ .describe(description);
3617
+ export const GetGroupIterationSchema = z.object({
3618
+ group_id: requiredIterationIdentifier("Group ID or URL-encoded path"),
3619
+ iteration_id: requiredIterationIdentifier("Iteration ID, IID, or GraphQL GID"),
3620
+ });
3621
+ export const UpdateGroupIterationSchema = z.object({
3622
+ group_id: requiredIterationIdentifier("Group ID or URL-encoded path"),
3623
+ iteration_id: requiredIterationIdentifier("Iteration ID, IID, or GraphQL GID"),
3624
+ title: z.string().optional().describe("New iteration title"),
3625
+ description: z
3626
+ .string()
3627
+ .nullable()
3628
+ .optional()
3629
+ .describe("New iteration description; null clears it"),
3630
+ start_date: z.string().optional().describe("New start date in YYYY-MM-DD format"),
3631
+ due_date: z.string().optional().describe("New due date in YYYY-MM-DD format"),
3632
+ });
3607
3633
  // Events API schemas
3608
3634
  export const GitLabEventAuthorSchema = z.object({
3609
3635
  id: z.coerce.string(),
@@ -4379,6 +4405,7 @@ export const UpdateWorkItemSchema = WorkItemParamsSchema.extend({
4379
4405
  .string()
4380
4406
  .optional()
4381
4407
  .describe("Iteration ID (e.g. 'gid://gitlab/Iteration/123' or numeric ID). Use list_group_iterations to find available iterations."),
4408
+ remove_iteration: flexibleBooleanOptional.describe("Set to true to remove the work item's iteration association. Mutually exclusive with iteration_id."),
4382
4409
  confidential: coerceBooleanString.optional().describe("Set confidentiality"),
4383
4410
  linked_items_to_add: z
4384
4411
  .array(z.object({
@@ -4431,6 +4458,8 @@ export const UpdateWorkItemSchema = WorkItemParamsSchema.extend({
4431
4458
  .enum(["TRIGGERED", "ACKNOWLEDGED", "RESOLVED", "IGNORED"])
4432
4459
  .optional()
4433
4460
  .describe("Incident only: set escalation status"),
4461
+ }).refine(args => !(args.remove_iteration && args.iteration_id !== undefined), {
4462
+ message: "Provide either iteration_id or remove_iteration, not both",
4434
4463
  });
4435
4464
  export const ConvertWorkItemTypeSchema = z.object({
4436
4465
  project_id: NamespaceIdOrPathSchema,
@@ -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, 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, 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;
@@ -1000,6 +1000,16 @@ export const allTools = [
1000
1000
  description: "List group iterations with filtering options",
1001
1001
  inputSchema: toJSONSchema(ListGroupIterationsSchema),
1002
1002
  },
1003
+ {
1004
+ name: "get_group_iteration",
1005
+ description: "Get a group iteration by ID, IID, or GraphQL GID",
1006
+ inputSchema: toJSONSchema(GetGroupIterationSchema),
1007
+ },
1008
+ {
1009
+ name: "update_group_iteration",
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
+ inputSchema: toJSONSchema(UpdateGroupIterationSchema),
1012
+ },
1003
1013
  {
1004
1014
  name: "upload_markdown",
1005
1015
  description: IS_REMOTE
@@ -1159,7 +1169,7 @@ export const allTools = [
1159
1169
  },
1160
1170
  {
1161
1171
  name: "update_work_item",
1162
- description: "Update a work item (title, description, labels, assignees, state, parent, custom fields, etc.)",
1172
+ description: "Update a work item (title, description, labels, assignees, state, parent, iteration, custom fields, etc.). Use remove_iteration to explicitly clear the iteration association.",
1163
1173
  inputSchema: toJSONSchema(UpdateWorkItemSchema),
1164
1174
  },
1165
1175
  {
@@ -1970,6 +1980,8 @@ export const TOOLSET_DEFINITIONS = [
1970
1980
  "verify_namespace",
1971
1981
  "list_group_projects",
1972
1982
  "list_group_iterations",
1983
+ "get_group_iteration",
1984
+ "update_group_iteration",
1973
1985
  "health_check",
1974
1986
  ]),
1975
1987
  },
@@ -43,6 +43,11 @@ const LIST_SUMMARY_DEFAULT_EXCLUDED_TOOLS = new Set([
43
43
  "list_webhooks", // url, event flags
44
44
  "list_pipeline_triggers", // description
45
45
  "list_job_artifacts", // path, type, size
46
+ "list_branches", // protected, default, merged
47
+ "list_protected_branches", // *_access_levels, allow_force_push
48
+ "list_protected_tags", // create_access_levels
49
+ "list_project_members", // access_level, expires_at
50
+ "list_group_members", // access_level, expires_at
46
51
  // The reply is an envelope summarizeListPayload does not read.
47
52
  "list_project_vulnerabilities", // { vulnerabilities, pageInfo }
48
53
  "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.15-next.176",
3
+ "version": "2.3.15-next.178",
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": [