Summary
I noticed that the Agents SDK skill still presents McpAgent as the default way to build an MCP server:
The current Cloudflare MCP documentation describes McpAgent as deprecated and feature-frozen, with new servers using an SDK v2 factory and createMcpHandler from agents/mcp/server:
https://developers.cloudflare.com/agents/model-context-protocol/apis/handler-api/
The change was announced with Agents SDK v0.20.0:
https://developers.cloudflare.com/changelog/post/2026-07-27-agents-sdk-v0.20.0-mcp-sdk-v2/
Is the older guidance in the skill intentional, or has it simply not been updated for the new handler API yet?
I could not find an existing issue or PR tracking this.
Summary
I noticed that the Agents SDK skill still presents
McpAgentas the default way to build an MCP server:skills/agents-sdk/SKILL.mdskills/agents-sdk/references/mcp.mdThe current Cloudflare MCP documentation describes
McpAgentas deprecated and feature-frozen, with new servers using an SDK v2 factory andcreateMcpHandlerfromagents/mcp/server:https://developers.cloudflare.com/agents/model-context-protocol/apis/handler-api/
The change was announced with Agents SDK v0.20.0:
https://developers.cloudflare.com/changelog/post/2026-07-27-agents-sdk-v0.20.0-mcp-sdk-v2/
Is the older guidance in the skill intentional, or has it simply not been updated for the new handler API yet?
I could not find an existing issue or PR tracking this.