fix: temporary fix, revert zod schema definitions for mcp tools to zod v3 (#1323)

.changeset/kind-lines-melt.md

@@ -0,0 +1,21 @@
+---
+"task-master-ai": patch
+---
+
+Fix MCP server compatibility with Draft-07 clients (Augment IDE, gemini-cli, gemini code assist)
+
+- Resolves #1284
+
+**Problem:**
+
+- MCP tools were using Zod v4, which outputs JSON Schema Draft 2020-12
+- MCP clients only support Draft-07
+- Tools were not discoverable in gemini-cli and other clients
+
+**Solution:**
+
+- Updated all MCP tools to import from `zod/v3` instead of `zod`
+- Zod v3 schemas convert to Draft-07 via FastMCP's zod-to-json-schema
+- Fixed logger to use stderr instead of stdout (MCP protocol requirement)
+
+This is a temporary workaround until FastMCP adds JSON Schema version configuration.

.coderabbit.yaml

@@ -1,3 +1,7 @@
 reviews:
   profile: chill
   poem: false
+  auto_review:
+    enabled: true
+    base_branches:
+      - ".*"

apps/mcp/src/tools/README-ZOD-V3.md

@@ -0,0 +1,70 @@
+# Why MCP Tools Use Zod v3
+
+## Problem
+
+- **FastMCP** uses `xsschema` to convert schemas → outputs JSON Schema **Draft 2020-12**
+- **MCP clients** (Augment IDE, gemini-cli, etc.) only support **Draft-07**
+- Using Zod v4 in tools causes "vendor undefined" errors and tool discovery failures
+
+## Temporary Solution
+
+All MCP tool files import from `zod/v3` instead of `zod`:
+
+```typescript
+import { z } from 'zod/v3';  // ✅ Draft-07 compatible
+// NOT: import { z } from 'zod';  // ❌ Would use Draft 2020-12
+```
+
+### Why This Works
+
+- Zod v4 ships with v3 compatibility at `zod/v3`
+- FastMCP + zod-to-json-schema converts Zod v3 schemas → **Draft-07**
+- This ensures MCP clients can discover and use our tools
+
+### What This Means
+
+- ✅ **MCP tools** → use `zod/v3` (apps/mcp & mcp-server/src/tools)
+- ✅ **Rest of codebase** → uses `zod` (Zod v4)
+- ✅ **No conflicts** → they're from the same package, just different versions
+
+## When Can We Remove This?
+
+This workaround can be removed when **either**:
+
+1. **FastMCP adds JSON Schema version configuration**
+   - e.g., `new FastMCP({ jsonSchema: { target: 'draft-07' } })`
+   - Tracking: https://github.com/punkpeye/fastmcp/issues/189
+
+2. **MCP spec adds Draft 2020-12 support**
+   - Unlikely in the short term
+
+3. **xsschema adds version targeting**
+   - Would allow FastMCP to use Draft-07
+
+## How to Maintain
+
+When adding new MCP tools:
+
+```typescript
+// ✅ CORRECT
+import { z } from 'zod/v3';
+
+export function registerMyTool(server: FastMCP) {
+  server.addTool({
+    name: 'my_tool',
+    parameters: z.object({ ... }),  // Will use Draft-07
+    execute: async (args, context) => { ... }
+  });
+}
+```
+
+```typescript
+// ❌ WRONG - Will break MCP client compatibility
+import { z } from 'zod';  // Don't do this in apps/mcp/src/tools/
+```
+
+---
+
+**Last Updated:** 2025-10-18
+**Affects:** All files in `apps/mcp/src/tools/`
+**See Also:** `mcp-server/src/tools/README-ZOD-V3.md` (same workaround)

apps/mcp/src/tools/autopilot/abort.tool.ts

@@ -3,7 +3,9 @@
  * Abort a running TDD workflow and clean up state
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

apps/mcp/src/tools/autopilot/commit.tool.ts

@@ -3,7 +3,9 @@
  * Create a git commit with automatic staging and message generation
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

apps/mcp/src/tools/autopilot/complete.tool.ts

@@ -3,7 +3,9 @@
  * Complete the current TDD phase with test result validation
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

apps/mcp/src/tools/autopilot/finalize.tool.ts

@@ -3,7 +3,9 @@
  * Finalize and complete the workflow with working tree validation
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

apps/mcp/src/tools/autopilot/next.tool.ts

@@ -3,7 +3,9 @@
  * Get the next action to perform in the TDD workflow
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

apps/mcp/src/tools/autopilot/resume.tool.ts

@@ -3,7 +3,9 @@
  * Resume a previously started TDD workflow from saved state
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

apps/mcp/src/tools/autopilot/start.tool.ts

@@ -3,7 +3,9 @@
  * Initialize and start a new TDD workflow for a task
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

apps/mcp/src/tools/autopilot/status.tool.ts

@@ -3,7 +3,9 @@
  * Get comprehensive workflow status and progress information
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot

mcp-server/src/logger.js

@@ -78,7 +78,7 @@ function log(level, ...args) {
 		// is responsible for directing logs correctly (e.g., to stderr)
 		// during tool execution without upsetting the client connection.
 		// Logs outside of tool execution (like startup) will go to stdout.
-		console.log(prefix, ...coloredArgs);
+		console.error(prefix, ...coloredArgs);
 	}
 }
 

mcp-server/src/tools/README-ZOD-V3.md

@@ -0,0 +1,67 @@
+# Why MCP Tools Use Zod v3
+
+## Problem
+
+- **FastMCP** uses `xsschema` to convert schemas → outputs JSON Schema **Draft 2020-12**
+- **MCP clients** (Augment IDE, gemini-cli, etc.) only support **Draft-07**
+- Using Zod v4 in tools causes "vendor undefined" errors and tool discovery failures
+
+## Temporary Solution
+
+All MCP tool files import from `zod/v3` instead of `zod`:
+
+```javascript
+import { z } from 'zod/v3';  // ✅ Draft-07 compatible
+// NOT: import { z } from 'zod';  // ❌ Would use Draft 2020-12
+```
+
+### Why This Works
+
+- Zod v4 ships with v3 compatibility at `zod/v3`
+- FastMCP + zod-to-json-schema converts Zod v3 schemas → **Draft-07**
+- This ensures MCP clients can discover and use our tools
+
+### What This Means
+
+- ✅ **MCP tools** → use `zod/v3` (this directory)
+- ✅ **Rest of codebase** → uses `zod` (Zod v4)
+- ✅ **No conflicts** → they're from the same package, just different versions
+
+## When Can We Remove This?
+
+This workaround can be removed when **either**:
+
+1. **FastMCP adds JSON Schema version configuration**
+   - e.g., `new FastMCP({ jsonSchema: { target: 'draft-07' } })`
+   - Tracking: https://github.com/punkpeye/fastmcp/issues/189
+
+2. **MCP spec adds Draft 2020-12 support**
+   - Unlikely in the short term
+
+3. **xsschema adds version targeting**
+   - Would allow FastMCP to use Draft-07
+
+## How to Maintain
+
+When adding new MCP tools:
+
+```javascript
+// ✅ CORRECT
+import { z } from 'zod/v3';
+
+server.addTool({
+  name: 'my_tool',
+  parameters: z.object({ ... }),  // Will use Draft-07
+  execute: async (args) => { ... }
+});
+```
+
+```javascript
+// ❌ WRONG - Will break MCP client compatibility
+import { z } from 'zod';  // Don't do this in mcp-server/src/tools/
+```
+
+---
+
+**Last Updated:** 2025-10-18
+**Affects:** All files in `mcp-server/src/tools/`

mcp-server/src/tools/add-dependency.js

@@ -3,7 +3,9 @@
  * Tool for adding a dependency to a task
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/add-subtask.js

@@ -3,7 +3,9 @@
  * Tool for adding subtasks to existing tasks
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/add-tag.js

@@ -3,7 +3,9 @@
  * Tool to create a new tag
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/add-task.js

@@ -3,7 +3,9 @@
  * Tool to add a new task using AI
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/analyze.js

@@ -3,7 +3,9 @@
  * Tool for analyzing task complexity and generating recommendations
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import path from 'path';
 import fs from 'fs'; // Import fs for directory check/creation
 import {

mcp-server/src/tools/clear-subtasks.js

@@ -3,7 +3,9 @@
  * Tool for clearing subtasks from parent tasks
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/complexity-report.js

@@ -3,7 +3,9 @@
  * Tool for displaying the complexity analysis report
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/copy-tag.js

@@ -3,7 +3,9 @@
  * Tool to copy an existing tag to a new tag
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/delete-tag.js

@@ -3,7 +3,9 @@
  * Tool to delete an existing tag
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/expand-all.js

@@ -3,7 +3,9 @@
  * Tool for expanding all pending tasks with subtasks
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/expand-task.js

@@ -3,7 +3,9 @@
  * Tool to expand a task into subtasks
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/fix-dependencies.js

@@ -3,7 +3,9 @@
  * Tool for automatically fixing invalid task dependencies
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/generate.js

@@ -3,7 +3,9 @@
  * Tool to generate individual task files from tasks.json
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/get-operation-status.js

@@ -1,5 +1,7 @@
 // mcp-server/src/tools/get-operation-status.js
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import { createErrorResponse, createContentResponse } from './utils.js'; // Assuming these utils exist
 
 /**

mcp-server/src/tools/get-task.js

@@ -3,7 +3,9 @@
  * Tool to get task details by ID
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/get-tasks.js

@@ -3,7 +3,9 @@
  * Tool to get all tasks from Task Master
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/initialize-project.js

@@ -1,4 +1,6 @@
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/list-tags.js

@@ -3,7 +3,9 @@
  * Tool to list all available tags
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/models.js

@@ -3,7 +3,9 @@
  * MCP tool for managing AI model configurations
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/move-task.js

@@ -3,7 +3,9 @@
  * Tool for moving tasks or subtasks to a new position
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/next-task.js

@@ -3,7 +3,9 @@
  * Tool to find the next task to work on based on dependencies and status
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/parse-prd.js

@@ -3,7 +3,9 @@
  * Tool to parse PRD document and generate tasks
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	withNormalizedProjectRoot,

mcp-server/src/tools/remove-dependency.js

@@ -3,7 +3,9 @@
  * Tool for removing a dependency from a task
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/remove-subtask.js

@@ -3,7 +3,9 @@
  * Tool for removing subtasks from parent tasks
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/remove-task.js

@@ -3,7 +3,9 @@
  * Tool to remove a task by ID
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/rename-tag.js

@@ -3,7 +3,9 @@
  * Tool to rename an existing tag
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/research.js

@@ -3,7 +3,9 @@
  * Tool to perform AI-powered research queries with project context
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/response-language.js

@@ -1,4 +1,6 @@
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/rules.js

@@ -3,7 +3,9 @@
  * Tool to add or remove rules from a project (MCP server)
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/scope-down.js

@@ -3,7 +3,9 @@
  * Tool to scope down task complexity
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/scope-up.js

@@ -3,7 +3,9 @@
  * Tool to scope up task complexity
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/set-task-status.js

@@ -3,7 +3,9 @@
  * Tool to set the status of a task
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/update-subtask.js

@@ -3,7 +3,9 @@
  * Tool to append additional information to a specific subtask
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/update-task.js

@@ -3,7 +3,9 @@
  * Tool to update a single task by ID with new information
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/update.js

@@ -3,7 +3,9 @@
  * Tool to update tasks based on new context/prompt
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,

mcp-server/src/tools/use-tag.js

@@ -3,7 +3,9 @@
  * Tool to switch to a different tag context
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	createErrorResponse,
 	handleApiResult,

mcp-server/src/tools/validate-dependencies.js

@@ -3,7 +3,9 @@
  * Tool for validating task dependencies
  */
 
-import { z } from 'zod';
+// TEMPORARY: Using zod/v3 for Draft-07 JSON Schema compatibility with FastMCP's zod-to-json-schema
+// TODO: Revert to 'zod' when MCP spec issue is resolved (see PR #1323)
+import { z } from 'zod/v3';
 import {
 	handleApiResult,
 	createErrorResponse,