Skip to content

Conversation

@threepointone
Copy link
Contributor

Summary

Documents the deprecation of SSEEdgeClientTransport and StreamableHTTPEdgeClientTransport classes and provides migration guidance for users.

Changes

  • Added deprecation notice in the Transport documentation
  • Provided before/after code examples showing how to migrate imports
  • Explained that the official MCP SDK transport classes now work natively with Cloudflare Workers

Context

Related to cloudflare/agents#637 - This PR removed the custom edge transport implementations since the official MCP TypeScript SDK now supports Cloudflare Workers natively (as of summer 2024). The SDK now exports deprecated wrapper classes that log console warnings to guide users to update their imports.

Target Audience

Users who were directly importing and using these transport classes in custom MCP client implementations (advanced use case - most users rely on the automatic transport handling in McpAgent and addMcpServer()).

Generated with Claude Code

Co-Authored-By: Claude [email protected]

…ClientTransport

Added migration guide for users who were using the deprecated transport classes
directly. These classes have been replaced by the official MCP SDK transport
classes which now work natively with Cloudflare Workers.

Changes:
- Add deprecation notice for SSEEdgeClientTransport and StreamableHTTPEdgeClientTransport
- Provide before/after code examples showing import path migration
- Explain that the official SDK classes now support Workers natively

Related to cloudflare/agents#637

Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
Document the deprecation of SSEEdgeClientTransport and
StreamableHTTPEdgeClientTransport in favor of standard MCP SDK transports.

Since workerd now supports the duplex parameter, the custom edge transports
are no longer necessary. Users should migrate to SSEClientTransport and
StreamableHTTPClientTransport from @modelcontextprotocol/sdk.

Related to cloudflare/agents#637
@github-actions github-actions bot added the size/s label Nov 5, 2025
@threepointone threepointone requested a review from a team as a code owner November 5, 2025 19:33
@github-actions github-actions bot added November 2025 product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Nov 5, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 5, 2025

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

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/pcx-technical-writing
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @cloudflare/pcx-technical-writing

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

Labels

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants