Upgrade MCP SDK to v1.25.2 #27314
Open
Upgrade MCP SDK to v1.25.2 #27314
+330
−1
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
agents-git-bot
bot
requested review from
a team,
elithrar,
irvinebroque,
rita3ko,
thomasgauvin,
threepointone and
whoiskatrin
as code owners
github-actions
bot
added
size/m
product:agents
github-actions
bot
assigned
elithrar,
irvinebroque,
rita3ko,
thomasgauvin,
threepointone and
whoiskatrin
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
Contributor
Author
Documentation UpdatesAdded comprehensive documentation for the stateless MCP server approach introduced in cloudflare/agents#752: New Documentation
Updated Documentation
The new stateless approach is documented as "THE simplest way to get started with MCP on Cloudflare" and is ideal for servers that don't need to maintain state between requests. |
Contributor
|
|
||
| :::note[Looking for a simpler stateless option?] | ||
| If you do not need state management and want the simplest possible MCP server, see the [Build a stateless MCP server](/agents/guides/stateless-mcp-server/) guide. That approach uses the MCP SDK directly without the `McpAgent` wrapper. | ||
| ::: |
Contributor
There was a problem hiding this comment.
Should we make this default?
agents-git-bot
bot
force-pushed
the
sync-docs-pr-752
branch
from
691de25 to
6f3f783
Compare
agents-git-bot
bot
changed the title
agents-git-bot
bot
force-pushed
the
sync-docs-pr-752
branch
from
6f3f783 to
1d12c7a
Compare
This commit syncs documentation for cloudflare/agents PR #752 which upgrades the MCP SDK to v1.25.2 and adds new transport features. Changes: - Add new example using MCP SDK directly in transport.mdx - Document new WorkerTransport options (onsessionclosed, eventStore, retryInterval) - Document new closeSSEStream method for polling patterns - Add changelog entry for MCP SDK v1.25.2 upgrade - Update API reference with enhanced error handling details The upgrade brings improved error handling for transport detection and new options for building stateful and stateless MCP servers. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
agents-git-bot
bot
force-pushed
the
sync-docs-pr-752
branch
from
1d12c7a to
74519b5
Compare
Contributor
Author
|
Updated documentation sync to include:
All documentation follows the Cloudflare style guide and includes practical code examples demonstrating the new features. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
6 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Documentation sync for cloudflare/agents PR #752
This PR synchronizes documentation for the MCP SDK upgrade from v1.23.0 to v1.25.2 implemented in cloudflare/agents#752
Changes
New Features Documented
WorkerTransport Options
onsessionclosed- Callback for session closure via DELETE requesteventStore- Event store interface for message resumability supportretryInterval- SSE reconnection timing configurationsessionIdGeneratordocumentation to clarify stateless modeWorkerTransport Methods
closeSSEStream()- Method to trigger client reconnection for polling behaviorNew Example Approach
WebStandardStreamableHTTPServerTransportdirectly from the MCP SDKDocumentation Structure Improvements
transport.mdx: Now presents two clear approaches:
createMcpHandler(recommended)mcp-handler-api.mdx: Enhanced WorkerTransport documentation with:
Related Links
Testing