cloudflare-mcp

Installation
SKILL.md

Cloudflare MCP servers

Your memory of this stack comes from the McpAgent + SSE + @modelcontextprotocol/sdk v1 era. Cloudflare deprecated that path in agents 0.20.0 (McpAgent is feature-frozen). The MCP 2026-07-28 revision removed the initialize handshake and protocol sessions. As of 2026-09-28, tutorials, older skills and Cloudflare's own OAuth template show the old shapes.

Anchor every decision on one question:

Which protocol era does each client speak, and which handler serves it?

  • Legacy era: 2025-11-25 and earlier, starts with initialize.
  • Modern era: 2026-07-28, no handshake, per-request _meta.
  • The stateless createMcpHandler(factory) serves both on one route by default (verified live; matrix in references/spec.md section 4).
  • An SDK v1 server serves only the legacy era. A modern client gets 400 Unsupported protocol version: 2026-07-28.
  • Only reach for a sessionful legacy handler when a 2025-era client needs server-to-client requests (push elicitation, sampling, roots).

1. Check versions first

Installs
2
GitHub Stars
19
First Seen
Oct 16, 2026