Skip to content

Collapse Server Features and Client Features sections#2857

Open
clareliguori wants to merge 3 commits into
modelcontextprotocol:mainfrom
clareliguori:reorg-spec-headers
Open

Collapse Server Features and Client Features sections#2857
clareliguori wants to merge 3 commits into
modelcontextprotocol:mainfrom
clareliguori:reorg-spec-headers

Conversation

@clareliguori
Copy link
Copy Markdown
Contributor

Also nest deprecated features under a "Deprecated Features" group under Features

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

Additional context

@clareliguori clareliguori requested review from a team as code owners June 3, 2026 21:17
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 3, 2026
Also nest deprecated features under a "Deprecated Features" group under Features
Copy link
Copy Markdown
Member

@dsp-ant dsp-ant left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It am not sure if a flat list of features is an improvement. It does feel to me that there are categories along the lines of the original capability exchange and I would love us to follow along those. I think for now, I prefer the old categorization into server and client features.

@clareliguori
Copy link
Copy Markdown
Contributor Author

It am not sure if a flat list of features is an improvement. It does feel to me that there are categories along the lines of the original capability exchange and I would love us to follow along those. I think for now, I prefer the old categorization into server and client features.

The challenge is that now in Client Features, there is only one non-deprecated feature Elicitation

@pja-ant
Copy link
Copy Markdown
Contributor

pja-ant commented Jun 4, 2026

@dsp-ant we discussed this a bit in Core Maintainers. The problem with the current way is that:

(a) Client Features only has 3 things, and 2 of them are deprecated
(b) It's not really clear why they are "client" features any more in the MRTR world. They are things that the servers asks for from the client, but no longer client sent requests.

Not the end of the world, but IMO the client/server distinction is a bit confusing.

@dsp-ant
Copy link
Copy Markdown
Member

dsp-ant commented Jun 5, 2026

@pja-ant In my mind, these are still client features, as in functionality offered by the client. A feature doesn't imply how to request it (via a direct RPC call or via MRTR). For me that distinction is still important.

That we have 2 of 3 client features deprecated is unfortunate, but the distinction still stands. I certainly see a world where we add more in the future. We should own that we have very little client features for now. I delineate it by who is offering the capability.

If we feel that the separation into client and server features is confusing for users, that's okay, but I so far still prefer it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants