SEP-2133: Extensions framework for MCP#2133
Merged
Merged
Conversation
9 tasks
pwwpche
reviewed
Jan 23, 2026
pwwpche
reviewed
Jan 23, 2026
pwwpche
reviewed
Jan 23, 2026
pwwpche
reviewed
Jan 23, 2026
pwwpche
reviewed
Jan 23, 2026
pwwpche
reviewed
Jan 23, 2026
pwwpche
reviewed
Jan 23, 2026
dsp-ant
reviewed
Jan 23, 2026
kurtisvg
reviewed
Jan 23, 2026
pcarleton
reviewed
Jan 23, 2026
dsp-ant
reviewed
Jan 26, 2026
dsp-ant
left a comment
Member
There was a problem hiding this comment.
We should add the extension page outline to this PR.
48435c1 to
a6432a6
Compare
80b489c to
84bdbfd
Compare
CaitieM20
previously approved these changes
Jan 26, 2026
02e50c7 to
1a747b2
Compare
bhosmer-ant
previously approved these changes
Jan 26, 2026
Member
|
This was accepted by @modelcontextprotocol/core-maintainers unanimously: Voting results:
Once comments are addressed, this can be merged and status changed to final. @pja-ant please ensure that SDK's are implementing the necessary changes. |
9 tasks
This was referenced Feb 4, 2026
7 tasks
22 tasks
4 tasks
This was referenced Jun 6, 2026
9 tasks
koic
added a commit
to modelcontextprotocol/ruby-sdk
that referenced
this pull request
Jun 14, 2026
## Motivation and Context SEP-2133 (modelcontextprotocol/modelcontextprotocol#2133, merged for the 2026-07-28 spec release) establishes the extensions framework for MCP: both `ClientCapabilities` and `ServerCapabilities` gain an optional `extensions` member keyed by reverse-DNS extension identifiers (e.g. `"io.modelcontextprotocol/tasks"`, `"com.example/feature"`), with arbitrary extension-defined configuration objects as values and an empty object meaning "supported with no settings". Official extensions such as MCP Apps (SEP-1865) and the Tasks extension (SEP-2663) are layered on this field. This mirrors the shape the TypeScript SDK merged (typescript-sdk#1630): plain declaration and passthrough, no registrar API and no key-format validation (the naming convention is documented instead). - `MCP::Server::Capabilities` gains `support_extensions` (repeated calls merge), accepts an `:extensions` key in its constructor hash, and includes `extensions` in `to_h`. The class was previously dead code: it was never required and `Server.new` only took plain hashes. It is now required by `lib/mcp/server.rb`, and `Server.new(capabilities:)` accepts either a plain Hash (as before) or a `Capabilities` instance. - Server-declared extensions appear in the `initialize` result; extensions the client declares during `initialize` were already stored verbatim and are readable via `Server#client_capabilities[:extensions]` and `ServerSession#client_capabilities[:extensions]` (now covered by tests). - `MCP::Client#connect(capabilities:)` already passes capabilities through verbatim; its documentation now covers the `extensions` member. Resolves #378. ## How Has This Been Tested? - New `test/mcp/server/capabilities_test.rb` covers the previously untested `Capabilities` class: empty default, constructor round-trip, extensions via constructor and `support_extensions`, merge semantics, nil tolerance, and omission from `to_h` when never declared. - New tests in `test/mcp/server_test.rb` assert that the `initialize` result carries declared extensions (from both a plain hash and a `Capabilities` instance) and that client-declared extensions are readable via `Server#client_capabilities` and `ServerSession#client_capabilities`. ## Breaking Changes None. `extensions` is additive and appears on the wire only when declared; servers constructed with plain capability hashes behave exactly as before.
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.
This SEP ports the Extensions proposal from issue #1724 to the new PR-based SEP format (per SEP-1850).
Summary
Establishes a framework for extending the Model Context Protocol while maintaining interoperability, clear governance, and appropriate legal structure.
Key Points
io.modelcontextprotocol/oauth-client-credentials)github.com/modelcontextprotocol/ext-*repositoriesextensionsfield in ClientCapabilities/ServerCapabilitiesDesign Consistency
The patterns described are consistent with existing official extensions (ext-apps and ext-auth).
References