feat(compat): add @modelcontextprotocol/server/zod-schemas subpath

Re-exports the internal *Schema Zod constants (CallToolRequestSchema,
JSONRPCMessageSchema, etc.) from a deprecated /zod-schemas subpath so v1
code that imported schemas from @modelcontextprotocol/sdk/types.js has a
single drop-in target.

- packages/server/src/zodSchemas.ts: re-export barrel (deprecated module)
- packages/server/package.json: ./zod-schemas exports entry
- packages/server/tsdown.config.ts: build entry + dts path mapping
- packages/server/tsconfig.json: path mappings for core/schemas and the
  self-reference subpath
- packages/core/package.json: internal ./schemas subpath (core is private,
  consumed only by sibling packages)
- compat test asserting the import resolves and schemas parse

The schemas remain an internal implementation detail; their Zod major
version is not covered by semver. Subpath will be removed in v3.

Author: felixweinberger

.changeset/compat-zod-schemas-subpath.md

@@ -0,0 +1,7 @@
+---
+'@modelcontextprotocol/server': patch
+---
+
+Add deprecated `@modelcontextprotocol/server/zod-schemas` subpath for v1 compatibility
+
+Re-exports the internal `*Schema` Zod constants (e.g. `CallToolRequestSchema`, `JSONRPCMessageSchema`) so v1 code that imported them from `@modelcontextprotocol/sdk/types.js` can be pointed at a single subpath. These schemas remain an internal implementation detail; their Zod major version is not covered by semver. The subpath will be removed in v3.

packages/core/package.json

@@ -32,6 +32,10 @@
         "./public": {
             "types": "./src/exports/public/index.ts",
             "import": "./src/exports/public/index.ts"
+        },
+        "./schemas": {
+            "types": "./src/types/schemas.ts",
+            "import": "./src/types/schemas.ts"
         }
     },
     "scripts": {

packages/server/package.json

@@ -24,6 +24,10 @@
             "types": "./dist/index.d.mts",
             "import": "./dist/index.mjs"
         },
+        "./zod-schemas": {
+            "types": "./dist/zodSchemas.d.mts",
+            "import": "./dist/zodSchemas.mjs"
+        },
         "./validators/cf-worker": {
             "types": "./dist/validators/cfWorker.d.mts",
             "import": "./dist/validators/cfWorker.mjs"

packages/server/src/zodSchemas.ts

@@ -0,0 +1,28 @@
+/**
+ * @deprecated These Zod schema constants are exported for v1 source compatibility
+ * only. They are an internal implementation detail and their Zod major version is
+ * NOT covered by semver. For runtime validation of spec types, use
+ * {@linkcode specTypeSchema} / {@linkcode isSpecType} from the main entry instead.
+ * This subpath will be removed in v3.
+ */
+export {
+    IdJagTokenExchangeResponseSchema,
+    OAuthClientInformationFullSchema,
+    OAuthClientInformationSchema,
+    OAuthClientMetadataSchema,
+    OAuthClientRegistrationErrorSchema,
+    OAuthErrorResponseSchema,
+    OAuthMetadataSchema,
+    OAuthProtectedResourceMetadataSchema,
+    OAuthTokenRevocationRequestSchema,
+    OAuthTokensSchema,
+    OpenIdProviderDiscoveryMetadataSchema,
+    OpenIdProviderMetadataSchema,
+    OptionalSafeUrlSchema,
+    SafeUrlSchema
+} from '@modelcontextprotocol/core';
+export * from '@modelcontextprotocol/core/schemas';
+export {
+    /** @deprecated Use {@linkcode JSONRPCErrorResponseSchema}. Removed in v3. */
+    JSONRPCErrorResponseSchema as JSONRPCErrorSchema
+} from '@modelcontextprotocol/core/schemas';

packages/server/test/zod-schemas.compat.test.ts

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+
+// Compat: the deprecated `/zod-schemas` subpath re-exports the internal Zod
+// schema constants for v1 source compatibility. This test asserts the import
+// resolves and the values are usable Zod schemas at runtime.
+import { CallToolRequestSchema, JSONRPCMessageSchema, ListToolsResultSchema } from '@modelcontextprotocol/server/zod-schemas';
+
+describe('@modelcontextprotocol/server/zod-schemas (compat subpath)', () => {
+    it('re-exports Zod schema constants from core', () => {
+        expect(CallToolRequestSchema).toBeInstanceOf(z.ZodType);
+        expect(JSONRPCMessageSchema).toBeInstanceOf(z.ZodType);
+        expect(ListToolsResultSchema).toBeInstanceOf(z.ZodType);
+    });
+
+    it('schemas parse valid spec values', () => {
+        const parsed = CallToolRequestSchema.parse({
+            method: 'tools/call',
+            params: { name: 'echo', arguments: {} }
+        });
+        expect(parsed.method).toBe('tools/call');
+        expect(parsed.params.name).toBe('echo');
+    });
+});

packages/server/tsconfig.json

@@ -7,8 +7,10 @@
             "*": ["./*"],
             "@modelcontextprotocol/core": ["./node_modules/@modelcontextprotocol/core/src/index.ts"],
             "@modelcontextprotocol/core/public": ["./node_modules/@modelcontextprotocol/core/src/exports/public/index.ts"],
+            "@modelcontextprotocol/core/schemas": ["./node_modules/@modelcontextprotocol/core/src/types/schemas.ts"],
             "@modelcontextprotocol/test-helpers": ["./node_modules/@modelcontextprotocol/test-helpers/src/index.ts"],
-            "@modelcontextprotocol/server/_shims": ["./src/shimsNode.ts"]
+            "@modelcontextprotocol/server/_shims": ["./src/shimsNode.ts"],
+            "@modelcontextprotocol/server/zod-schemas": ["./src/zodSchemas.ts"]
         }
     }
 }

packages/server/tsdown.config.ts

@@ -4,7 +4,7 @@ export default defineConfig({
     failOnWarn: 'ci-only',
     // 1. Entry Points
     //    Directly matches package.json include/exclude globs
-    entry: ['src/index.ts', 'src/shimsNode.ts', 'src/shimsWorkerd.ts', 'src/validators/cfWorker.ts'],
+    entry: ['src/index.ts', 'src/zodSchemas.ts', 'src/shimsNode.ts', 'src/shimsWorkerd.ts', 'src/validators/cfWorker.ts'],
 
     // 2. Output Configuration
     format: ['esm'],
@@ -26,7 +26,8 @@ export default defineConfig({
             baseUrl: '.',
             paths: {
                 '@modelcontextprotocol/core': ['../core/src/index.ts'],
-                '@modelcontextprotocol/core/public': ['../core/src/exports/public/index.ts']
+                '@modelcontextprotocol/core/public': ['../core/src/exports/public/index.ts'],
+                '@modelcontextprotocol/core/schemas': ['../core/src/types/schemas.ts']
             }
         }
     },

packages/server/typedoc.json

@@ -2,7 +2,7 @@
     "$schema": "https://typedoc.org/schema.json",
     "entryPoints": ["src"],
     "entryPointStrategy": "expand",
-    "exclude": ["**/*.test.ts", "**/__*__/**"],
+    "exclude": ["**/*.test.ts", "**/__*__/**", "**/zodSchemas.ts"],
     "navigation": {
         "includeGroups": true,
         "includeCategories": true