Skip to content

Conversation

@agents-git-bot
Copy link
Contributor

@agents-git-bot agents-git-bot bot commented Dec 8, 2025

Summary

Syncs documentation updates from cloudflare/agents PR #720: fix: protocol version validation in worker transport

Changes

This PR updates the WorkerTransport documentation to reflect the move to stateless protocol version validation:

  • Removed protocolVersion field from TransportState interface documentation - the transport no longer stores negotiated protocol versions
  • Updated persistent storage benefits - removed "Protocol version negotiation state" from the list of preserved state
  • Added new "Protocol Version Validation" section explaining the stateless validation approach

What Changed in the Agents SDK

The WorkerTransport now:

  • Validates protocol version headers without tracking negotiated versions
  • Accepts any supported protocol version in request headers
  • Accepts missing headers (defaults to SDK-negotiated version)
  • Only rejects explicitly unsupported versions
  • Delegates protocol negotiation to the MCP SDK during initialization

This aligns with the move to stateless transports in the MCP protocol.

Related


🤖 Generated via automated documentation sync from cloudflare/agents

@github-actions github-actions bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Dec 8, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Dec 8, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @whoiskatrin, @cloudflare/pcx-technical-writing, @cloudflare/ai-agents

@agents-git-bot agents-git-bot bot changed the title docs: sync agents PR #720 - simplify protocol version validation docs: sync agents PR #720 - protocol version validation in worker transport Dec 8, 2025
Add documentation explaining the stateless approach to MCP protocol version validation in the Agents SDK transport layer. This change clarifies that:

- The MCP-Protocol-Version header is optional on subsequent requests
- Version consistency is not enforced across requests
- Only explicitly unsupported versions are rejected

Synced from cloudflare/agents PR #720 (fix: protocol version validation in worker transport)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sync from cloudflare/agents PR #720

Changes:
- Remove protocolVersion field from TransportState interface (no longer stored)
- Update persistent storage benefits to remove protocol version tracking
- Add new Protocol Version Validation section explaining stateless validation approach

The WorkerTransport now validates protocol version headers without tracking
negotiated versions. It accepts any supported version or missing headers,
only rejecting explicitly unsupported versions. Protocol negotiation is
handled by the MCP SDK.

Related: cloudflare/agents#720
@whoiskatrin whoiskatrin closed this Dec 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Request] Support MCP-Protocol-Version 2025-11-25

6 participants