Skip to content

docs: 2026-06 migration guide + examples + changeset#2133

Draft
felixweinberger wants to merge 1 commit into
fweinberger/v2-pipe-transportsfrom
fweinberger/v2-sectioned
Draft

docs: 2026-06 migration guide + examples + changeset#2133
felixweinberger wants to merge 1 commit into
fweinberger/v2-pipe-transportsfrom
fweinberger/v2-sectioned

Conversation

@felixweinberger
Copy link
Copy Markdown
Contributor

@felixweinberger felixweinberger commented May 20, 2026

2026-06 stateless stack (v2-stateless label):

# PR
1 #2128 tasks-delete (mechanical)
2 #2129 schema-sync (mechanical)
3 #2130 Dispatcher extraction (zero-Δ refactor)
4 #2131 HTTP-stateless (the substantive review)
5 #2132 stdio/InMemory transports (additive)
6 #2133 docs + changeset
7 #2134 LegacyServer/LegacyClient extraction

Migration guide, examples, and changeset for the 2026-06 stateless stack.

Types of changes

  • Documentation update

Checklist

  • I have added or updated documentation as needed

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 20, 2026

🦋 Changeset detected

Latest commit: c73c457

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 7 packages
Name Type
@modelcontextprotocol/core Major
@modelcontextprotocol/server Major
@modelcontextprotocol/client Major
@modelcontextprotocol/express Major
@modelcontextprotocol/fastify Major
@modelcontextprotocol/hono Major
@modelcontextprotocol/node Major

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

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented May 20, 2026

Open in StackBlitz

@modelcontextprotocol/client

npm i https://pkg.pr.new/@modelcontextprotocol/client@2133

@modelcontextprotocol/server

npm i https://pkg.pr.new/@modelcontextprotocol/server@2133

@modelcontextprotocol/express

npm i https://pkg.pr.new/@modelcontextprotocol/express@2133

@modelcontextprotocol/fastify

npm i https://pkg.pr.new/@modelcontextprotocol/fastify@2133

@modelcontextprotocol/hono

npm i https://pkg.pr.new/@modelcontextprotocol/hono@2133

@modelcontextprotocol/node

npm i https://pkg.pr.new/@modelcontextprotocol/node@2133

commit: c73c457

Examples migrated to ctx.mcpReq.* (works under both protocols):
- toolWithSampleServer.ts: server.createMessage -> ctx.mcpReq.requestSampling
- elicitationFormExample.ts: server.elicitInput -> ctx.mcpReq.elicitInput (3x)
- serverGuide.examples.ts: server.listRoots -> ctx.mcpReq.listRoots
- elicitationUrlExample.ts: out-of-band webhook keeps server.elicitInput;
  comment documents pre-2026-only limitation (no request context).

Headline 2026-06 example:
- honoWebStandardStreamableHttp.ts: handleHttp(server.server, opts) Fetch
  handler. One shared instance, no Transport, no connect().
- simpleStatelessStreamableHttp.ts: shared instance + single connected
  transport (was per-request); transport per-message router serves both.

docs/migration.md + docs/migration-SKILL.md: 2026-06 stateless support
section. Server/Client are the same classes (additive); ctx.mcpReq.*
mapping table; auto-probe note; subscribe() note; LegacyTestClient pattern
for tests. No .legacy/LegacyServer references (sectioned approach).

docs/server.md, examples/server/README.md: updated to match.
.changeset/stateless-2026-06.md: major bump core/server/client.

Satisfies: 2575-R1, 2567-R1, 2322-R1
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

v2-stateless 2026-06 SDK: Protocol decomposition + SEP alignment (request-first / stateless)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant