@zereight/mcp-gitlab 2.3.0 → 2.3.2

package/README.ko.md

@@ -138,7 +138,13 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
 
 예시는 기존 `mcp-gitlab`보다 충돌 가능성이 낮은 `zereight-mcp-gitlab` 별칭을 사용합니다. MCP 클라이언트가 찾지 못하면 `which zereight-mcp-gitlab`의 절대 경로를 사용하세요.
 
-전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.2.6`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
+전역 설치를 쓰지 않으려면 `npx -y @zereight/mcp-gitlab@2.3.1`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
+
+#### Claude Desktop 원클릭 설치(MCP Bundle)
+
+v2.3.1 이후의 GitHub 릴리스마다 `gitlab-mcp.mcpb` [MCP Bundle](https://github.com/modelcontextprotocol/mcpb)이 첨부됩니다. [최신 번들](https://github.com/zereight/gitlab-mcp/releases/latest/download/gitlab-mcp.mcpb)을 내려받아 Claude Desktop으로 열거나 **Settings → Extensions**에 끌어다 놓으세요. Claude Desktop이 Personal Access Token을 입력받아 민감 정보로 저장하고, `GITLAB_API_URL`, `GITLAB_PERMISSION_MODE`, `GITLAB_TOOLSETS`, `GITLAB_MASKING_ENABLED`를 설정할 수 있게 합니다. Node.js나 npm을 따로 설치할 필요가 없습니다.
+
+소스에서 번들을 만들려면 `npm run pack:mcpb`를 실행하세요(`gitlab-mcp.mcpb` 생성).
 
 #### CLI 인자 사용하기(환경 변수 문제가 있는 클라이언트용)
 

package/README.md

@@ -143,7 +143,13 @@ The store path is pinned by your lock file; update it with `nix flake update git
 
 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`.
 
-No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.2.6`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
+No global install? Pin `npx` to the previous stable release (the version these docs recommend), for example `npx -y @zereight/mcp-gitlab@2.3.1`. If you always want the newest release, use `npx -y @zereight/mcp-gitlab@latest` instead. The server prints a notice to stderr on startup when a newer version is available (disable with `GITLAB_DISABLE_VERSION_CHECK=true`).
+
+#### Claude Desktop one-click install (MCP Bundle)
+
+Every GitHub release after v2.3.1 ships a `gitlab-mcp.mcpb` [MCP Bundle](https://github.com/modelcontextprotocol/mcpb). Download the [latest bundle](https://github.com/zereight/gitlab-mcp/releases/latest/download/gitlab-mcp.mcpb) and open it with Claude Desktop (or drag it into **Settings → Extensions**). Claude Desktop asks for your Personal Access Token (stored as a sensitive value) and lets you set `GITLAB_API_URL`, `GITLAB_PERMISSION_MODE`, `GITLAB_TOOLSETS`, and `GITLAB_MASKING_ENABLED`. No separate Node.js or npm install is needed.
+
+To build the bundle from source, run `npm run pack:mcpb` (writes `gitlab-mcp.mcpb`).
 
 #### Using CLI Arguments (for clients with env var issues)
 

package/README.pt-BR.md

@@ -138,7 +138,13 @@ O caminho no store é fixado pelo seu lock file; atualize-o com `nix flake updat
 
 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`.
 
-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.2.6`. Se quiser sempre a versão mais recente, use `npx -y @zereight/mcp-gitlab@latest`. 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`).
+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.1`. Se quiser sempre a versão mais recente, use `npx -y @zereight/mcp-gitlab@latest`. 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`).
+
+#### Instalação com um clique no Claude Desktop (MCP Bundle)
+
+Cada release no GitHub posterior à v2.3.1 inclui um [MCP Bundle](https://github.com/modelcontextprotocol/mcpb) `gitlab-mcp.mcpb`. Baixe o [bundle mais recente](https://github.com/zereight/gitlab-mcp/releases/latest/download/gitlab-mcp.mcpb) e abra-o com o Claude Desktop (ou arraste-o para **Settings → Extensions**). O Claude Desktop pede seu Personal Access Token (armazenado como valor sensível) e permite definir `GITLAB_API_URL`, `GITLAB_PERMISSION_MODE`, `GITLAB_TOOLSETS` e `GITLAB_MASKING_ENABLED`. Não é preciso instalar Node.js ou npm separadamente.
+
+Para gerar o bundle a partir do código-fonte, execute `npm run pack:mcpb` (gera `gitlab-mcp.mcpb`).
 
 #### Usando argumentos de CLI (para clientes com problemas com variáveis de ambiente)
 

package/README.zh-CN.md

@@ -138,7 +138,13 @@ command = lib.getExe inputs.gitlab-mcp.packages.${system}.default;
 
 示例使用 `zereight-mcp-gitlab`，这是比旧的 `mcp-gitlab` 更不容易冲突的别名。如果 MCP 客户端找不到它，请使用 `which zereight-mcp-gitlab` 输出的绝对路径。
 
-如果不想全局安装，请将 `npx` 固定到上一个稳定版本（即文档推荐的版本），例如 `npx -y @zereight/mcp-gitlab@2.2.6`。如果始终想使用最新版本，请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时，服务器会在启动时通过 stderr 提示（可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭）。
+如果不想全局安装，请将 `npx` 固定到上一个稳定版本（即文档推荐的版本），例如 `npx -y @zereight/mcp-gitlab@2.3.1`。如果始终想使用最新版本，请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时，服务器会在启动时通过 stderr 提示（可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭）。
+
+#### Claude Desktop 一键安装（MCP Bundle）
+
+v2.3.1 之后的每个 GitHub Release 都附带 `gitlab-mcp.mcpb` [MCP Bundle](https://github.com/modelcontextprotocol/mcpb)。下载[最新的 bundle](https://github.com/zereight/gitlab-mcp/releases/latest/download/gitlab-mcp.mcpb)，用 Claude Desktop 打开（或拖到 **Settings → Extensions** 中）。Claude Desktop 会要求输入 Personal Access Token（作为敏感值保存），并可设置 `GITLAB_API_URL`、`GITLAB_PERMISSION_MODE`、`GITLAB_TOOLSETS` 和 `GITLAB_MASKING_ENABLED`。无需另外安装 Node.js 或 npm。
+
+如需从源码构建 bundle，运行 `npm run pack:mcpb`（生成 `gitlab-mcp.mcpb`）。
 
 #### 使用 CLI 参数（适用于环境变量有问题的客户端）
 

package/build/index.js

@@ -109,6 +109,7 @@ import { buildBulkPublishDraftNotesBody, needsGitLab19_2BulkPublish, } from "./u
 import { appendFilterParam, appendFilterParams, cleanMutuallyExclusiveIdUsernameOptions, dropBlankArrayEntries, isBlankFilterValue, LIST_MERGE_REQUESTS_ID_USERNAME_PAIRS, sanitizeToolArguments, } from "./utils/tool-args.js";
 import { applyJmespathToToolResult, getJmespathSyntaxError, JMESPATH_TOOL_ARGUMENT, JMESPATH_TOOL_ARGUMENT_DESCRIPTION, omitJmespathArgument, readJmespathExpression, } from "./utils/jmespath-tool-result.js";
 import { parseSearchReplaceBlocks, applySearchReplace, applyUnifiedDiff, } from "./utils/patch-helper.js";
+import { zodSchemaFor } from "./utils/schema.js";
 import { GitLabClientPool } from "./gitlab-client-pool.js";
 import { advertisesReadOnly, allTools, readOnlyTools, destructiveTools, deleteTools, parseEnabledToolsets, parseIndividualTools, buildFeatureFlagOverrides, isToolInEnabledToolset, findSmallestToolsetForTool, isExplicitOnlyToolsetId, isExplicitToolsetOnlyTool, isToolsetFullyActive, listDiscoverableCategories, TOOLSET_DEFINITIONS, DISCOVERABLE_TOOLSET_IDS, } from "./tools/registry.js";
 import { executeGitLabApiRequestAsync, GitLabApiRequestHttpError, GitLabApiRequestInputError, } from "./tools/gitlab-api-request.js";
@@ -8764,12 +8765,19 @@ async function handleToolCall(params) {
             }
             case "rebase_merge_request": {
                 const { project_id, merge_request_iid, skip_ci, wait, timeout_seconds, poll_interval_seconds, } = RebaseMergeRequestSchema.parse(params.arguments);
-                const enqueued = await rebaseMergeRequest(project_id, merge_request_iid, skip_ci);
                 if (!wait) {
+                    const enqueued = await rebaseMergeRequest(project_id, merge_request_iid, skip_ci);
                     return { content: [{ type: "text", text: JSON.stringify(enqueued) }] };
                 }
+                const { mergeRequest: previous } = await getMergeRequestRebaseStatus(project_id, merge_request_iid);
+                await rebaseMergeRequest(project_id, merge_request_iid, skip_ci);
                 const { mergeRequest } = await waitForStatus(signal => getMergeRequestRebaseStatus(project_id, merge_request_iid, signal), TERMINAL_REBASE_STATUSES, timeout_seconds, poll_interval_seconds);
-                return { content: [{ type: "text", text: JSON.stringify(mergeRequest) }] };
+                const rebaseResult = {
+                    ...mergeRequest,
+                    previous_sha: previous.sha,
+                    head_changed: mergeRequest.sha !== previous.sha,
+                };
+                return { content: [{ type: "text", text: JSON.stringify(rebaseResult) }] };
             }
             case "get_merge_request_approval_state": {
                 const args = GetMergeRequestApprovalStateSchema.parse(params.arguments);
@@ -11328,9 +11336,17 @@ async function handleToolCall(params) {
         // Sensitive fields are also covered by REDACT_PATHS if arguments are logged elsewhere.
         logger.debug({ tool: params.name }, "Tool call failed");
         if (error instanceof z.ZodError) {
-            throw new Error(`Invalid arguments: ${error.issues
-                .map(e => `${e.path.join(".")}: ${e.message}`)
-                .join(", ")}`);
+            const detail = error.issues
+                .map(e => (e.path.length > 0 ? `${e.path.join(".")}: ${e.message}` : e.message))
+                .join("; ");
+            // Response schemas throw ZodError too. If the arguments pass the tool's own
+            // schema, the failure came from parsing a GitLab response.
+            const argsSchema = zodSchemaFor(allTools.find(tool => tool.name === params.name)?.inputSchema);
+            if (argsSchema?.safeParse(params.arguments).success) {
+                throw new Error(`Unexpected GitLab response for ${params.name}: ${detail}`);
+            }
+            // ToolInputError is returned as an isError tool result, so the model can fix and retry.
+            throw new ToolInputError(`Invalid arguments for ${params.name}: ${detail}`);
         }
         throw error;
     }

package/build/schemas.js

@@ -15,16 +15,25 @@ const coerceStringArray = z.preprocess(val => {
     }
     return val;
 }, z.array(z.string()));
-const coerceBooleanString = z.preprocess(val => {
+// Helper: boolean tool argument that also accepts "true"/"false" and 1/0 (string or number).
+// Use this instead of z.coerce.boolean() for tool inputs: Boolean("false") === true.
+const parseBooleanString = (val) => {
     if (typeof val === "string") {
         const normalized = val.trim().toLowerCase();
-        if (normalized === "true")
+        if (normalized === "true" || normalized === "1")
             return true;
-        if (normalized === "false")
+        if (normalized === "false" || normalized === "0")
             return false;
     }
+    if (val === 1)
+        return true;
+    if (val === 0)
+        return false;
     return val;
-}, z.boolean());
+};
+const coerceBooleanString = z.preprocess(parseBooleanString, z.boolean());
+// Same as coerceBooleanString with a default; the default stays visible in the tool's JSON schema.
+const coerceBooleanStringDefault = (value) => z.preprocess(parseBooleanString, z.boolean().default(value));
 // Base schemas for common types
 export const GitLabAuthorSchema = z.object({
     name: z.string(),
@@ -234,8 +243,7 @@ export const ListPipelinesSchema = z
         .describe("The status of pipelines"),
     ref: z.string().optional().describe("The ref of pipelines"),
     sha: z.string().optional().describe("The SHA of pipelines"),
-    yaml_errors: z.coerce
-        .boolean()
+    yaml_errors: coerceBooleanString
         .optional()
         .describe("Returns pipelines with invalid configurations"),
     username: z.string().optional().describe("The username of the user who triggered pipelines"),
@@ -341,7 +349,7 @@ export const ListPipelineJobsSchema = z
         .enum(["created", "pending", "running", "failed", "success", "canceled", "skipped", "manual"])
         .optional()
         .describe("The scope of jobs to show"),
-    include_retried: z.coerce.boolean().optional().describe("Whether to include retried jobs"),
+    include_retried: coerceBooleanString.optional().describe("Whether to include retried jobs"),
 })
     .merge(PaginationOptionsSchema);
 // Schema for listing trigger jobs (bridges) in a pipeline
@@ -382,8 +390,8 @@ export const GitLabCiLintResultSchema = z.object({
 export const ValidateCiLintSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     content: z.string().describe("GitLab CI/CD YAML content to validate"),
-    dry_run: z.coerce.boolean().optional().describe("Run pipeline creation simulation"),
-    include_jobs: z.coerce.boolean().optional().describe("Include jobs in the lint response"),
+    dry_run: coerceBooleanString.optional().describe("Run pipeline creation simulation"),
+    include_jobs: coerceBooleanString.optional().describe("Include jobs in the lint response"),
     ref: z.string().optional().describe("Branch or tag context for dry_run validation"),
 });
 export const ValidateProjectCiLintSchema = z.object({
@@ -392,9 +400,9 @@ export const ValidateProjectCiLintSchema = z.object({
         .string()
         .optional()
         .describe("Commit SHA, branch, or tag to read the existing CI config from"),
-    dry_run: z.coerce.boolean().optional().describe("Run pipeline creation simulation"),
+    dry_run: coerceBooleanString.optional().describe("Run pipeline creation simulation"),
     dry_run_ref: z.string().optional().describe("Branch or tag context for dry_run validation"),
-    include_jobs: z.coerce.boolean().optional().describe("Include jobs in the lint response"),
+    include_jobs: coerceBooleanString.optional().describe("Include jobs in the lint response"),
 });
 const CiCatalogResourceSortSchema = z.enum([
     "CREATED_ASC",
@@ -429,7 +437,7 @@ const GetCiCatalogResourceOptionsSchema = z.object({
     version_limit: z.coerce.number().int().min(1).max(20).optional().describe("Number of versions to include (default: 5, max: 20)"),
     component_limit: z.coerce.number().int().min(1).max(50).optional().describe("Number of components per version to include (default: 20, max: 50)"),
     component_name: z.string().optional().describe("Filter returned components by component name"),
-    include_readme: z.coerce.boolean().optional().describe("Include version README content"),
+    include_readme: coerceBooleanString.optional().describe("Include version README content"),
 });
 export const GetCiCatalogResourceSchema = z.union([
     GetCiCatalogResourceOptionsSchema.extend({
@@ -912,7 +920,7 @@ export const RetryPipelineJobSchema = PipelineJobControlSchema.extend({
 export const CancelPipelineJobSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     job_id: z.coerce.string().describe("The ID of the job"),
-    force: z.coerce.boolean().optional().describe("Force cancellation of the job"),
+    force: coerceBooleanString.optional().describe("Force cancellation of the job"),
 });
 export const ErasePipelineJobSchema = PipelineJobControlSchema;
 export const WaitForPipelineSchema = GetPipelineSchema.extend({
@@ -1259,7 +1267,7 @@ export const GetRepositoryTreeSchema = z.object({
         .string()
         .optional()
         .describe("The name of a repository branch or tag. Defaults to the default branch."),
-    recursive: z.coerce.boolean().optional().describe("Boolean value to get a recursive tree"),
+    recursive: coerceBooleanString.optional().describe("Boolean value to get a recursive tree"),
     per_page: z.coerce.number().optional().describe("Number of results to show per page"),
     page_token: z
         .string()
@@ -1362,7 +1370,7 @@ export const CreateRepositoryOptionsSchema = z.object({
     namespace_id: z.preprocess(val => (val === "" ? undefined : val), z.coerce.number().int().min(1).optional()),
     description: z.string().optional(),
     visibility: z.enum(["private", "internal", "public"]).optional(), // Changed from private to match GitLab API
-    initialize_with_readme: z.coerce.boolean().optional(), // Changed from auto_init to match GitLab API
+    initialize_with_readme: coerceBooleanString.optional(), // Changed from auto_init to match GitLab API
 });
 export const CreateIssueOptionsSchema = z.object({
     title: z.string(),
@@ -1784,7 +1792,7 @@ export const UpdateMergeRequestDiscussionNoteSchema = ProjectParamsSchema.extend
     discussion_id: z.coerce.string().describe("The ID of a thread"),
     note_id: z.coerce.string().describe("The ID of a thread note"),
     body: z.string().optional().describe("The content of the note or reply"),
-    resolved: z.coerce.boolean().optional().describe("Resolve or unresolve the note"),
+    resolved: coerceBooleanString.optional().describe("Resolve or unresolve the note"),
 })
     .refine(data => data.body !== undefined || data.resolved !== undefined, {
     message: "At least one of 'body' or 'resolved' must be provided",
@@ -1805,7 +1813,7 @@ export const UpdateIssueNoteSchema = ProjectParamsSchema.extend({
     discussion_id: z.coerce.string().describe("The ID of a thread"),
     note_id: z.coerce.string().describe("The ID of a thread note"),
     body: z.string().optional().describe("The content of the note or reply"),
-    resolved: z.coerce.boolean().optional().describe("Resolve or unresolve the note"),
+    resolved: coerceBooleanString.optional().describe("Resolve or unresolve the note"),
 })
     .refine(data => data.body !== undefined || data.resolved !== undefined, {
     message: "At least one of 'body' or 'resolved' must be provided",
@@ -1860,7 +1868,7 @@ export const CreateRepositorySchema = z.object({
         .enum(["private", "internal", "public"])
         .optional()
         .describe("Repository visibility level"),
-    initialize_with_readme: z.coerce.boolean().optional().describe("Initialize with README.md"),
+    initialize_with_readme: coerceBooleanString.optional().describe("Initialize with README.md"),
 });
 export const GetFileContentsSchema = z
     .object({
@@ -2011,18 +2019,15 @@ const MergeRequestOptionsSchema = {
         .optional()
         .describe("The ID of the users to assign as reviewers of the MR"),
     labels: coerceStringArray.optional().describe("Labels for the MR"),
-    draft: z.coerce.boolean().optional().describe("Create as draft merge request"),
-    allow_collaboration: z.coerce
-        .boolean()
+    draft: coerceBooleanString.optional().describe("Create as draft merge request"),
+    allow_collaboration: coerceBooleanString
         .optional()
         .describe("Allow commits from upstream members"),
-    remove_source_branch: z.coerce
-        .boolean()
+    remove_source_branch: coerceBooleanString
         .nullable()
         .optional()
         .describe("Flag indicating if a merge request should remove the source branch when merging."),
-    squash: z.coerce
-        .boolean()
+    squash: coerceBooleanString
         .nullable()
         .optional()
         .describe("If true, squash all commits into a single commit on merge."),
@@ -2145,8 +2150,7 @@ export const GitLabBranchSchema = z.object({
 export const GetBranchDiffsSchema = ProjectParamsSchema.extend({
     from: z.string().describe("The base branch or commit SHA to compare from"),
     to: z.string().describe("The target branch or commit SHA to compare to"),
-    straight: z.coerce
-        .boolean()
+    straight: coerceBooleanString
         .optional()
         .describe("Comparison method: false for '...' (default), true for '--'"),
     excluded_file_patterns: z
@@ -2196,15 +2200,13 @@ export const UpdateMergeRequestSchema = MergeRequestParamsSchema.extend({
         .enum(["close", "reopen"])
         .optional()
         .describe("New state (close/reopen) for the MR"),
-    remove_source_branch: z.coerce
-        .boolean()
+    remove_source_branch: coerceBooleanString
         .optional()
         .describe("Flag indicating if the source branch should be removed"),
-    squash: z.coerce
-        .boolean()
+    squash: coerceBooleanString
         .optional()
         .describe("Squash commits into a single commit when merging"),
-    draft: z.coerce.boolean().optional().describe("Work in progress merge request"),
+    draft: coerceBooleanString.optional().describe("Work in progress merge request"),
     milestone_id: z
         .preprocess(val => (val === null ? undefined : val), z.coerce.string().optional())
         .describe("Milestone ID to assign. Set to 0 to unassign. Null is treated as omitted."),
@@ -2215,27 +2217,15 @@ export const MergeMergeRequestSchema = ProjectParamsSchema.extend({
         .string()
         .optional()
         .describe("SHA of the source-branch HEAD from get_merge_request (`sha` or `diff_refs.head_sha`). If provided, GitLab merges only when HEAD still matches. GitLab 19.2+ groups may require this (Require a commit SHA on the merge requests API)."),
-    auto_merge: z.coerce
-        .boolean()
-        .optional()
-        .default(false)
+    auto_merge: coerceBooleanStringDefault(false)
         .describe("If true, the merge request merges when the pipeline succeeds."),
     merge_commit_message: z.string().optional().describe("Custom merge commit message"),
-    merge_when_pipeline_succeeds: z.coerce
-        .boolean()
-        .optional()
-        .default(false)
+    merge_when_pipeline_succeeds: coerceBooleanStringDefault(false)
         .describe("If true, the merge request merges when the pipeline succeeds. Deprecated in GitLab 17.11. Use `auto_merge` instead."),
-    should_remove_source_branch: z.coerce
-        .boolean()
-        .optional()
-        .default(false)
+    should_remove_source_branch: coerceBooleanStringDefault(false)
         .describe("Remove source branch after merge"),
     squash_commit_message: z.string().optional().describe("Custom squash commit message"),
-    squash: z.coerce
-        .boolean()
-        .optional()
-        .default(false)
+    squash: coerceBooleanStringDefault(false)
         .describe("Squash commits into a single commit when merging"),
 });
 // Merge Request Approval schemas
@@ -2364,8 +2354,7 @@ export const ListMergeRequestDiffsSchema = MergeRequestParamsSchema.extend({
         .number()
         .optional()
         .describe("Number of items per page (max: 100, default: 20)"),
-    unidiff: z.coerce
-        .boolean()
+    unidiff: coerceBooleanString
         .optional()
         .describe("Present diffs in the unified diff format. Default is false. Introduced in GitLab 16.5."),
 });
@@ -2380,8 +2369,7 @@ export const GetMergeRequestFileDiffSchema = MergeRequestParamsSchema.extend({
         .array(z.string())
         .describe("List of file paths to retrieve diffs for (e.g. ['src/api/users.ts', 'src/repo/user.go']). " +
         "Call list_merge_request_changed_files first to get the full list of changed paths."),
-    unidiff: z.coerce
-        .boolean()
+    unidiff: coerceBooleanString
         .optional()
         .describe("Present diff in the unified diff format. Default is false."),
 });
@@ -2391,8 +2379,7 @@ export const ListMergeRequestVersionsSchema = ProjectParamsSchema.extend({
 });
 export const GetMergeRequestVersionSchema = ListMergeRequestVersionsSchema.extend({
     version_id: z.coerce.string().describe("The ID of the merge request diff version"),
-    unidiff: z.coerce
-        .boolean()
+    unidiff: coerceBooleanString
         .optional()
         .describe("Present diffs in the unified diff format. Default is false. Introduced in GitLab 16.5."),
 });
@@ -2427,7 +2414,7 @@ export const ListIssuesSchema = z
         .string()
         .optional()
         .describe("Return issues created by the given username. Mutually exclusive with author_id."),
-    confidential: z.coerce.boolean().optional().describe("Filter confidential or public issues"),
+    confidential: coerceBooleanString.optional().describe("Filter confidential or public issues"),
     created_after: z.string().optional().describe("Return issues created after the given time"),
     created_before: z.string().optional().describe("Return issues created before the given time"),
     due_date: z.string().optional().describe("Return issues that have the due date"),
@@ -2452,8 +2439,7 @@ export const ListIssuesSchema = z
         .describe("Return issues with a specific state"),
     updated_after: z.string().optional().describe("Return issues updated after the given time"),
     updated_before: z.string().optional().describe("Return issues updated before the given time"),
-    with_labels_details: z.coerce
-        .boolean()
+    with_labels_details: coerceBooleanString
         .optional()
         .describe("Return more details for each label"),
 })
@@ -2546,8 +2532,7 @@ export const ListMergeRequestsSchema = z
         .enum(["yes", "no"])
         .optional()
         .describe("Filter merge requests against their wip status"),
-    with_labels_details: z.coerce
-        .boolean()
+    with_labels_details: coerceBooleanString
         .optional()
         .describe("Return more details for each label"),
 })
@@ -2578,8 +2563,8 @@ export const UpdateIssueSchema = z.object({
         .array(z.coerce.number())
         .optional()
         .describe("Array of user IDs to assign issue to"),
-    confidential: z.coerce.boolean().optional().describe("Set the issue to be confidential"),
-    discussion_locked: z.coerce.boolean().optional().describe("Flag to lock discussions"),
+    confidential: coerceBooleanString.optional().describe("Set the issue to be confidential"),
+    discussion_locked: coerceBooleanString.optional().describe("Flag to lock discussions"),
     due_date: z.string().optional().describe("Date the issue is due (YYYY-MM-DD)"),
     labels: coerceStringArray.optional().describe("Array of label names"),
     milestone_id: z.coerce.string().optional().describe("Milestone ID to assign"),
@@ -2606,16 +2591,13 @@ export const UpdateIssueDescriptionPatchSchema = z.object({
         .min(1)
         .max(50000)
         .describe("The patch content to apply to the issue description"),
-    dry_run: z.coerce
-        .boolean()
+    dry_run: coerceBooleanString
         .optional()
         .describe("If true, preview changes without updating the issue"),
-    create_note: z.coerce
-        .boolean()
+    create_note: coerceBooleanString
         .optional()
         .describe("If true, add a note summarizing the change after update"),
-    allow_multiple: z.coerce
-        .boolean()
+    allow_multiple: coerceBooleanString
         .optional()
         .describe("For search_replace: allow multiple matches to all be replaced (default: false — fail on duplicate)"),
 });
@@ -2653,7 +2635,7 @@ export const DeleteIssueLinkSchema = z.object({
 export const ListNamespacesSchema = z
     .object({
     search: z.string().optional().describe("Search term for namespaces"),
-    owned: z.coerce.boolean().optional().describe("Filter for namespaces owned by current user"),
+    owned: coerceBooleanString.optional().describe("Filter for namespaces owned by current user"),
 })
     .merge(PaginationOptionsSchema);
 export const GetNamespaceSchema = z.object({
@@ -2713,17 +2695,15 @@ export const UpdateProjectSchema = ProjectParamsSchema.extend({
 export const ListProjectsSchema = z
     .object({
     search: z.string().optional().describe("Search term for projects"),
-    search_namespaces: z.coerce
-        .boolean()
+    search_namespaces: coerceBooleanString
         .optional()
         .describe("Needs to be true if search is full path"),
-    owned: z.coerce.boolean().optional().describe("Filter for projects owned by current user"),
-    membership: z.coerce
-        .boolean()
+    owned: coerceBooleanString.optional().describe("Filter for projects owned by current user"),
+    membership: coerceBooleanString
         .optional()
         .describe("Filter for projects where current user is a member"),
-    simple: z.coerce.boolean().optional().describe("Return only limited fields"),
-    archived: z.coerce.boolean().optional().describe("Filter for archived projects"),
+    simple: coerceBooleanString.optional().describe("Return only limited fields"),
+    archived: coerceBooleanString.optional().describe("Filter for archived projects"),
     visibility: z
         .enum(["public", "internal", "private"])
         .optional()
@@ -2736,12 +2716,10 @@ export const ListProjectsSchema = z
         .enum(["asc", "desc"])
         .optional()
         .describe("Return projects sorted in ascending or descending order"),
-    with_issues_enabled: z.coerce
-        .boolean()
+    with_issues_enabled: coerceBooleanString
         .optional()
         .describe("Filter projects with issues feature enabled"),
-    with_merge_requests_enabled: z.coerce
-        .boolean()
+    with_merge_requests_enabled: coerceBooleanString
         .optional()
         .describe("Filter projects with merge requests feature enabled"),
     min_access_level: z.coerce.number().optional().describe("Filter by minimum access level"),
@@ -2752,18 +2730,17 @@ export const ListProjectsSchema = z
 export const ListLabelsSchema = z
     .object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
-    with_counts: z.coerce
-        .boolean()
+    with_counts: coerceBooleanString
         .optional()
         .describe("Whether to include issue and merge request counts"),
-    include_ancestor_groups: z.coerce.boolean().optional().describe("Include ancestor groups"),
+    include_ancestor_groups: coerceBooleanString.optional().describe("Include ancestor groups"),
     search: z.string().optional().describe("Keyword to filter labels by"),
 })
     .merge(PaginationOptionsSchema);
 export const GetLabelSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     label_id: z.coerce.string().describe("The ID or title of a project's label"),
-    include_ancestor_groups: z.coerce.boolean().optional().describe("Include ancestor groups"),
+    include_ancestor_groups: coerceBooleanString.optional().describe("Include ancestor groups"),
 });
 export const CreateLabelSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
@@ -2793,32 +2770,30 @@ export const DeleteLabelSchema = z.object({
 export const ListGroupProjectsSchema = z
     .object({
     group_id: z.coerce.string().describe("Group ID or path"),
-    include_subgroups: z.coerce.boolean().optional().describe("Include projects from subgroups"),
+    include_subgroups: coerceBooleanString.optional().describe("Include projects from subgroups"),
     search: z.string().optional().describe("Search term to filter projects"),
     order_by: z
         .enum(["name", "path", "created_at", "updated_at", "last_activity_at"])
         .optional()
         .describe("Field to sort by"),
     sort: z.enum(["asc", "desc"]).optional().describe("Sort direction"),
-    archived: z.coerce.boolean().optional().describe("Filter for archived projects"),
+    archived: coerceBooleanString.optional().describe("Filter for archived projects"),
     visibility: z
         .enum(["public", "internal", "private"])
         .optional()
         .describe("Filter by project visibility"),
-    with_issues_enabled: z.coerce
-        .boolean()
+    with_issues_enabled: coerceBooleanString
         .optional()
         .describe("Filter projects with issues feature enabled"),
-    with_merge_requests_enabled: z.coerce
-        .boolean()
+    with_merge_requests_enabled: coerceBooleanString
         .optional()
         .describe("Filter projects with merge requests feature enabled"),
     min_access_level: z.coerce.number().optional().describe("Filter by minimum access level"),
     with_programming_language: z.string().optional().describe("Filter by programming language"),
-    starred: z.coerce.boolean().optional().describe("Filter by starred projects"),
-    statistics: z.coerce.boolean().optional().describe("Include project statistics"),
-    with_custom_attributes: z.coerce.boolean().optional().describe("Include custom attributes"),
-    with_security_reports: z.coerce.boolean().optional().describe("Include security reports"),
+    starred: coerceBooleanString.optional().describe("Filter by starred projects"),
+    statistics: coerceBooleanString.optional().describe("Include project statistics"),
+    with_custom_attributes: coerceBooleanString.optional().describe("Include custom attributes"),
+    with_security_reports: coerceBooleanString.optional().describe("Include security reports"),
     topic: z.string().optional().describe("Filter by topic (projects tagged with this topic)"),
 })
     .merge(PaginationOptionsSchema);
@@ -2826,9 +2801,8 @@ export const ListGroupProjectsSchema = z
 export const ListWikiPagesSchema = z
     .object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
-    with_content: z.coerce.boolean().optional().describe("Include content of the wiki pages"),
-    render_html: z.coerce
-        .boolean()
+    with_content: coerceBooleanString.optional().describe("Include content of the wiki pages"),
+    render_html: coerceBooleanString
         .optional()
         .describe("Return rendered HTML content and include front_matter (e.g., the custom title)"),
 })
@@ -2836,8 +2810,7 @@ export const ListWikiPagesSchema = z
 export const GetWikiPageSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     slug: z.string().describe("Slug of the wiki page (will be URL-encoded internally)"),
-    render_html: z.coerce
-        .boolean()
+    render_html: coerceBooleanString
         .optional()
         .describe("Return rendered HTML content and include front_matter (e.g., the custom title)"),
 });
@@ -2875,9 +2848,8 @@ export const GitLabWikiPageSchema = z.object({
 export const ListGroupWikiPagesSchema = z
     .object({
     group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
-    with_content: z.coerce.boolean().optional().describe("Include content of the wiki pages"),
-    render_html: z.coerce
-        .boolean()
+    with_content: coerceBooleanString.optional().describe("Include content of the wiki pages"),
+    render_html: coerceBooleanString
         .optional()
         .describe("Return rendered HTML content and include front_matter (e.g., the custom title)"),
 })
@@ -2885,8 +2857,7 @@ export const ListGroupWikiPagesSchema = z
 export const GetGroupWikiPageSchema = z.object({
     group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
     slug: z.string().describe("Slug of the wiki page (will be URL-encoded internally)"),
-    render_html: z.coerce
-        .boolean()
+    render_html: coerceBooleanString
         .optional()
         .describe("Return rendered HTML content and include front_matter (e.g., the custom title)"),
 });
@@ -3072,8 +3043,7 @@ export const CreateDraftNoteSchema = ProjectParamsSchema.extend({
         .optional()
         .describe("The ID of a discussion the draft note replies to"),
     position: optionalMergeRequestThreadPosition.describe("Position when creating a diff note"),
-    resolve_discussion: z.coerce
-        .boolean()
+    resolve_discussion: coerceBooleanString
         .optional()
         .describe("Whether to resolve the discussion when publishing"),
 });
@@ -3083,8 +3053,7 @@ export const UpdateDraftNoteSchema = ProjectParamsSchema.extend({
     draft_note_id: z.coerce.string().describe("The ID of the draft note"),
     body: z.string().optional().describe("The content of the draft note"),
     position: optionalMergeRequestThreadPosition.describe("Position when creating a diff note"),
-    resolve_discussion: z.coerce
-        .boolean()
+    resolve_discussion: coerceBooleanString
         .optional()
         .describe("Whether to resolve the discussion when publishing"),
 });
@@ -3109,8 +3078,7 @@ export const BulkPublishDraftNotesSchema = ProjectParamsSchema.extend({
         .string()
         .optional()
         .describe("Summary note body to post on the merge request (GitLab 19.2+)"),
-    internal: z.coerce
-        .boolean()
+    internal: coerceBooleanString
         .optional()
         .describe("If true, the summary note is internal (GitLab 19.2+, default false)"),
 });
@@ -3124,7 +3092,7 @@ export const CreateMergeRequestThreadSchema = ProjectParamsSchema.extend({
 export const ResolveMergeRequestThreadSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of a merge request"),
     discussion_id: z.coerce.string().describe("The ID of a thread"),
-    resolved: z.coerce.boolean().describe("Whether to resolve the thread"),
+    resolved: coerceBooleanString.describe("Whether to resolve the thread"),
 });
 // Milestone related schemas
 // Schema for listing project milestones
@@ -3145,7 +3113,7 @@ export const ListProjectMilestonesSchema = ProjectParamsSchema.extend({
         .string()
         .optional()
         .describe("Return only milestones with a title or description matching the provided string"),
-    include_ancestors: z.coerce.boolean().optional().describe("Include ancestor groups"),
+    include_ancestors: coerceBooleanString.optional().describe("Include ancestor groups"),
     updated_before: z
         .string()
         .optional()
@@ -3207,8 +3175,8 @@ export const ListGroupMilestonesSchema = z
         .string()
         .optional()
         .describe("Return only milestones with a title or description matching the provided string"),
-    include_ancestors: z.coerce.boolean().optional().describe("Include ancestor groups"),
-    include_descendants: z.coerce.boolean().optional().describe("Include descendant groups"),
+    include_ancestors: coerceBooleanString.optional().describe("Include ancestor groups"),
+    include_descendants: coerceBooleanString.optional().describe("Include descendant groups"),
     updated_before: z
         .string()
         .optional()
@@ -3261,18 +3229,15 @@ export const ListCommitsSchema = z.object({
         .describe("Only commits before or on this date are returned in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ"),
     path: z.string().optional().describe("The file path"),
     author: z.string().optional().describe("Search commits by commit author"),
-    all: z.coerce.boolean().optional().describe("Retrieve every commit from the repository"),
-    with_stats: z.coerce
-        .boolean()
+    all: coerceBooleanString.optional().describe("Retrieve every commit from the repository"),
+    with_stats: coerceBooleanString
         .optional()
         .describe("Stats about each commit are added to the response"),
-    first_parent: z.coerce
-        .boolean()
+    first_parent: coerceBooleanString
         .optional()
         .describe("Follow only the first parent commit upon seeing a merge commit"),
     order: z.enum(["default", "topo"]).optional().describe("List commits in order"),
-    trailers: z.coerce
-        .boolean()
+    trailers: coerceBooleanString
         .optional()
         .describe("Parse and include Git trailers for every commit"),
     page: z.coerce.number().optional().describe("Page number for pagination (default: 1)"),
@@ -3284,13 +3249,12 @@ export const ListCommitsSchema = z.object({
 export const GetCommitSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or complete URL-encoded path to project"),
     sha: z.string().describe("The commit hash or name of a repository branch or tag"),
-    stats: z.coerce.boolean().optional().describe("Include commit stats"),
+    stats: coerceBooleanString.optional().describe("Include commit stats"),
 });
 export const GetCommitDiffSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or complete URL-encoded path to project"),
     sha: z.string().describe("The commit hash or name of a repository branch or tag"),
-    full_diff: z.coerce
-        .boolean()
+    full_diff: coerceBooleanString
         .optional()
         .describe("Whether to return the full diff or only first page (default: false)"),
 });
@@ -3410,8 +3374,7 @@ export const ListProjectMembersSchema = z.object({
     query: z.string().optional().describe("Search for members by name or username"),
     user_ids: z.array(z.coerce.number()).optional().describe("Filter by user IDs"),
     skip_users: z.array(z.coerce.number()).optional().describe("User IDs to exclude"),
-    include_inheritance: z.coerce
-        .boolean()
+    include_inheritance: coerceBooleanString
         .optional()
         .describe("Include inherited members. Defaults to false."),
     per_page: z.coerce
@@ -3426,8 +3389,7 @@ export const ListGroupMembersSchema = z.object({
     query: z.string().optional().describe("Search for members by name or username"),
     user_ids: z.array(z.coerce.number()).optional().describe("Filter by user IDs"),
     skip_users: z.array(z.coerce.number()).optional().describe("User IDs to exclude"),
-    include_inheritance: z.coerce
-        .boolean()
+    include_inheritance: coerceBooleanString
         .optional()
         .describe("Include inherited members. Defaults to false."),
     per_page: z.coerce
@@ -3510,12 +3472,10 @@ export const ListGroupIterationsSchema = z
         .array(z.enum(["title", "cadence_title"]))
         .optional()
         .describe("Fields in which fuzzy search should be performed with the query given in the argument search. The available options are title and cadence_title. Default is [title]."),
-    include_ancestors: z.coerce
-        .boolean()
+    include_ancestors: coerceBooleanString
         .optional()
         .describe("Include iterations for group and its ancestors. Defaults to true."),
-    include_descendants: z.coerce
-        .boolean()
+    include_descendants: coerceBooleanString
         .optional()
         .describe("Include iterations for group and its descendants. Defaults to false."),
     updated_before: z
@@ -3716,8 +3676,7 @@ export const ListReleasesSchema = z
         .enum(["desc", "asc"])
         .optional()
         .describe("The direction of the order. Either desc (default) for descending order or asc for ascending order."),
-    include_html_description: z.coerce
-        .boolean()
+    include_html_description: coerceBooleanString
         .optional()
         .describe("If true, a response includes HTML rendered Markdown of the release description."),
 })
@@ -3725,8 +3684,7 @@ export const ListReleasesSchema = z
 export const GetReleaseSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     tag_name: z.string().describe("The Git tag the release is associated with"),
-    include_html_description: z.coerce
-        .boolean()
+    include_html_description: coerceBooleanString
         .optional()
         .describe("If true, a response includes HTML rendered Markdown of the release description."),
 });
@@ -3808,7 +3766,7 @@ export const ListJobArtifactsSchema = z.object({
         .string()
         .optional()
         .describe("Directory path within the artifacts archive (defaults to root)"),
-    recursive: z.coerce.boolean().optional().describe("Whether to list artifacts recursively"),
+    recursive: coerceBooleanString.optional().describe("Whether to list artifacts recursively"),
 });
 export const GitLabArtifactEntrySchema = z.object({
     name: z.string(),
@@ -4244,7 +4202,7 @@ export const CreateWorkItemSchema = z.object({
         .string()
         .optional()
         .describe("Iteration ID (e.g. 'gid://gitlab/Iteration/123' or numeric ID). Use list_group_iterations to find available iterations."),
-    confidential: z.coerce.boolean().optional().describe("Set confidentiality"),
+    confidential: coerceBooleanString.optional().describe("Set confidentiality"),
 });
 export const UpdateWorkItemSchema = WorkItemParamsSchema.extend({
     title: z.string().optional().describe("New title"),
@@ -4268,8 +4226,7 @@ export const UpdateWorkItemSchema = WorkItemParamsSchema.extend({
         .string()
         .optional()
         .describe("Project ID or path of the parent work item (defaults to same project as the work item)"),
-    remove_parent: z.coerce
-        .boolean()
+    remove_parent: coerceBooleanString
         .optional()
         .describe("Set to true to remove the parent from hierarchy"),
     children_to_add: z
@@ -4306,7 +4263,7 @@ export const UpdateWorkItemSchema = WorkItemParamsSchema.extend({
         .string()
         .optional()
         .describe("Iteration ID (e.g. 'gid://gitlab/Iteration/123' or numeric ID). Use list_group_iterations to find available iterations."),
-    confidential: z.coerce.boolean().optional().describe("Set confidentiality"),
+    confidential: coerceBooleanString.optional().describe("Set confidentiality"),
     linked_items_to_add: z
         .array(z.object({
         project_id: z.coerce
@@ -4390,10 +4347,7 @@ export const CreateWorkItemNoteSchema = z.object({
     project_id: NamespaceIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     body: z.string().describe("Note body (Markdown supported)"),
-    internal: z.coerce
-        .boolean()
-        .optional()
-        .default(false)
+    internal: coerceBooleanStringDefault(false)
         .describe("Create as internal/confidential note (only visible to project members)"),
     discussion_id: z
         .string()
@@ -4580,8 +4534,7 @@ export const ListWebhookEventsSchema = z
         .union([z.coerce.number(), z.string()])
         .optional()
         .describe("Filter by response status code (e.g. 200, 500) or category: successful, client_failure, server_failure"),
-    summary: z.coerce
-        .boolean()
+    summary: coerceBooleanString
         .optional()
         .describe("If true, return only summary fields (id, url, trigger, response_status, execution_duration) without full request/response payloads. Recommended for overview queries to avoid huge responses."),
     per_page: z.number().max(20).optional().default(20).describe("Number of events per page"),

package/build/tools/tool-descriptions.js

@@ -2,7 +2,7 @@ const TOOL_GUIDANCE = {
     merge_merge_request: "Use this only after checking the merge request approval, conflict, and pipeline state; use `approve_merge_request` to approve rather than merge. The operation changes repository state and may squash commits, schedule auto-merge, or delete the source branch, so it requires merge permission and returns GitLab's merge result or a mergeability error. Pass `sha` from `get_merge_request` (`sha` or `diff_refs.head_sha`); GitLab 19.2+ groups may reject merges without it.",
     approve_merge_request: "Use this to record an approval on an existing merge request; it does not merge the request or change its source branch. The operation changes review state, may require re-authentication or approval permission, and returns the updated approval result or a permission/state error.",
     unapprove_merge_request: "Use this to remove the current user's approval from an existing merge request; use `merge_merge_request` only when you intend to merge. The operation changes review state and requires approval permission, and GitLab returns the updated result or an error when the request or approval is unavailable.",
-    rebase_merge_request: "Use this when the source branch is behind its target branch; use `get_merge_request_conflicts` to inspect conflicts and `merge_merge_request` to merge. The operation rewrites the source branch history with a force push and requires permission to push to that branch. With `wait` true (default), it polls until the rebase ends and returns the merge request: GitLab reports a failed rebase in `merge_error`, but that field can also keep a message from an earlier attempt, so compare `sha` with its value before the rebase. If the rebase still runs after `timeout_seconds`, it returns a timeout error while GitLab continues the rebase. With `wait` false, it returns GitLab's enqueue response (`rebase_in_progress` true) at once. Set `skip_ci` to skip the CI pipeline for the rebased branch.",
+    rebase_merge_request: "Use this when the source branch is behind its target branch; use `get_merge_request_conflicts` to inspect conflicts and `merge_merge_request` to merge. The operation rewrites the source branch history with a force push and requires permission to push to that branch. With `wait` true (default), it polls until the rebase ends and returns the merge request plus `previous_sha` (its `sha` before the rebase) and `head_changed`. `head_changed: false` means that the head did not move; `merge_error` gives the reason when GitLab sends one. `merge_error` can keep a message from an earlier attempt, so it alone does not prove that this attempt failed. If the rebase still runs after `timeout_seconds`, it returns a timeout error while GitLab continues the rebase. With `wait` false, it returns GitLab's enqueue response (`rebase_in_progress` true) at once. Set `skip_ci` to skip the CI pipeline for the rebased branch.",
     get_merge_request_approval_state: "Use this to inspect approval rules and approvers before deciding whether a merge request can be merged; use `approve_merge_request` to change approval state. It is read-only and returns the approval-state response, while missing requests, unsupported GitLab versions, and permission failures are reported as errors.",
     get_merge_request_conflicts: "Use this to inspect merge conflicts before attempting `merge_merge_request`; it reports conflicts and does not resolve them. It is read-only, requires access to the project and merge request, and returns GitLab's conflict data or an error when the request cannot be evaluated.",
     list_merge_request_pipelines: "Use this to inspect pipelines associated with one merge request; use `list_pipelines` for project-wide pipeline filtering. It is read-only and paginated, requires project access, and returns pipeline records or GitLab errors for invalid identifiers, missing resources, or rate limits.",

package/build/utils/schema.js

@@ -1,4 +1,10 @@
 import { z } from "zod";
+// JSON Schema produced by toJSONSchema -> the Zod schema it came from.
+const zodSchemaByJsonSchema = new WeakMap();
+/**
+ * Returns the Zod schema a toJSONSchema() result was built from, if any.
+ */
+export const zodSchemaFor = (jsonSchema) => jsonSchema && typeof jsonSchema === "object" ? zodSchemaByJsonSchema.get(jsonSchema) : undefined;
 /**
  * Convert a Zod schema to JSON Schema, fixing nullable/optional fields
  * so they are not marked as required, and extracting required fields from the Zod schema.
@@ -154,5 +160,6 @@ export const toJSONSchema = (schema) => {
             }
         }
     }
+    zodSchemaByJsonSchema.set(fixedSchema, schema);
     return fixedSchema;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "mcpName": "io.github.zereight/gitlab-mcp",
   "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
   "keywords": [
@@ -69,6 +69,7 @@
     "lint:fix": "eslint . --fix",
     "release": "bash scripts/release.sh",
     "release:mcp-registry": "bash scripts/publish_mcp_registry.sh",
+    "pack:mcpb": "npm run build && bash scripts/pack-mcpb.sh",
     "format": "prettier --write \"**/*.{js,ts,json,md}\"",
     "format:check": "prettier --check \"**/*.{js,ts,json,md}\""
   },