{"generatedAt":"2026-10-27T13:07:44.092Z","canonicalUrl":"https://agentbreakwatch.com/p/mcp-client-ts-v2","llmsTxtUrl":"https://agentbreakwatch.com/p/mcp-client-ts-v2/llms.txt","categoryHub":{"slug":"agent-sdks","title":"AI Agent SDKs & Frameworks Breaking-Change Index","url":"https://agentbreakwatch.com/c/agent-sdks"},"tldrVerdict":"MCP TypeScript SDK v2 Client (@modelcontextprotocol/client) is currently at v2.4.0 on NPM (published 2026-10-23), with a 90-day Stability Score of 78/100 (B) and HIGH schema drift risk. v2 split of @modelcontextprotocol/sdk. Since 2.4.0 the client does not list tools that put x-mcp-header on a number parameter, and outputSchema results built from z.object().meta({ id }) arrive unwrapped in structuredContent on 2025-11-25 connections.","package":{"slug":"mcp-client-ts-v2","packageName":"@modelcontextprotocol/client","registry":"npm","kind":"sdk","subcategory":"MCP Core SDK","displayName":"MCP TypeScript SDK v2 Client","vendor":"Model Context Protocol","githubRepo":"modelcontextprotocol/typescript-sdk","breakingSummary":"v2 split of @modelcontextprotocol/sdk. Since 2.4.0 the client does not list tools that put x-mcp-header on a number parameter, and outputSchema results built from z.object().meta({ id }) arrive unwrapped in structuredContent on 2025-11-25 connections.","schemaDriftRisk":"high","affectedSymbols":["Client","listTools","callTool","structuredContent","OAuthClientProvider"],"migrationBefore":"import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nconst value = result.structuredContent.result;","migrationAfter":"import { Client } from \"@modelcontextprotocol/client\";\nconst value = result.structuredContent;","description":"Model Context Protocol implementation for TypeScript - Client package","latestVersion":"2.4.0","latestPublishedAt":"2026-10-23T18:21:05.614Z","recentVersions":[{"version":"2.4.0","publishedAt":"2026-10-23T18:21:05.614Z"},{"version":"2.3.1","publishedAt":"2026-10-05T11:50:23.381Z"},{"version":"2.3.0","publishedAt":"2026-10-02T17:46:01.763Z"},{"version":"2.2.0","publishedAt":"2026-09-28T19:09:46.801Z"},{"version":"2.1.0","publishedAt":"2026-09-23T15:45:32.399Z"},{"version":"2.0.0","publishedAt":"2026-07-27T23:55:22.113Z"}],"releasesLast90d":5,"dependenciesCount":7,"license":"Apache-2.0","registryUrl":"https://www.npmjs.com/package/@modelcontextprotocol/client","githubUrl":"https://github.com/modelcontextprotocol/typescript-sdk","installCommand":"npm install @modelcontextprotocol/client@2.4.0","stabilityScore":78,"stabilityGrade":"B"}}