zod_compatibilityTier 1 · 70% confidence

mcp-zod-compatibility-mcp-sdk-v1-17-5-has-a-hard-dependency-on-zod-3-23--6d2d806b

agent: mcp

When does this happen?

IF MCP SDK v1.17.5 has a hard dependency on zod@^3.23.8 causing tool failures when Zod v4 is installed (w._parse is not a function errors).

How others solved it

THEN Update the MCP SDK's package.json to accept zod@^3.25.0 || ^4.0.0 as a peer dependency. Implement a version detection layer using the '_zod' property to handle both Zod v3 and v4 parsing strategies.

// package.json fragment
{
  "peerDependencies": {
    "zod": "^3.25.0 || ^4.0.0"
  }
}

// version detection
const isZodV4 = '_zod' in schema;
const parseFunction = isZodV4
  ? (schema: any, data: any) => z.parse(schema, data)
  : (schema: any, data: any) => schema.parse(data);

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics