Skip to content

Design SDK changes for stateless & sessionless MCP#919

Draft
maciej-kisiel wants to merge 3 commits intomainfrom
mkisiel/stateless
Draft

Design SDK changes for stateless & sessionless MCP#919
maciej-kisiel wants to merge 3 commits intomainfrom
mkisiel/stateless

Conversation

@maciej-kisiel
Copy link
Copy Markdown
Contributor

No description provided.

@maciej-kisiel
Copy link
Copy Markdown
Contributor Author

Hi @yarolegovich, @guglielmo-san, @jba, I have a draft of the first part of the design for stateless/sessionless MCP that's coming in the next spec version. It's focused on the connection establishment logic. PTAL if you're interested and let me know if you have any feedback.

Comment thread design/stateless.md
New types in `protocol.go`:

```go
const ErrCodeUnsupportedProtocolVersion = -32602 // INVALID_PARAMS per SEP-2575
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Comment thread design/stateless.md
`resource/unsubscribe` when `>= 2026-06-30`.

> [!WARNING]
> Deprecated APIs:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

how long are we going to keep them deprecated and will the new subscriptions/listen method fallback to old-protocol version RPCs?

if the answer to the latter is negative, as an MCP client developer I'm kind of incentivised to keep using ClientSession.Subscribe() and ClientSession.Unsubscribe() APIs, because this way I write the same code for old and new servers

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Our only way to remove deprecated APIs is to release v2. But I hear your argument, maybe it's actually better to hold off with making them deprecated until we have designed how the replacement would look like in v2 and backport it to v1. Deprecation without suggested replacement may not be received well.

@maciej-kisiel maciej-kisiel changed the title Design protocol connection establishment changes for stateless MCP Design SDK changes for stateless & sessionless MCP May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants