docs: annotate Roots, Sampling, and Logging as deprecated per SEP-2577#429
Merged
koic merged 1 commit intoJun 27, 2026
Merged
Conversation
Split the advisory YARD @deprecated annotations out of modelcontextprotocol#406 so the documentation can land ahead of the 2026-07-28 protocol release. Per maintainer feedback, this drops the protocol-version-gated runtime Kernel.warn behavior and the new 2026-07-28 supported protocol version, leaving only the @deprecated notes for the Roots, Sampling, and Logging APIs deprecated by SEP-2577. Refs modelcontextprotocol#390 Co-authored-by: 🦞 Qlaw <noreply@qlaw.quick.shopify.io>
atesgoral
force-pushed
the
issue-390-deprecation-annotations
branch
from
82a6dba to
69bfe43
Compare
This was referenced Jun 27, 2026
koic
approved these changes
Jun 27, 2026
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
2 participants
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.
TL;DR
Add advisory YARD
@deprecatedannotations for the Roots, Sampling, and Logging APIs deprecated by SEP-2577, without the protocol-version-gated runtime behavior change.Context
SEP-2577 deprecates Roots, Sampling, and Logging in the
2026-07-28protocol version. This PR splits the advisory annotations out of #406 per @koic's feedback, so the documentation can land now while the behavioral switch waits until the2026-07-28release is closer.Refs #390
Changes
@deprecatednotes to the server, server-context, and server-session APIs for roots (roots_list_changed_handler,list_roots), sampling (create_sampling_message), and logging (notify_log_message).Deliberately not included (deferred to a follow-up once
2026-07-28is closer to release):2026-07-28toSUPPORTED_STABLE_PROTOCOL_VERSIONS.Kernel.warnruntime warnings and theProtocolDeprecationshelper.Testing
Docs-only change (YARD comments + changelog). No behavior change; relies on CI for lint/test validation.