@zereight/mcp-gitlab 2.3.0 → 2.3.1

package/README.ko.md

@@ -138,7 +138,7 @@ 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.0`처럼 직전 안정 버전(문서가 권장하는 버전)으로 고정하세요. 항상 최신 버전을 원하면 `npx -y @zereight/mcp-gitlab@latest`를 사용하세요. 새 버전이 나오면 서버가 시작 시 stderr로 알려줍니다(`GITLAB_DISABLE_VERSION_CHECK=true`로 비활성화 가능).
 
 #### CLI 인자 사용하기(환경 변수 문제가 있는 클라이언트용)
 

package/README.md

@@ -143,7 +143,7 @@ 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.0`. 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`).
 
 #### Using CLI Arguments (for clients with env var issues)
 

package/README.pt-BR.md

@@ -138,7 +138,7 @@ 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.0`. 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`).
 
 #### Usando argumentos de CLI (para clientes com problemas com variáveis de ambiente)
 

package/README.zh-CN.md

@@ -138,7 +138,7 @@ 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.0`。如果始终想使用最新版本，请改用 `npx -y @zereight/mcp-gitlab@latest`。有新版本发布时，服务器会在启动时通过 stderr 提示（可用 `GITLAB_DISABLE_VERSION_CHECK=true` 关闭）。
 
 #### 使用 CLI 参数（适用于环境变量有问题的客户端）
 

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "mcpName": "io.github.zereight/gitlab-mcp",
   "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
   "keywords": [