@zereight/mcp-gitlab 2.2.6 → 2.3.1

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
@@ -2253,6 +2243,30 @@ export const ApproveMergeRequestSchema = ProjectParamsSchema.extend({
 export const UnapproveMergeRequestSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of the merge request to unapprove"),
 });
+export const RebaseMergeRequestSchema = ProjectParamsSchema.extend({
+    merge_request_iid: z.coerce.string().describe("The IID of the merge request to rebase"),
+    skip_ci: coerceBooleanString
+        .optional()
+        .describe("If true, GitLab does not create a CI pipeline for the rebased source branch"),
+    wait: coerceBooleanString
+        .optional()
+        .default(true)
+        .describe("If true, poll the merge request until the rebase ends or timeout_seconds passes. If false, return GitLab's enqueue response at once."),
+    timeout_seconds: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(600)
+        .optional()
+        .describe("Maximum seconds to wait for the rebase to end"),
+    poll_interval_seconds: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .optional()
+        .describe("Seconds between status polls while waiting for the rebase"),
+});
 // Merge Request Approval State response schema
 export const GitLabApprovalUserSchema = z.object({
     id: z.coerce.string(),
@@ -2340,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."),
 });
@@ -2356,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."),
 });
@@ -2367,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."),
 });
@@ -2403,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"),
@@ -2428,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"),
 })
@@ -2522,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"),
 })
@@ -2554,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"),
@@ -2582,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)"),
 });
@@ -2629,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({
@@ -2689,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()
@@ -2712,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"),
@@ -2728,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"),
@@ -2769,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);
@@ -2802,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)"),
 })
@@ -2812,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)"),
 });
@@ -2851,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)"),
 })
@@ -2861,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)"),
 });
@@ -3048,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"),
 });
@@ -3059,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"),
 });
@@ -3085,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)"),
 });
@@ -3100,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
@@ -3121,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()
@@ -3183,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()
@@ -3237,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)"),
@@ -3260,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)"),
 });
@@ -3386,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
@@ -3402,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
@@ -3450,7 +3436,7 @@ export const DownloadAttachmentSchema = z.object({
     local_path: z
         .string()
         .optional()
-        .describe("Local path to save the file (optional, defaults to current directory)"),
+        .describe("Subdirectory of the download directory to save the file in (optional, defaults to the download directory itself). Names starting with a dot are rejected"),
 });
 export const DownloadAttachmentRemoteSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path of the project"),
@@ -3486,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
@@ -3692,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."),
 })
@@ -3701,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."),
 });
@@ -3784,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(),
@@ -4220,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"),
@@ -4244,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
@@ -4282,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
@@ -4366,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()
@@ -4556,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"),