feat: deprecate roots, sampling, and logging runtime APIs (SEP-2577) - #2268
Merged
felixweinberger merged 3 commits intoJun 15, 2026
Merged
Conversation
Copy link
Copy Markdown
Contributor
Sorry, something went wrong.
Adds @deprecated JSDoc annotations to the runtime public API surface for roots, sampling, and logging, deprecated as of protocol version 2026-07-28 per SEP-2577. Reference spec types were already annotated in #2252; this covers the Server/Client/McpServer methods, ServerContext helpers, runtime capability schema fields, and the server/client guides. No behavior changes.
Copy link
Copy Markdown
🦋 Changeset detectedLatest commit: e56b27c The changes in this PR will be included in the next version bump. This PR includes changesets to release 3 packages
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
Sorry, something went wrong.
Copy link
Copy Markdown
|
@modelcontextprotocol/client
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/client@2268
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/codemod@2268
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/server@2268
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/server-legacy@2268
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/express@2268
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/fastify@2268
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/hono@2268
npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/node@2268 commit: e56b27c |
Sorry, something went wrong.
typedoc treats the resolved-but-undocumented {@linkcode *CapabilitiesSchema}
links as warnings, failing docs:check in CI.
felixweinberger
approved these changes
Jun 15, 2026
felixweinberger
left a comment
Copy link
Copy Markdown
Contributor
There was a problem hiding this comment.
lgtm, thanks!
Sorry, something went wrong.
felixweinberger
enabled auto-merge (squash)
June 15, 2026 12:17
felixweinberger
deleted the
feat/sep-2577-deprecate-roots-sampling-logging
branch
June 15, 2026 12:19
This was referenced Jun 15, 2026
This was referenced Jun 15, 2026
9 tasks
felixweinberger
added a commit
that referenced
this pull request
Jun 22, 2026
… stacks (SEP-2596 Tier-1) Finishes the runtime-surface @deprecated sweep started by #2268, mirroring the markers already present on the per-revision reference types (spec.types.2026-07-28.ts). JSDoc only — no wire/behavior change; everything remains fully functional during the deprecation window. - Logging type stack: LoggingLevel, SetLevelRequest(+Params), LoggingMessageNotification(+Params) — schemas + type aliases - Sampling type stack: ModelHint, ModelPreferences, ToolChoice, ToolUseContent, ToolResultContent, SamplingContent, SamplingMessage(+ContentBlock), CreateMessageRequest(+Params/+Result/ +ResultWithTools/+ParamsBase/+ParamsWithTools) — schemas + type aliases - includeContext: mark thisServer/allServers values @deprecated (SEP-2596) - Roots type stack: Root, ListRootsRequest/Result, RootsListChangedNotification — schemas + type aliases - registerClient: DCR @deprecated in favor of Client ID Metadata Documents (SEP-991); marker only, mechanics unchanged Push-style server-to-client request APIs (Server.ping/createMessage/ elicitInput/listRoots, ServerContext.mcpReq.elicitInput/requestSampling) intentionally untouched — handled separately on impl/deprecated-push-apis.
felixweinberger
added a commit
that referenced
this pull request
Jun 22, 2026
… stacks (SEP-2596 Tier-1) Finishes the runtime-surface @deprecated sweep started by #2268, mirroring the markers already present on the per-revision reference types (spec.types.2026-07-28.ts). JSDoc only — no wire/behavior change; everything remains fully functional during the deprecation window. - Logging type stack: LoggingLevel, SetLevelRequest(+Params), LoggingMessageNotification(+Params) — schemas + type aliases - Sampling type stack: ModelHint, ModelPreferences, ToolChoice, ToolUseContent, ToolResultContent, SamplingContent, SamplingMessage(+ContentBlock), CreateMessageRequest(+Params/+Result/ +ResultWithTools/+ParamsBase/+ParamsWithTools) — schemas + type aliases - includeContext: mark thisServer/allServers values @deprecated (SEP-2596) - Roots type stack: Root, ListRootsRequest/Result, RootsListChangedNotification — schemas + type aliases - registerClient: DCR @deprecated in favor of Client ID Metadata Documents (SEP-991); marker only, mechanics unchanged Push-style server-to-client request APIs (Server.ping/createMessage/ elicitInput/listRoots, ServerContext.mcpReq.elicitInput/requestSampling) intentionally untouched — handled separately on impl/deprecated-push-apis.
felixweinberger
added a commit
that referenced
this pull request
Jun 22, 2026
… stacks (SEP-2596 Tier-1) Finishes the runtime-surface @deprecated sweep started by #2268, mirroring the markers already present on the per-revision reference types (spec.types.2026-07-28.ts). JSDoc only — no wire/behavior change; everything remains fully functional during the deprecation window. - Logging type stack: LoggingLevel, SetLevelRequest(+Params), LoggingMessageNotification(+Params) — schemas + type aliases - Sampling type stack: ModelHint, ModelPreferences, ToolChoice, ToolUseContent, ToolResultContent, SamplingContent, SamplingMessage(+ContentBlock), CreateMessageRequest(+Params/+Result/ +ResultWithTools/+ParamsBase/+ParamsWithTools) — schemas + type aliases - includeContext: mark thisServer/allServers values @deprecated (SEP-2596) - Roots type stack: Root, ListRootsRequest/Result, RootsListChangedNotification — schemas + type aliases - registerClient: DCR @deprecated in favor of Client ID Metadata Documents (SEP-991); marker only, mechanics unchanged Push-style server-to-client request APIs (Server.ping/createMessage/ elicitInput/listRoots, ServerContext.mcpReq.elicitInput/requestSampling) intentionally untouched — handled separately on impl/deprecated-push-apis.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements the runtime-API portion of SEP-2577 (Deprecate Roots, Sampling, and Logging). Per the draft spec (docs/specification/draft/deprecated.mdx registry, plus the banners on client/roots.mdx, client/sampling.mdx, and server/utilities/logging.mdx), roots, sampling, and logging are deprecated as of protocol revision 2026-07-28, remain fully functional for at least twelve months, and are eligible for removal no earlier than the first revision on/after 2027-07-28.
The reference spec types in spec.types.2026-07-28.ts (plus LOG_LEVEL_META_KEY and the _meta log-level schema annotation) were already annotated in #2252. This PR completes the picture by annotating the runtime public API with matching @deprecated JSDoc, and adding deprecation callouts to the guides.
What's annotated
@modelcontextprotocol/server
@modelcontextprotocol/client
@modelcontextprotocol/core
Docs: deprecation callouts on the Logging, Sampling, and Roots sections of docs/server.md and docs/client.md, each with the spec's migration guidance (roots → tool parameters / resource URIs / configuration; sampling → direct LLM provider APIs; logging → stderr / OpenTelemetry).
Wording matches the #2252 annotations (Deprecated as of protocol version 2026-07-28 (SEP-2577), twelve-month window, deprecated features registry).
No behavior change
JSDoc and docs only. No removals, no runtime changes — all three features keep working exactly as before for the full deprecation window.
Validation
Downstream impact
Closes #2195