// AI Platform Drift

MCP TypeScript SDK 2.4.0 adds Skills extension, caching fields required 2026-07-28

MCP TypeScript SDK releases · published 2026-10-24 04:39 UTC
ACTION NEEDED MIGRATE APIDEPRECATION
WHAT CHANGEDVersion 2.4.0 introduces a Skills extension (SEP-2640) under new ext/skills subpaths with server-side SkillsExtension, client-side SkillsClient, and catalog loading. On 2026-07-28, caching fields (ttlMs, cacheScope) transition from optional to required in skills/list, skills/get, and resources/directory/read responses. SkillsExtension.attach is marked @experimental and may change in a minor release.
WHY IT MATTERSCode using the Skills extension after 2026-07-28 will break if servers do not send ttlMs and cacheScope, and clients will fail if they do not handle these required fields. The @experimental marker on SkillsExtension.attach means the attachment API can change without a major version bump, breaking server initialization code.
WHAT TO DOIf adopting the Skills extension, pin @modelcontextprotocol/core to 2.4.x in package.json to avoid attachment API changes. Before 2026-07-28, update server code to send ttlMs and cacheScope in all Skills responses, and update client code to require and consume these fields.
ACT-BY DATE PASSED — this item's act-by date, 2026-07-28, is before this page was generated 2026-11-21 (UTC). Check the primary source before acting on it.
Model-reported confidence 85% (not measured accuracy) Primary source ↗ written by anthropic/claude-sonnet-4.5
Show the reasoning — raw diff, triage verdict, confidence
RAW DIFF
+## @modelcontextprotocol/core@2.4.0
+https://github.com/modelcontextprotocol/typescript-sdk/releases/tag/%40modelcontextprotocol%2Fcore%402.4.0
+2026-10-23T18:19:02Z
+
+Minor Changes
+
+#3047 46d9c99 Thanks @KKonstantinov, @tobi-oye, @mattzcarey! - Add the Skills extension (SEP-2640), reachable through new ext/skills subpaths; package root exports are unchanged.
+
+@modelcontextprotocol/server/ext/skills: SkillsExtension (attach(server) serves skills/list, skills/get, resources/directory/read and a skill://{+path} resource template), SkillsExtension.load(files) returning a SkillCatalog with entries and reload(), the SkillFiles storage adapter with memorySkillFiles, SkillSource for generated catalogs, skillEntry, and SkillCatalogError. Invalid skills are skipped with a warning (onWarning), or fail under strict. A file whose bytes are valid UTF-8 is served as text, whatever its MIME type; any other file as a base64 blob.
+@modelcontextprotocol/server/ext/skills/node: loadSkills(folder) and nodeSkillFiles(folder).
+@modelcontextprotocol/client/ext/skills: SkillsClient with list() (throws on an invalid entry; skipInvalid: true keeps the valid ones and returns the rest in invalid), get(), read(skill, path?) (size, digest and SKILL.md frontmatter verified, SkillVerificationError on a mismatch; a copy from the response cache that fails a check is fetched once more with cacheMode: 'refresh' first) and readDirectory().
+@modelcontextprotocol/core/ext/skills: schemas, types and constants, including SKILL_LIMITS. The result schemas follow the stable spec, so ttlMs and cacheScope are required.
+
+SkillsExtension.attach is @experimental: how an extension is wired to a server may change in a minor release. The rest of the Skills API is stable.
+Works on 2025-11-25 and 2026-07-28. On 2026-07-28 only, the server sends the caching fields (ttlMs, cacheScope), and SkillsClient requires them and returns them from list(), get() and readDirectory().
HOW IT WAS JUDGED
Triage signals below are model-reported assertions, preserved verbatim; they are not independent arithmetic verification.
triage verdictMATERIAL at 0.92, needed 0.5
triage reasoningNew Skills extension API with future date-gated breaking change in caching field requirements.
signalsnew extension API added (Skills) · new subpaths introduced (ext/skills) · new client and server modules exported · experimental API marker on SkillsExtension.attach · future date with behavioral change (2026-07-28 caching field requirement) · breaking change signaled: caching fields transition from optional to required
suppression—
triage modelanthropic/claude-haiku-4.5 ($0.00000)
writer modelanthropic/claude-sonnet-4.5 ($0.00000)