// 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
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 verdict | MATERIAL at 0.92, needed 0.5 |
|---|---|
| triage reasoning | New Skills extension API with future date-gated breaking change in caching field requirements. |
| signals | new 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 model | anthropic/claude-haiku-4.5 ($0.00000) |
| writer model | anthropic/claude-sonnet-4.5 ($0.00000) |