Cloudflare Agents SDK 0.31.0 released
A feature release adding internal hostnames to Browser Run, optional MCP packages, and stabilizing two model integrations.
What changed in 0.31.0
- Browser Run now accepts up to 8 internal hostnames that route through your agent, letting the model access dev servers or workspace folders.
- Model code in browserTool runs in its own Dynamic Worker with improved timeout handling; use
browser.cdp()instead ofcdp.send()and readnoticeinstead ofrestartedornewTabs. - MCP packages
/sdkand/serverare now optional peer dependencies; add them to package.json if you use MCP features. - Two model integrations moved out of experimental:
agents/models/ai-sdkandagents/models/pi-ai. - Authentication support for
createMcpHandlerwith/workers-oauth-provider1.x;PiWhenBusynow acceptsreject.
Check before you update
- Remove
CodemodeRuntimeexport andctxoption from browserTool unless using deprecatedcreateBrowserTools. - Import MCP client helpers like
RPCClientTransportfromagents/mcp/clientinstead ofagents/mcp. - Replace
cdp.send()calls withbrowser.cdp()in model code and instructions.
Summarised by AgentGid from Cloudflare's official release notes on GitHub, as reported there; read the original before relying on it. Price, status and release dates come from our daily data.
Cloudflare Agents SDK at a glance
| What it is | Cloudflare's SDK for building stateful agents that run on Workers and Durable Objects. Its optional Pi harness support (Pi Durable) is experimental, and each agents release supports one Pi minor version. |
|---|---|
| Latest version | 0.34.0, Nov 20, 2026. This page is about an earlier release. |
| Release pace | 6 stable releases in the last 30 days; 0.31.0 came 4 days after the previous one |
| Price | Free (OSS). The SDK is open source and free; running agents is billed through Cloudflare Workers and Durable Objects usage. (checked Nov 4, 2026) |
| Downloads, last 7 days | 3.4M up 3.3% |
| Gid Score | 60 #7 in Agent frameworks and SDKs |
Cloudflare Agents SDK overview Monthly changelogAlternatives