Build MCP servers on Cloudflare Workers - the only platform with official remote MCP support. TypeScript-based with OAuth, Durable Objects, and WebSocket hibernation. Prevents 24 documented errors. Use when: deploying remote MCP servers, implementing OAuth, or troubleshooting URL path mismatches, McpAgent exports, CORS issues, IoContext timeouts.
View on GitHubskills/cloudflare-mcp-server/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/brendadeeznuts1111/tier-1380-omega/blob/main/skills/cloudflare-mcp-server/SKILL.md -a claude-code --skill cloudflare-mcp-serverInstallation paths:
.claude/skills/cloudflare-mcp-server/# Cloudflare MCP Server Skill Build and deploy **Model Context Protocol (MCP) servers** on Cloudflare Workers with TypeScript. **Status**: Production Ready ✅ **Last Updated**: 2026-01-21 **Latest Versions**: @modelcontextprotocol/sdk@1.25.3, @cloudflare/workers-oauth-provider@0.2.2, agents@0.3.6 **Recent Updates (2025)**: - **September 2025**: Code Mode (agents write code vs calling tools, auto-generated TypeScript API from schema) - **August 2025**: MCP Elicitation (interactive workflows, user input during execution), Task Queues, Email Integration - **July 2025**: MCPClientManager (connection management, OAuth flow, hibernation) - **April 2025**: HTTP Streamable Transport (single endpoint, recommended over SSE), Python MCP support - **May 2025**: Claude.ai remote MCP support, use-mcp React library, major partnerships --- ## What is This Skill? This skill teaches you to build **remote MCP servers** on Cloudflare - the ONLY platform with official remote MCP support. **Use when**: Avoiding 24+ common MCP + Cloudflare errors (especially URL path mismatches - the #1 failure cause) --- ## 🚀 Quick Start (5 Minutes) **Start with Cloudflare's official template:** ```bash npm create cloudflare@latest -- my-mcp-server \ --template=cloudflare/ai/demos/remote-mcp-authless cd my-mcp-server && npm install && npm run dev ``` **Choose template based on auth needs:** - `remote-mcp-authless` - No auth (recommended for most) - `remote-mcp-github-oauth` - GitHub OAuth - `remote-mcp-google-oauth` - Google OAuth - `remote-mcp-auth0` / `remote-mcp-authkit` - Enterprise SSO - `mcp-server-bearer-auth` - Custom auth **All templates**: https://github.com/cloudflare/ai/tree/main/demos **Production examples**: https://github.com/cloudflare/mcp-server-cloudflare (15 servers with real integrations) --- ## Deployment Workflow ```bash # 1. Create from template npm create cloudflare@latest -- my-mcp --template=cloudflare/ai/demos/remote-mcp-authless cd my-mcp && npm install && n