Skip to content

feat: zod v4 with backwards compatibility for v3.25+ #1040

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
felixweinberger merged 15 commits into from
Nov 19, 2025
Merged

feat: zod v4 with backwards compatibility for v3.25+ #1040

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
205d379
chore: fix merge conflicts with latest
dclark27 Nov 17, 2025
6669217
chore: use zod v4 methods for types and auth
dclark27 Nov 17, 2025
b89200a
chore: use RemovePassthrough on remaining spec params
dclark27 Nov 17, 2025
1e0b11e
chore: resolve remaining as any casts
dclark27 Nov 17, 2025
3f69eae
chore: attempt to address node 18 test failure
dclark27 Nov 17, 2025
4e79d6f
chore: remove plans
dclark27 Nov 17, 2025
dcfcca8
chore: consolidate multiple ZodV4Internal and ZodV3Internal defs
dclark27 Nov 17, 2025
e3b7027
chore: formatting
dclark27 Nov 17, 2025
6e4cfa2
chore: remove _vendor zod-to-json-schema
dclark27 Nov 18, 2025
7cfa855
Merge branch 'main' into feature/zod-v3-compat
dclark27 Nov 18, 2025
2e02c25
chore: remove cast
dclark27 Nov 18, 2025
2cef25b
chore: bring in new tests from recent merge
dclark27 Nov 18, 2025
ac7d541
chore: clean up extra function and types in compat layer
dclark27 Nov 18, 2025
76725b6
Merge remote-tracking branch 'upstream' into feature/zod-v3-compat
dclark27 Nov 19, 2025
86b51fd
chore: run prettier
dclark27 Nov 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Let's create a simple MCP server that exposes a calculator tool and some data. S
import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
Copy link
Contributor

@felixweinberger felixweinberger Nov 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should call out the peerDependency status on the README somewhere and that v3 and v4 are both supported. We can do that in a follow-up though.

import * as z from 'zod/v4';

// Create an MCP server
const server = new McpServer({
Expand Down Expand Up @@ -477,7 +477,7 @@ MCP servers can request LLM completions from connected clients that support samp
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
import * as z from 'zod/v4';

const mcpServer = new McpServer({
name: 'tools-with-sample-server',
Expand Down Expand Up @@ -561,7 +561,7 @@ For most use cases where session management isn't needed:
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
import * as z from 'zod/v4';

const app = express();
app.use(express.json());
Expand Down Expand Up @@ -796,7 +796,7 @@ A simple server demonstrating resources, tools, and prompts:

```typescript
import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';
import * as z from 'zod/v4';

const server = new McpServer({
name: 'echo-server',
Expand Down Expand Up @@ -866,7 +866,7 @@ A more complex example showing database integration:
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import sqlite3 from 'sqlite3';
import { promisify } from 'util';
import { z } from 'zod';
import * as z from 'zod/v4';

const server = new McpServer({
name: 'sqlite-explorer',
Expand Down Expand Up @@ -961,7 +961,7 @@ If you want to offer an initial set of tools/prompts/resources, but later add ad
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
import * as z from 'zod/v4';

const server = new McpServer({
name: 'Dynamic Example',
Expand Down
Loading
Loading