@opsee/mcp-server 0.9.16 → 0.9.18

package/src/tools/cycles.ts

@@ -17,7 +17,7 @@ export function registerCycleTools(
   server.tool(
     "opsee_list_cycles",
     "List cycles/sprints in an Opsee project.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {
@@ -33,7 +33,7 @@ export function registerCycleTools(
   server.tool(
     "opsee_get_cycle",
     "Get details of a specific cycle/sprint by ID.",
-    { cycleId: z.number().describe("The cycle ID") },
+    { cycleId: z.number().int().min(1).describe("The cycle ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ cycleId }) => {
       try {
@@ -51,7 +51,7 @@ export function registerCycleTools(
     "opsee_create_cycle",
     "Create a new cycle/sprint in an Opsee project.",
     {
-      projectId: z.number().describe("The project ID"),
+      projectId: z.number().int().min(1).describe("The project ID"),
       name: z.string().describe("Cycle name"),
       startDate: z.string().describe("Start date (ISO 8601, e.g. 2026-03-25)"),
       endDate: z.string().describe("End date (ISO 8601, e.g. 2026-04-08)"),
@@ -88,7 +88,7 @@ export function registerCycleTools(
     "opsee_update_cycle",
     "Update a cycle's fields (patch semantics — only provided fields change). Fetches the current cycle first, merges your changes, sends the full update.",
     {
-      cycleId: z.number().describe("The cycle ID to update"),
+      cycleId: z.number().int().min(1).describe("The cycle ID to update"),
       name: z.string().optional().describe("New name"),
       goal: z.string().optional().describe("New goal"),
       startDate: z.string().optional().describe("New start date (ISO 8601)"),
@@ -134,8 +134,8 @@ export function registerCycleTools(
     "opsee_close_cycle",
     "Close a cycle (mark inactive) and optionally carry every remaining task forward to a target cycle. Composes a single bulk_move_to_cycle + EditCycle, so /tpm cycle close becomes one call instead of a loop. Pass createNextCycle:true with name/startDate/endDate to also create the next cycle and carry forward into it in the same call.",
     {
-      cycleId: z.number().describe("ID of the cycle to close"),
-      nextCycleId: z.number().optional().describe("Existing cycle to carry remaining tasks into. Mutually exclusive with createNextCycle."),
+      cycleId: z.number().int().min(1).describe("ID of the cycle to close"),
+      nextCycleId: z.number().int().min(1).optional().describe("Existing cycle to carry remaining tasks into. Mutually exclusive with createNextCycle."),
       createNextCycle: z.boolean().optional().describe("If true, create the next cycle in this project (requires name/startDate/endDate) and carry tasks into it"),
       nextCycleName: z.string().optional().describe("Name of the cycle to create when createNextCycle:true"),
       nextCycleStartDate: z.string().optional().describe("ISO 8601 start date when createNextCycle:true"),
@@ -233,7 +233,7 @@ export function registerCycleTools(
   server.tool(
     "opsee_get_active_cycle",
     "Return the currently-active cycle for a project, or 'No active cycle' if none.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {
@@ -253,7 +253,7 @@ export function registerCycleTools(
   server.tool(
     "opsee_delete_cycle",
     "Delete a cycle by ID. This is permanent. Tasks assigned to the cycle are not deleted, but their cycle reference is cleared.",
-    { cycleId: z.number().describe("The cycle ID") },
+    { cycleId: z.number().int().min(1).describe("The cycle ID") },
     { readOnlyHint: false, destructiveHint: true },
     async ({ cycleId }) => {
       try {

package/src/tools/docs.ts

@@ -28,7 +28,7 @@ export function registerDocTools(
   server.tool(
     "opsee_list_doc_spaces",
     "List documentation spaces in an Opsee project.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {
@@ -55,7 +55,7 @@ export function registerDocTools(
   server.tool(
     "opsee_list_doc_pages",
     "List documentation pages in a doc space.",
-    { docSpaceId: z.number().describe("The doc space ID") },
+    { docSpaceId: z.number().int().min(1).describe("The doc space ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ docSpaceId }) => {
       try {
@@ -82,7 +82,7 @@ export function registerDocTools(
   server.tool(
     "opsee_get_doc_page",
     "Read a documentation page's content by ID.",
-    { pageId: z.number().describe("The doc page ID") },
+    { pageId: z.number().int().min(1).describe("The doc page ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ pageId }) => {
       try {
@@ -101,10 +101,10 @@ export function registerDocTools(
     "opsee_create_doc_page",
     "Create a new documentation page in an Opsee project.",
     {
-      projectId: z.number().describe("The project ID"),
+      projectId: z.number().int().min(1).describe("The project ID"),
       title: z.string().describe("Page title"),
       content: z.string().describe("Page content (text or JSON)"),
-      parentPageId: z.number().optional().describe("Parent page ID for nested pages"),
+      parentPageId: z.number().int().min(1).optional().describe("Parent page ID for nested pages"),
     },
     { readOnlyHint: false, destructiveHint: false },
     async ({ projectId, title, content, parentPageId }) => {

package/src/tools/initiatives.ts

@@ -27,7 +27,7 @@ export function registerInitiativeTools(
     "opsee_list_initiatives",
     "List initiatives in an Opsee project. Pass `search` to find a specific initiative by keyword — it matches the title and summary, tokenized, and ranks the best match first (most-recently-updated breaks ties). Use this to resume work by name, e.g. for \"resume the auth-refactor initiative\" call with search: \"auth\". Without `search`, returns all initiatives, most recent first.",
     {
-      projectId: z.number().describe("The project ID"),
+      projectId: z.number().int().min(1).describe("The project ID"),
       search: z.string().optional().describe("Keyword to match against initiative title + summary (ranked); omit to list all by recency"),
     },
     { readOnlyHint: true, destructiveHint: false },
@@ -49,7 +49,7 @@ export function registerInitiativeTools(
   server.tool(
     "opsee_get_initiative",
     "Get details of a specific initiative by ID (title, status, summary, core idea). To pick up or resume WORK on it — the task tree, memory log, and PRs together — call opsee_get_initiative_context instead.",
-    { initiativeId: z.number().describe("The initiative ID") },
+    { initiativeId: z.number().int().min(1).describe("The initiative ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ initiativeId }) => {
       try {
@@ -67,12 +67,12 @@ export function registerInitiativeTools(
     "opsee_create_initiative",
     "Create a new initiative in an Opsee project. After creating, expand the plan in the core idea (the coreIdea field); when the plan is ready, propose a decomposition with opsee_decompose_initiative rather than creating tasks by hand.",
     {
-      projectId: z.number().describe("The project ID"),
+      projectId: z.number().int().min(1).describe("The project ID"),
       title: z.string().describe("Initiative title"),
       summary: z.string().optional().describe("Short summary of the initiative"),
       status: z.enum(INITIATIVE_STATUSES).optional().describe("Initiative status. Defaults to 'draft'"),
       anchorType: z.enum(ANCHOR_TYPES).optional().describe("Anchor type (none | task | milestone | cycle). Defaults to 'none'"),
-      anchorId: z.number().optional().describe("Anchor entity ID. Required when anchorType is not 'none'"),
+      anchorId: z.number().int().min(1).optional().describe("Anchor entity ID. Required when anchorType is not 'none'"),
       coreIdea: z.string().optional().describe("Core idea body (the initiative's primary description). Markdown is supported and recommended — headings (##), bullets (-), checklists, code fences, **bold**/*italic*/`code`/links all render as formatted blocks in the UI (same behavior as task descriptions). Written as-is; the UI parses the markdown on read and re-saves it as BlockNote JSON on the next manual edit."),
       coreIdeaContentType: z.string().optional().describe("Content type of coreIdea: 'text' (markdown — the default) or 'json' (BlockNote). Leave unset and just write markdown."),
     },
@@ -105,12 +105,12 @@ export function registerInitiativeTools(
     "opsee_update_initiative",
     "Update an initiative's fields. Fetches the current initiative first, then applies only the provided changes. Status lifecycle: draft → active (opsee_decompose_initiative flips this automatically) → completed when the work is done. For dropped work, set status to 'abandoned' WITH a reason (in the summary or a memory entry) rather than deleting — that preserves the shared brain.",
     {
-      initiativeId: z.number().describe("The initiative ID to update"),
+      initiativeId: z.number().int().min(1).describe("The initiative ID to update"),
       title: z.string().optional().describe("New title"),
       summary: z.string().optional().describe("New summary"),
       status: z.enum(INITIATIVE_STATUSES).optional().describe("New status"),
       anchorType: z.enum(ANCHOR_TYPES).optional().describe("New anchor type"),
-      anchorId: z.number().optional().describe("New anchor entity ID"),
+      anchorId: z.number().int().min(1).optional().describe("New anchor entity ID"),
       coreIdea: z.string().optional().describe("New core idea body. Markdown is supported and renders as formatted blocks in the UI (same as task descriptions)."),
       coreIdeaContentType: z.string().optional().describe("Content type for coreIdea: 'text' (markdown — default) or 'json' (BlockNote)."),
     },
@@ -146,7 +146,7 @@ export function registerInitiativeTools(
   server.tool(
     "opsee_delete_initiative",
     "Delete an initiative permanently. Prefer setting status to 'abandoned' (via opsee_update_initiative) with a reason — that preserves the initiative's memory/shared brain for later reference. Only hard-delete an initiative created in error.",
-    { initiativeId: z.number().describe("The initiative ID to delete") },
+    { initiativeId: z.number().int().min(1).describe("The initiative ID to delete") },
     { readOnlyHint: false, destructiveHint: true },
     async ({ initiativeId }) => {
       try {
@@ -163,8 +163,8 @@ export function registerInitiativeTools(
     "opsee_get_initiative_context",
     "Load an entire Initiative work session in one call: the core-idea doc body, the execution task tree with parallel slices (what can run concurrently vs sequentially), the append-only memory log, and rolled-up PRs. Call this FIRST when picking up or resuming work on an Initiative. The response ends with a working agreement: treat this context as the source of truth, log decisions/blockers/learnings as you go with opsee_add_initiative_memory, and call opsee_checkpoint when you finish a unit of work.",
     {
-      initiativeId: z.number().describe("The initiative ID"),
-      memoryLimit: z.number().optional().describe("Cap on memory entries returned (most recent first); 0 or omitted = service default"),
+      initiativeId: z.number().int().min(1).describe("The initiative ID"),
+      memoryLimit: z.number().int().min(0).optional().describe("Cap on memory entries returned (most recent first); 0 or omitted = service default"),
     },
     { readOnlyHint: true, destructiveHint: false },
     async ({ initiativeId, memoryLimit }) => {
@@ -192,7 +192,7 @@ export function registerInitiativeTools(
   server.tool(
     "opsee_get_initiative_graph",
     "Get the task dependency graph for an initiative, including parallel execution batches (slices). Use the slices to choose the next batch of tasks that can be worked concurrently. (opsee_get_initiative_context already includes this graph — call this only when you need the graph on its own.)",
-    { initiativeId: z.number().describe("The initiative ID") },
+    { initiativeId: z.number().int().min(1).describe("The initiative ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ initiativeId }) => {
       try {
@@ -210,15 +210,15 @@ export function registerInitiativeTools(
     "opsee_decompose_initiative",
     "Materialize a proposed breakdown as real Tasks under the Initiative. PROPOSE FIRST: present the proposed task tree (titles, structure, dependencies) to the human and get their approval BEFORE calling this — that approval is the \"confirm\" step. Nothing is created until you call it, so to let the human decline, simply don't call it. Calling it materializes the tasks onto the board in one atomic operation and moves a draft Initiative to active (the conclude→execute transition). Wire the tree with temporary `ref` ids: set `parentRef` to nest a subtask, and add `edges` (from_ref blocks to_ref) to express sequencing — tasks with no blocking edge between them become parallel slices. All-or-nothing: a bad ref rolls the whole thing back.",
     {
-      initiativeId: z.number().describe("The initiative ID"),
+      initiativeId: z.number().int().min(1).describe("The initiative ID"),
       tasks: z.array(z.object({
         ref: z.string().describe("Temporary reference ID used to wire edges and parent relationships"),
         title: z.string().describe("Task title"),
         description: z.string().optional().describe("Task description"),
         parentRef: z.string().optional().describe("Ref of the parent task (to nest this as a subtask)"),
-        taskTypeId: z.number().optional().describe("Task type ID"),
-        taskPriorityId: z.number().optional().describe("Task priority ID"),
-        boardColumnId: z.number().optional().describe("Board column ID (status)"),
+        taskTypeId: z.number().int().min(1).optional().describe("Task type ID"),
+        taskPriorityId: z.number().int().min(1).optional().describe("Task priority ID"),
+        boardColumnId: z.number().int().min(1).optional().describe("Board column ID (status)"),
       })).describe("Tasks to create under this initiative"),
       edges: z.array(z.object({
         fromRef: z.string().describe("Ref of the source task"),
@@ -281,16 +281,16 @@ export function registerInitiativeTools(
       "6. Call opsee_reconcile_initiative with dryRun:false to apply the approved plan.",
     ].join("\n"),
     {
-      initiativeId: z.number().describe("The initiative ID"),
+      initiativeId: z.number().int().min(1).describe("The initiative ID"),
       tasks: z.array(z.object({
         ref: z.string().describe("Temporary reference ID used to wire edges and parent relationships"),
         title: z.string().describe("Task title"),
         description: z.string().optional().describe("Task description"),
         parentRef: z.string().optional().describe("Ref of the parent task (to nest this as a subtask)"),
-        taskTypeId: z.number().optional().describe("Task type ID"),
-        taskPriorityId: z.number().optional().describe("Task priority ID"),
-        boardColumnId: z.number().optional().describe("Board column ID (status)"),
-        existingTaskId: z.number().optional().describe("Real task ID from the current Initiative — tag kept tasks with this value (obtained from opsee_get_initiative_context). Omit for new tasks."),
+        taskTypeId: z.number().int().min(1).optional().describe("Task type ID"),
+        taskPriorityId: z.number().int().min(1).optional().describe("Task priority ID"),
+        boardColumnId: z.number().int().min(1).optional().describe("Board column ID (status)"),
+        existingTaskId: z.number().int().min(1).optional().describe("Real task ID from the current Initiative — tag kept tasks with this value (obtained from opsee_get_initiative_context). Omit for new tasks."),
       })).describe("Proposed task tree — include kept tasks with existingTaskId, new tasks without"),
       edges: z.array(z.object({
         fromRef: z.string().describe("Ref of the source task"),
@@ -337,12 +337,12 @@ export function registerInitiativeTools(
     "opsee_add_initiative_memory",
     "Log a SINGLE decision, outcome, learning, blocker, or context entry to the Initiative's append-only memory the moment it happens — the as-you-go granular logger. Cite the source task or PR where relevant. For end-of-unit wrap-ups, use opsee_checkpoint instead.",
     {
-      initiativeId: z.number().describe("The initiative ID"),
+      initiativeId: z.number().int().min(1).describe("The initiative ID"),
       kind: z.enum(MEMORY_KINDS).describe("Entry kind: decision | outcome | learning | blocker | context"),
       body: z.string().describe("The memory entry body text"),
       contentType: z.string().optional().describe("Content type of body (e.g. 'text'). Defaults to 'text'"),
       sourceType: z.enum(MEMORY_SOURCE_TYPES).optional().describe("Source type: none | task | pull_request | doc | workflow. Defaults to 'none'"),
-      sourceId: z.number().optional().describe("ID of the source entity (task ID, PR ID, etc.)"),
+      sourceId: z.number().int().min(1).optional().describe("ID of the source entity (task ID, PR ID, etc.)"),
       sourceUrl: z.string().optional().describe("URL linking to the source"),
     },
     { readOnlyHint: false, destructiveHint: false },
@@ -373,10 +373,10 @@ export function registerInitiativeTools(
     "opsee_checkpoint",
     "End-of-unit wrap-up for an Initiative: records what a unit of work accomplished to the Initiative's memory and links what it touched. Call this when you finish a coherent chunk of work (a task, a PR, an investigation) — distinct from opsee_add_initiative_memory, which logs a single decision/blocker the moment it happens. Defaults the entry kind to 'outcome'.",
     {
-      initiativeId: z.number().describe("The initiative ID"),
+      initiativeId: z.number().int().min(1).describe("The initiative ID"),
       summary: z.string().describe("What this unit of work accomplished and what's next"),
       kind: z.enum(MEMORY_KINDS).optional().describe("Memory entry kind. Defaults to 'outcome'"),
-      taskId: z.number().optional().describe("The task this work advanced (links the entry to it)"),
+      taskId: z.number().int().min(1).optional().describe("The task this work advanced (links the entry to it)"),
       prUrl: z.string().optional().describe("The PR/MR this work produced (recorded as the entry's source URL)"),
     },
     { readOnlyHint: false, destructiveHint: false },
@@ -420,10 +420,10 @@ export function registerInitiativeTools(
     "opsee_list_initiative_memory",
     "List memory entries for an initiative (newest first). Optionally filter by kind, source type, or source ID.",
     {
-      initiativeId: z.number().describe("The initiative ID"),
+      initiativeId: z.number().int().min(1).describe("The initiative ID"),
       kinds: z.array(z.string()).optional().describe("Filter by entry kinds (decision | outcome | learning | blocker | context)"),
       sourceType: z.string().optional().describe("Filter by source type (none | task | pull_request | doc | workflow)"),
-      sourceId: z.number().optional().describe("Filter by source entity ID"),
+      sourceId: z.number().int().min(1).optional().describe("Filter by source entity ID"),
     },
     { readOnlyHint: true, destructiveHint: false },
     async ({ initiativeId, kinds, sourceType, sourceId }) => {

package/src/tools/labels.ts

@@ -17,9 +17,9 @@ export function registerLabelTools(
     "opsee_list_labels",
     "List labels defined in an Opsee project. Use opsee_list_task_labels for labels attached to a specific task.",
     {
-      projectId: z.number().describe("The project ID"),
-      page: z.number().optional().describe("Page number (default: 1)"),
-      pageSize: z.number().optional().describe("Items per page (default: 50)"),
+      projectId: z.number().int().min(1).describe("The project ID"),
+      page: z.number().int().min(1).optional().describe("Page number (default: 1)"),
+      pageSize: z.number().int().min(1).optional().describe("Items per page (default: 50)"),
     },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId, page, pageSize }) => {
@@ -59,7 +59,7 @@ export function registerLabelTools(
     "opsee_create_label",
     "Create a new label in an Opsee project.",
     {
-      projectId: z.number().describe("The project ID"),
+      projectId: z.number().int().min(1).describe("The project ID"),
       name: z.string().min(1).max(50).describe("Label name"),
       color: z.string().regex(/^#?[0-9a-fA-F]{6}$/).optional().describe("Hex color, e.g. #ffaa00 or ffaa00"),
       description: z.string().optional().describe("Label description"),
@@ -88,7 +88,7 @@ export function registerLabelTools(
     "opsee_update_label",
     "Update a label's fields (patch semantics - only provided fields are changed). Fetches the current label first, merges your changes, and sends the full update.",
     {
-      labelId: z.number().describe("The label ID to update"),
+      labelId: z.number().int().min(1).describe("The label ID to update"),
       name: z.string().min(1).max(50).optional().describe("New label name"),
       color: z.string().regex(/^#?[0-9a-fA-F]{6}$/).optional().describe("New hex color, e.g. #ffaa00 or ffaa00"),
       description: z.string().optional().describe("New description"),
@@ -120,7 +120,7 @@ export function registerLabelTools(
     "opsee_delete_label",
     "Delete a label permanently. Attached TaskLabel rows are not cleaned up automatically by this tool — backend behavior dictates whether cascade applies.",
     {
-      labelId: z.number().describe("The label ID to delete"),
+      labelId: z.number().int().min(1).describe("The label ID to delete"),
     },
     { readOnlyHint: false, destructiveHint: true },
     async ({ labelId }) => {
@@ -138,8 +138,8 @@ export function registerLabelTools(
     "opsee_attach_label_to_task",
     "Attach an existing label to a task. Returns the TaskLabel join-row ID needed for opsee_detach_label_from_task.",
     {
-      taskId: z.number().describe("The task ID"),
-      labelId: z.number().describe("The label ID to attach"),
+      taskId: z.number().int().min(1).describe("The task ID"),
+      labelId: z.number().int().min(1).describe("The label ID to attach"),
     },
     { readOnlyHint: false, destructiveHint: false },
     async ({ taskId, labelId }) => {
@@ -160,7 +160,7 @@ export function registerLabelTools(
     "opsee_detach_label_from_task",
     "Pass the TaskLabel join-row id (returned from opsee_list_task_labels), not the labelId. Proto DeleteTaskLabelRequest takes the join PK.",
     {
-      taskLabelId: z.number().describe("The TaskLabel join-row ID (from opsee_list_task_labels), not the label ID"),
+      taskLabelId: z.number().int().min(1).describe("The TaskLabel join-row ID (from opsee_list_task_labels), not the label ID"),
     },
     { readOnlyHint: false, destructiveHint: true },
     async ({ taskLabelId }) => {
@@ -178,9 +178,9 @@ export function registerLabelTools(
     "opsee_list_task_labels",
     "List labels attached to a specific task (returns TaskLabel join rows with embedded Label data).",
     {
-      taskId: z.number().describe("The task ID"),
-      page: z.number().optional().describe("Page number (default: 1)"),
-      pageSize: z.number().optional().describe("Items per page (default: 50)"),
+      taskId: z.number().int().min(1).describe("The task ID"),
+      page: z.number().int().min(1).optional().describe("Page number (default: 1)"),
+      pageSize: z.number().int().min(1).optional().describe("Items per page (default: 50)"),
     },
     { readOnlyHint: true, destructiveHint: false },
     async ({ taskId, page, pageSize }) => {

package/src/tools/milestones.ts

@@ -20,7 +20,7 @@ export function registerMilestoneTools(
   server.tool(
     "opsee_list_milestones",
     "List milestones in an Opsee project.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {
@@ -39,7 +39,7 @@ export function registerMilestoneTools(
   server.tool(
     "opsee_get_milestone",
     "Get details of a specific milestone by ID.",
-    { milestoneId: z.number().describe("The milestone ID") },
+    { milestoneId: z.number().int().min(1).describe("The milestone ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ milestoneId }) => {
       try {
@@ -57,7 +57,7 @@ export function registerMilestoneTools(
     "opsee_create_milestone",
     "Create a new milestone in an Opsee project.",
     {
-      projectId: z.number().describe("The project ID"),
+      projectId: z.number().int().min(1).describe("The project ID"),
       name: z.string().describe("Milestone name"),
       status: z.enum(MILESTONE_STATUSES).optional().describe("Milestone status. Defaults to 'not_started'"),
       description: z.string().optional().describe("Milestone description"),
@@ -91,7 +91,7 @@ export function registerMilestoneTools(
     "opsee_update_milestone",
     "Update a milestone's fields. Fetches the current milestone first, then applies only the provided changes.",
     {
-      milestoneId: z.number().describe("The milestone ID to update"),
+      milestoneId: z.number().int().min(1).describe("The milestone ID to update"),
       name: z.string().optional().describe("New name"),
       status: z.enum(MILESTONE_STATUSES).optional().describe("New status"),
       description: z.string().optional().describe("New description"),
@@ -128,7 +128,7 @@ export function registerMilestoneTools(
   server.tool(
     "opsee_list_milestone_tasks",
     "List tasks attached to a specific milestone.",
-    { milestoneId: z.number().describe("The milestone ID") },
+    { milestoneId: z.number().int().min(1).describe("The milestone ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ milestoneId }) => {
       try {
@@ -150,8 +150,8 @@ export function registerMilestoneTools(
     "opsee_attach_task_to_milestone",
     "Attach an existing task to a milestone.",
     {
-      milestoneId: z.number().describe("The milestone ID"),
-      taskId: z.number().describe("The task ID to attach"),
+      milestoneId: z.number().int().min(1).describe("The milestone ID"),
+      taskId: z.number().int().min(1).describe("The task ID to attach"),
     },
     { readOnlyHint: false, destructiveHint: false },
     async ({ milestoneId, taskId }) => {
@@ -173,7 +173,7 @@ export function registerMilestoneTools(
     "opsee_detach_task_from_milestone",
     "Detach a task from a milestone. Requires the MilestoneTask ID (not the task ID) — use opsee_list_milestone_tasks to find it.",
     {
-      milestoneTaskId: z.number().describe("The MilestoneTask ID (from opsee_list_milestone_tasks)"),
+      milestoneTaskId: z.number().int().min(1).describe("The MilestoneTask ID (from opsee_list_milestone_tasks)"),
     },
     { readOnlyHint: false, destructiveHint: true },
     async ({ milestoneTaskId }) => {

package/src/tools/notifications.ts

@@ -43,8 +43,8 @@ export function registerNotificationTools(
     "Inbox-style listing of the authenticated user's notifications, newest first. Common notification_type values: task_assigned, comment_added, mention, task_blocked_unblocked, ai_workflow_status_change. Pass unreadOnly:true to see just the inbox.",
     {
       unreadOnly: z.boolean().optional().describe("If true, only return notifications where is_read=false"),
-      page: z.number().optional().describe("Page number (default: 1)"),
-      pageSize: z.number().optional().describe("Items per page (default: 50)"),
+      page: z.number().int().min(1).optional().describe("Page number (default: 1)"),
+      pageSize: z.number().int().min(1).optional().describe("Items per page (default: 50)"),
     },
     { readOnlyHint: true, destructiveHint: false },
     async ({ unreadOnly, page, pageSize }) => {
@@ -78,7 +78,7 @@ export function registerNotificationTools(
     "opsee_mark_notification_read",
     "Mark a notification as read. Read-modify-write: fetches the current notification and re-issues EditNotification with is_read=true so other fields aren't clobbered.",
     {
-      notificationId: z.number().describe("The notification ID"),
+      notificationId: z.number().int().min(1).describe("The notification ID"),
     },
     { readOnlyHint: false, destructiveHint: false },
     async ({ notificationId }) => {

package/src/tools/projects.ts

@@ -26,7 +26,7 @@ export function registerProjectTools(
   server.tool(
     "opsee_get_project",
     "Get details of a specific Opsee project by ID.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {

package/src/tools/repositories.ts

@@ -10,7 +10,7 @@ export function registerRepositoryTools(
   server.tool(
     "opsee_list_repositories",
     "List connected VCS repositories (GitHub/GitLab) for an Opsee project.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {

package/src/tools/task-dependencies.ts

@@ -26,8 +26,8 @@ export function registerTaskDependencyTools(
     "opsee_create_task_dependency",
     "Create a dependency relationship between two tasks. Use BLOCKS when the from-task must be completed before the to-task. Use BLOCKED_BY for the inverse. Use DUPLICATES when tasks are duplicates. Use RELATES_TO for a general association.",
     {
-      fromTaskId: z.number().describe("The ID of the source task"),
-      toTaskId: z.number().describe("The ID of the target task"),
+      fromTaskId: z.number().int().min(1).describe("The ID of the source task"),
+      toTaskId: z.number().int().min(1).describe("The ID of the target task"),
       type: dependencyTypeSchema.describe("Dependency type: BLOCKS, BLOCKED_BY, DUPLICATES, or RELATES_TO"),
     },
     { readOnlyHint: false, destructiveHint: false },
@@ -57,9 +57,9 @@ export function registerTaskDependencyTools(
     "opsee_list_task_dependencies",
     "List all dependencies for a task — returns both outgoing (task blocks others) and incoming (task is blocked by others) relationships.",
     {
-      taskId: z.number().describe("The task ID"),
-      page: z.number().optional().describe("Page number (default: 1)"),
-      pageSize: z.number().optional().describe("Items per page (default: 50)"),
+      taskId: z.number().int().min(1).describe("The task ID"),
+      page: z.number().int().min(1).optional().describe("Page number (default: 1)"),
+      pageSize: z.number().int().min(1).optional().describe("Items per page (default: 50)"),
     },
     { readOnlyHint: true, destructiveHint: false },
     async ({ taskId, page, pageSize }) => {
@@ -81,7 +81,7 @@ export function registerTaskDependencyTools(
   server.tool(
     "opsee_delete_task_dependency",
     "Delete a task dependency by its ID. This is permanent.",
-    { dependencyId: z.number().describe("The task dependency ID") },
+    { dependencyId: z.number().int().min(1).describe("The task dependency ID") },
     { readOnlyHint: false, destructiveHint: true },
     async ({ dependencyId }) => {
       try {
@@ -98,7 +98,7 @@ export function registerTaskDependencyTools(
     "opsee_get_dependency_chain",
     "Server-side BFS over the BLOCKS/BLOCKED_BY graph from a task. Returns the reachable tasks and the edges that connect them. Use direction='blocks' for downstream (what does this task unblock), 'blocked_by' for upstream (what is this task waiting on), 'both' for the full neighborhood. Depth caps at 10.",
     {
-      taskId: z.number().describe("The starting task ID"),
+      taskId: z.number().int().min(1).describe("The starting task ID"),
       direction: z.enum(["blocks", "blocked_by", "both"]).optional().describe("Direction to walk (default: both)"),
       depth: z.number().int().min(1).max(10).optional().describe("Max hops from the source (default: 5, capped at 10)"),
     },

package/src/tools/task-metadata.ts

@@ -10,7 +10,7 @@ export function registerTaskMetadataTools(
   server.tool(
     "opsee_list_task_types",
     "Get available task types (Bug, Feature, etc.) for an Opsee project. Use these IDs when creating or updating tasks.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {
@@ -32,7 +32,7 @@ export function registerTaskMetadataTools(
   server.tool(
     "opsee_list_task_priorities",
     "Get priority levels (Critical, High, Medium, Low, etc.) for an Opsee project. Use these IDs when creating or updating tasks.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {
@@ -54,7 +54,7 @@ export function registerTaskMetadataTools(
   server.tool(
     "opsee_list_boards",
     "List Kanban boards for an Opsee project. Use the board ID to list board columns.",
-    { projectId: z.number().describe("The project ID") },
+    { projectId: z.number().int().min(1).describe("The project ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ projectId }) => {
       try {
@@ -76,7 +76,7 @@ export function registerTaskMetadataTools(
   server.tool(
     "opsee_list_board_columns",
     "Get board columns/statuses (To Do, In Progress, Done, etc.) for a board. Use these IDs when creating or updating tasks.",
-    { boardId: z.number().describe("The board ID") },
+    { boardId: z.number().int().min(1).describe("The board ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ boardId }) => {
       try {