You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
R-2549-1 (wire): Server MUST include ttlMs (≥0) and cacheScope ("public" | "private") on tools/list, prompts/list, resources/list, resources/templates/list, resources/read results
R-2549-2: Client SHOULD refetch on next access after ttlMs expires (MAY serve stale on refetch error)
R-2549-4:list_changed notifications still delivered if subscribed — ttl is a hint, not a replacement
R-2549-8: Same cacheScope on every page of a paginated list response
R-2549-10 (sdk): Polling helpers MUST apply jitter + backoff (spec text and SEP MD differ on MUST vs SHOULD — caching.mdx wins per spec page)
R-2549-11: Receiving list_changed / resources/updated invalidates the client cache regardless of remaining TTL
R-2549-12: Absent ttlMs on a response → treat as 0 (immediately stale) — BC with pre-2549 servers
R-2549-13: Negative ttlMs → treat as 0
R-2549-14: Cursor invalid (-32602 on next-page fetch) → discard all cached pages, re-fetch from page 1
R-2549-3 (guidance): Per-page ttlMs; freshness lives on ListToolsResult, not on Tool
R-2549-7 (security MUST NOT): Shared caches MUST NOT serve cacheScope: "private" to a different user — keyed on auth principal if the SDK ships a shared-cache helper
Activity
mattzcarey commentedon May 29, 2026
Status — SEP-2549 (TTL for List Results /
ttlMs+cacheScope)Track: B — independent, starts now.
Spec: seps/2549-TTL-for-list-results.md · merged 2026-05-15
What's done
main(nottlMs, nocacheScope, noCacheableResult).ttl?: numberto the four list-result types +McpServerOptions.listTtlSeconds; client marks tool-metadata cache stale afterttl; clamped to ≥1s.ttl(seconds). The spec landed onttlMs(milliseconds) + a siblingcacheScopefield. The PR will need a small reshape.Outstanding (acceptance criteria, summary)
ttlMs(≥0) andcacheScope("public" | "private") ontools/list,prompts/list,resources/list,resources/templates/list,resources/readresultsttlMsexpires (MAY serve stale on refetch error)list_changednotifications still delivered if subscribed —ttlis a hint, not a replacementcacheScopeon every page of a paginated list responselist_changed/resources/updatedinvalidates the client cache regardless of remaining TTLttlMson a response → treat as 0 (immediately stale) — BC with pre-2549 serversttlMs→ treat as 0ttlMs; freshness lives onListToolsResult, not onToolcacheScope: "private"to a different user — keyed on auth principal if the SDK ships a shared-cache helperSuggested phasing
ttl: number→ttlMs: number+ addcacheScope: 'public' | 'private'on a sharedCacheableResultinterfaceMcpServerOptions.{listTtlMs, defaultCacheScope}list_changed/resources/updatedinvalidation hooksCoordination
mainahead of the v2 stack and be rebased.