SkillsCloudflare & infrastructure › Cloudflare Agents SDK
agents-sdk

Cloudflare Agents SDK

How to build AI agents and MCP servers on Cloudflare Workers using the Agents SDK — the same family of tooling our connectors are built with (an MCP server is the “connector” that lets Claude talk to a tool like Canto or LoudCrowd).

Claude Code only
How to use it
Tell Claude what kind of agent or MCP server you want — stateful, scheduled, WebSocket, or a new connector — and it scaffolds the McpAgent / Agent class, persistent state, scheduling, and auth, pulling the current Cloudflare Agents docs rather than stale memory. Claude Code only: it writes and runs project code locally.
How to invoke / keep it on
Describe an agent / MCP-server task in Claude Code and it auto-loads. For ongoing connector work, name it in the project’s instructions so it’s always in play.
20 powerful examples for Melinda Maria
Copy, tweak, make them yours. Just describe the task — Claude loads the skill automatically.
01"I want a brand-new MCP connector for a tool we use — scaffold the McpAgent on Cloudflare Workers the same way our canto-mcp connector is built, with read-only tools to start."
02"Add a scheduled task to one of our connectors that pre-warms data every morning so the team’s first question of the day is instant — show me the schedule API."
03"Explain how human-in-the-loop approval works in the Agents SDK so I can make sure any future write tool (like a Gorgias-style send) stays confirm-gated."
04"Walk me through securing an MCP server with OAuth so a new connector uses our MM Google work-account sign-in like the others."
05"Scaffold a new QuickBooks-style read-only MCP connector end to end, with a health tool and a sync-status tool from day one like our other connectors."
06"Show me how to register tools on an McpAgent with clear input schemas so the team’s plain-English questions map cleanly to each tool."
07"Explain how the Agents SDK keeps state per connection versus globally, so I don’t accidentally leak one teammate’s query results into another’s."
08"Help me add a WebSocket-based live tool to a connector so a dashboard could stream ShipHero order updates as they happen."
09"Convert a connector that currently does everything in one big tool into several focused tools, and tell me why that’s easier for the team to use."
10"Show me the Agents SDK pattern for a confirm-gated write so a future Shopify tag-update tool always pauses for a yes before it changes anything."
11"Walk me through testing an MCP server locally before deploy so I can verify each tool returns what I expect without hitting production."
12"Explain how to add a nightly self-refresh to the loudcrowd connector using the SDK’s scheduling instead of an external cron."
13"Help me give a connector a clean error message when an upstream API (like Sprout Social) is down, so the team sees “temporarily unavailable” not a stack trace."
14"Scaffold an agent that watches for low inventory in ApparelMagic and posts a summary to #ops, with the write step confirm-gated."
15"Show me how to version a connector’s tools so I can add new ones without breaking the team’s saved prompts."
16"Explain, in plain English, the difference between an “agent” and an “MCP server” in this SDK so I can describe our connectors accurately to non-coders."
17"Help me add rate-limit handling to a connector so it backs off gracefully when Meta Ads returns a 429 instead of failing the whole request."
18"Set up structured logging on a connector so I can see in the logs which tool the team called and how long it took."
19"Walk me through giving the canto-mcp connector a per-account memory of recent searches so repeat questions come back faster."
20"Draft the architecture for a single “Melinda Maria operations” agent that could call several of our connectors in one answer, and the tradeoffs versus keeping them separate."
← Back to Cloudflare & infrastructure
Powered by our people. Amplified by AI. Ready-to-run playbooks for every team.