# Cloudflare Agents SDK agents@0.33.0: what's new, verdict & setup

Canonical: https://theagenticweekly.com/tools/cloudflare-agents · Released: 2026-11-03 · Last verified: 2026-11-11 · Evidence: Reported (not run by us) · Vendor: Cloudflare · Official site: https://developers.cloudflare.com/agents/

> MIT-licensed TypeScript SDK for stateful agents on Durable Objects, with MCP, scheduling and browser tools.

## Verdict

**The natural choice if you already deploy on Cloudflare Workers and want one durable, stateful agent per user or session; expect breaking changes almost every release.**

Good for:
- Teams already on Cloudflare Workers and Durable Objects
- Many small stateful agents (one per user, session or room) that hibernate when idle
- MCP servers and clients hosted on Cloudflare

Skip if:
- You need a stable API: the package is pre-1.0 and three of the last four releases had breaking changes
- You do not want to run on Cloudflare

Status: Reported. Written from official release notes and docs; we have not run this release ourselves.

Pricing: Not verified. We have not verified pricing for this tool; see the official site.

## Best for

- [Best AI tool for agent building](https://theagenticweekly.com/best/agent-building) (#-): Stateful agents on Cloudflare Durable Objects, with MCP, scheduling and a browser tool.

## What's new

Cloudflare's agents package runs each agent as a Durable Object with its own state, storage and lifecycle. Since late October it has shipped weekly: 0.31.0 (Oct 27) made the MCP packages optional peers, 0.32.0 (Oct 29) rebuilt Agent Skills loading, and 0.33.0 (Nov 3) moved the Pi harness to Pi 1.5 with no rollback.

- agents@0.33.0 (Nov 3): the Pi harness moves to Pi 1.5, which the notes say cuts SQLite storage transactions about 27x for long answers; once a conversation runs on Pi 1.5 a deployment cannot roll back past this release.
- agents@0.33.0: session.watch() replaces session.events(), session.continue() restarts a run on the existing transcript, and defaults.maxTurns caps tool rounds; retry() and the parked status are removed.
- agents@0.32.0 (Oct 29): breaking for agents/skills: skills load from Workspace files, R2 or code, SKILL.md is checked against the Agent Skills spec, and SkillRegistry is replaced by loadSkillCatalog() and createSkillTools(). Adds experimental OpenTelemetry spans.
- agents@0.31.0 (Oct 27): Browser Run can route up to 8 internal hostnames to your agent; @modelcontextprotocol/sdk and server become optional peer dependencies that MCP users must add themselves.

## How to set it up: Start a Cloudflare Agents project

Steps come from the project's README. We have not run them ourselves.

1. **Create from the starter template.** The README's quickest path scaffolds a working agent project.

```
npm create cloudflare@latest -- --template cloudflare/agents-starter
```
2. **Or add it to an existing Worker.** Install the package into a project you already have.

```
npm install agents
```
3. **If you use MCP, add the peers.** Since 0.31.0 the MCP packages are optional peer dependencies; builds that import agents/mcp fail without them.

```
npm install @modelcontextprotocol/sdk @modelcontextprotocol/server
```

## Cloudflare Agents releases, October to November 2026

Every minor release since 0.30.0, from Cloudflare's GitHub release notes (read Nov 11, 2026). Breaking changes are called out because the package is still pre-1.0.

Table: agents package releases with their breaking changes (GitHub release notes, read Nov 11, 2026)

| Version | Date | Headline change | Breaking for | Rollback |
|---|---|---|---|---|
| [0.33.0](https://github.com/cloudflare/agents/releases/tag/agents%400.33.0) | Nov 3 | Pi harness on Pi 1.5; batched writes cut SQLite transactions about 27x for long answers (vendor figure); session.watch(), session.continue(), defaults.maxTurns | Pi users: retry() and the parked status removed; tool schemas move to @earendil-works/pi-schema | Not possible past this release once a conversation runs on Pi 1.5 |
| [0.32.0](https://github.com/cloudflare/agents/releases/tag/agents%400.32.0) | Oct 29 | Agent Skills load from Workspace files, R2 or code; experimental_registerOpenTelemetry() | agents/skills: SkillRegistry replaced by loadSkillCatalog() and createSkillTools(); agents/skills/compile removed | Normal |
| [0.31.0](https://github.com/cloudflare/agents/releases/tag/agents%400.31.0) | Oct 27 | Browser Run routes up to 8 internal hostnames to your agent; browserTool runs model code in its own Dynamic Worker | MCP users must install @modelcontextprotocol/sdk and server themselves | Normal |
| [0.30.0](https://github.com/cloudflare/agents/releases/tag/agents%400.30.0) | Oct 22 | Pi 1.4 support; PiHarness hibernates while Pi's tasks sleep and recovers from storage errors | Pi users must update to ~1.4.0 and pass onWake | Not possible past this release (Pi 1.4 storage schema) |

- **Upgrading from 0.30 to 0.33:** install the MCP peers if you import agents/mcp, migrate skills to loadSkillCatalog(), then update Pi to ~1.5.0 and replace session.events() with session.watch(). Test on a copy first: both the 0.30 and 0.33 Pi migrations are one-way.
- **Performance claims:** Cloudflare's 0.33.0 notes say one Pi harness with 2,048 sessions went from 88 to 459 agent runs a second on SQLite. We have not measured this.
- **Companion packages:** @cloudflare/think shipped 0.22.0 and 0.23.0 alongside 0.31.0 and 0.32.0; check their notes if you use Think.

## Cloudflare Agents vs other agent frameworks

Table: Agent frameworks we cover, by where they run (project READMEs and our tool pages)

| Framework | Language | Where agents run | Licence | Our evidence |
|---|---|---|---|---|
| Cloudflare Agents SDK | TypeScript | Cloudflare Workers and Durable Objects | MIT | Reported |
| [Mastra](https://theagenticweekly.com/tools/mastra) | TypeScript | Any Node runtime, local Studio | Check the repository (GitHub reports NOASSERTION) | Tested (smoke test) |
| [OpenAI Agents SDK](https://theagenticweekly.com/tools/openai-agents-sdk) | Python and TypeScript | Anywhere you run the SDK | See its tool page | See its tool page |
| [LangGraph](https://theagenticweekly.com/tools/langgraph) | Python and TypeScript | Anywhere, or LangGraph Platform | See its tool page | See its tool page |

Pick Cloudflare Agents when you want the platform to own state, hibernation and scaling per agent; pick a runtime-neutral framework if you may move off Cloudflare. See all of them ranked on [best agent-building tools](https://theagenticweekly.com/best/agent-building).


## Pros and cons

Pros:
- MIT licence
- Each agent keeps its own state and storage and hibernates when idle, per the README
- Detailed release notes with upgrade steps
- Built-in MCP, scheduling, workflows and a browser tool

Cons:
- Pre-1.0 with frequent breaking changes (0.31.0, 0.32.0 and 0.33.0 all break something)
- Pi 1.4 to 1.5 storage migration cannot be rolled back
- Tied to Cloudflare Workers and Durable Objects

## Alternatives

- [Mastra](https://theagenticweekly.com/tools/mastra): TypeScript framework for AI-powered applications and agents, with a local Studio.
- [OpenAI Agents SDK](https://theagenticweekly.com/tools/openai-agents-sdk): Lightweight Python framework for multi-agent workflows, with tools, handoffs, sessions and tracing.
- [LangGraph](https://theagenticweekly.com/tools/langgraph): Low-level framework for building long-running, stateful agents as graphs.
- [Semantic Kernel](https://theagenticweekly.com/tools/semantic-kernel): Microsoft's model-agnostic SDK for building AI agents; its README calls Microsoft Agent Framework the enterprise-ready successor.
- [Langflow](https://theagenticweekly.com/tools/langflow): MIT-licensed visual builder for AI agents and MCP servers with a very large GitHub following.
- [Botpress](https://theagenticweekly.com/tools/botpress): Customer-support AI agent platform with a free plan and conversation-based paid plans.
- [Gumloop](https://theagenticweekly.com/tools/gumloop): Agent builder for teams; plans start at $37 per month with 20k included credits.
- [Lindy](https://theagenticweekly.com/tools/lindy): AI 'employee' builder that connects to your tools; Free plan with $50 in credits that last 7 days, then credit-based plans.
- [Microsoft Copilot Studio](https://theagenticweekly.com/tools/copilot-studio): Microsoft's platform for creating and managing custom agents, workflows and apps with no code.
- [Pydantic AI](https://theagenticweekly.com/tools/pydantic-ai): Python agent framework built on Pydantic types, covering agents, realtime voice, image generation and embeddings.
- [Relevance AI](https://theagenticweekly.com/tools/relevance-ai): Platform for specialist AI agents for sales, customer success, marketing and HR, with an embedded deployment team.
- [Voiceflow](https://theagenticweekly.com/tools/voiceflow): Platform for chat and voice AI agents for customer experience teams.

## FAQ

### What is the Cloudflare Agents SDK?

Cloudflare's MIT-licensed agents package for TypeScript. Each agent is a Durable Object with its own state, storage and lifecycle, with built-in real-time sync, scheduling, AI model calls, MCP and workflows, per its README.

### What is the latest Cloudflare Agents release?

agents@0.33.0, released Nov 3, 2026 (checked on GitHub Nov 11). It moves the Pi harness to Pi 1.5 and cannot be rolled back once conversations run on Pi 1.5.

### Why does my agents/mcp build fail after upgrading?

Since 0.31.0, @modelcontextprotocol/sdk and @modelcontextprotocol/server are optional peer dependencies. Install them yourself; 0.32.0 moved to sdk 1.32.2 and server 2.4.0.

### Is the Cloudflare Agents SDK free?

The package is MIT open source. Running it uses Cloudflare Workers and Durable Objects, which Cloudflare bills under its own plans; we have not priced a deployment.

## What we have not verified

- Cloudflare Workers and Durable Objects costs for a real agent workload
- Performance figures (the 27x and 88-to-459 runs a second numbers are Cloudflare's release notes)
- Behaviour in production (not tested)

## Sources

- [agents@0.33.0 release](https://github.com/cloudflare/agents/releases/tag/agents%400.33.0) (fetched 2026-11-11)
- [agents@0.32.0 release](https://github.com/cloudflare/agents/releases/tag/agents%400.32.0) (fetched 2026-11-11)
- [agents@0.31.0 release](https://github.com/cloudflare/agents/releases/tag/agents%400.31.0) (fetched 2026-11-11)
- [agents@0.30.0 release](https://github.com/cloudflare/agents/releases/tag/agents%400.30.0) (fetched 2026-11-11)
- [README](https://github.com/cloudflare/agents) (fetched 2026-11-11)
- [Cloudflare Agents docs](https://developers.cloudflare.com/agents/) (fetched 2026-11-11)

## How to cite

Agentic Weekly, "Cloudflare Agents SDK agents@0.33.0: what's new, verdict & setup", last updated 2026-11-11, https://theagenticweekly.com/tools/cloudflare-agents

Keep the Reported or Tested label when you quote the verdict.