Skip to content

Conversation

@agents-git-bot
Copy link
Contributor

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

Summary

Documents the upgrade of @modelcontextprotocol/sdk from v1.23.0 to v1.25.2 in the Agents SDK.

  • Added new section demonstrating how to use MCP SDK directly without the Agents SDK using WebStandardStreamableHTTPServerTransport
  • Documented new mcp-server example that provides the simplest way to create an MCP server on Cloudflare Workers
  • Created comprehensive stateless MCP server guide with step-by-step tutorial
  • Added documentation for new WorkerTransport options:
    • onsessionclosed callback for session cleanup notifications
    • eventStore for connection resumability support (allows clients to recover from interruptions)
    • retryInterval for controlling SSE polling behavior
  • Added changelog entry documenting all v1.25.2 features and migration notes

Test plan

  • Review documentation accuracy against the source code changes
  • Verify all links and code examples are correct
  • Ensure the new example is properly integrated into the documentation structure
  • Confirm changelog entry follows existing format and style

Related PR: cloudflare/agents#752

🤖 Generated with Claude Code

@github-actions github-actions bot added size/m product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Dec 24, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Dec 24, 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
Copy link
Contributor Author

Documentation Updates

Added comprehensive documentation for the stateless MCP server approach introduced in cloudflare/agents#752:

New Documentation

  • Build a stateless MCP server guide - Complete tutorial showing the simplest way to create MCP servers using WebStandardStreamableHTTPServerTransport directly from the MCP SDK

Updated Documentation

  • MCP index page - Now clearly explains both approaches (stateless vs McpAgent-based) and helps users choose the right one
  • Build a Remote MCP server guide - Added note clarifying this is for McpAgent-based servers and linking to the stateless option for simpler use cases

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.

@github-actions
Copy link
Contributor

github-actions bot commented Dec 24, 2025

@agents-git-bot agents-git-bot bot requested a review from a team as a code owner December 29, 2025 16:11

:::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.
:::
Copy link
Contributor

Choose a reason for hiding this comment

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

Should we make this default?

- Add documentation for new WorkerTransport options:
  - onsessionclosed callback for session cleanup
  - eventStore for resumability support
  - retryInterval for polling behavior
  - closeSSEStream() method for triggering reconnections
- Add section on using MCP SDK directly with WebStandardStreamableHTTPServerTransport
- Document new mcp-server example showing zero-config MCP server setup
- Update WorkerTransportOptions interface documentation

Syncs documentation with PR #752 (Upgrade MCP SDK to v1.25.1)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@agents-git-bot agents-git-bot bot changed the title Upgrade MCP SDK to v1.25.1 Upgrade MCP SDK to v1.25.2 Jan 9, 2026
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/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants