Added Code Mode docs & cross-refs. by ask-bonk[bot] · Pull Request #28343 · cloudflare/cloudflare-docs

ask-bonk · 2026-02-14T17:19:20Z

All checks pass with 0 errors and 0 warnings. Here is a summary of the changes:

Changes Made

1. New file: `src/content/docs/agents/api-reference/code-mode.mdx`

Created a new Code Mode documentation page in the Agents SDK API reference section (sidebar order 19, after observability). The page covers:

Opening paragraph explaining what Code Mode is and how it relates to MCP and the Dynamic Worker Loader API
Closed beta callout (note admonition) making clear the underlying Worker Loader API requires beta access for production
Why Code Mode? — rationale for the approach (LLMs are better at writing code than making tool calls)
How it works — numbered step-by-step explanation of the architecture
Usage — before/after code examples using TypeScriptExample components showing traditional tool calling vs. Code Mode with the codemode() wrapper
Configuration — PackageManagers for install, WranglerConfig for the worker_loaders binding, and the CodeModeProxy export
Sandboxing and security — how isolate sandboxing protects against untrusted code
Generated TypeScript API — example of what the auto-generated TypeScript interface looks like
Example: multi-step MCP workflow — concrete example of LLM-generated code chaining multiple MCP calls
Current limitations — experimental status, closed beta, JavaScript-only
Next steps — LinkCard components linking to Dynamic Worker Loader API, McpClient, MCP Tools, and Using AI Models

The page follows all Agents docs conventions: pcx_content_type: concept, AI and MCP tags, component imports from ~/components, TypeScriptExample wrappers, WranglerConfig blocks, and the LinkCard "Next steps" pattern.

2. Updated: `src/content/docs/workers/runtime-apis/bindings/worker-loader.mdx`

Added a "Code Mode" subsection (H3) between the introductory text and the basic usage example. This cross-references Code Mode as a primary use case for the Dynamic Worker Loader API, with links to:

/agents/api-reference/code-mode/ (the new page)
/agents/ (Agents SDK)
/agents/model-context-protocol/ (MCP docs)

Closes #28342

github run

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

github-actions · 2026-02-14T17:20:23Z

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
`/src/content/docs/agents/`	`@irvinebroque`, `@rita3ko`, `@elithrar`, `@thomasgauvin`, `@threepointone`, `@whoiskatrin`, `@cloudflare/pcx-technical-writing`, `@cloudflare/ai-agents`, `@cloudflare/dev-plat-leads`
`/src/content/docs/workers/`	`@cloudflare/workers-docs`, `@GregBrimble`, `@irvinebroque`, `@mikenomitch`, `@korinne`, `@WalshyDev`, `@cloudflare/deploy-config`, `@cloudflare/pcx-technical-writing`, `@cloudflare/wrangler`, `@mattietk`, `@cloudflare/dev-plat-leads`

github-actions · 2026-02-14T17:34:33Z

Preview URL: https://716f6a27.preview.developers.cloudflare.com
Preview Branch URL: https://opencode-issue28342-20260214170959.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/agents/api-reference/code-mode/	https://opencode-issue28342-20260214170959.preview.developers.cloudflare.com/agents/api-reference/code-mode/
https://developers.cloudflare.com/workers/runtime-apis/bindings/worker-loader/	https://opencode-issue28342-20260214170959.preview.developers.cloudflare.com/workers/runtime-apis/bindings/worker-loader/

irvinebroque · 2026-02-14T18:09:10Z

src/content/docs/agents/api-reference/code-mode.mdx

+	LinkCard,
+} from "~/components";
+
+Code Mode is an alternative approach to using [MCP](/agents/model-context-protocol/) tools with AI agents. Instead of presenting MCP tools directly to the LLM, Code Mode converts MCP tool schemas into a TypeScript API and asks the LLM to write code that calls that API. The generated code runs in a secure, sandboxed [V8 isolate](/workers/reference/how-workers-works/) powered by the [Dynamic Worker Loader API](/workers/runtime-apis/bindings/worker-loader/).


This needs to call out more directly that you can use Code Mode with EXISTING MCP Servers

and that Code Mode lets MCP servers expose hundreds or thousands of tools without blowing up the agent's context window. Needs to explain benefits more directly

irvinebroque · 2026-02-14T18:15:23Z

src/content/docs/agents/api-reference/code-mode.mdx

+	LinkCard,
+} from "~/components";
+
+Code Mode is an alternative approach to using [MCP](/agents/model-context-protocol/) tools with AI agents. Instead of presenting MCP tools directly to the LLM, Code Mode converts MCP tool schemas into a TypeScript API and asks the LLM to write code that calls that API. The generated code runs in a secure, sandboxed [V8 isolate](/workers/reference/how-workers-works/) powered by the [Dynamic Worker Loader API](/workers/runtime-apis/bindings/worker-loader/).


/bonk Need to explain that it is not alternative to MCP but better way to use MCP. And make the benefits clearer around how this uses so much less context. You get into that below but I think needs to be moved even further up

irvinebroque · 2026-02-14T18:15:56Z

src/content/docs/agents/api-reference/code-mode.mdx

+
+:::
+
+## Why Code Mode?


/bonk this section needs to call out more clearly that Code Mode means using fewer tokens

irvinebroque · 2026-02-14T18:17:25Z

src/content/docs/agents/api-reference/code-mode.mdx

+:::
+
+## Why Code Mode?
+


/bonk please use this image: https://cf-assets.www.cloudflare.com/zkvhlag99gkb/6DRERHP138FSj3GG0QYj3M/99e8c09b352560b7d4547ca299482c27/image2.png in this section. You will need to take that image file and copy it into this repository, committing it to this repo. Do not just link to that URL. The image is a diagram of code mode vs. traditional MCP

/bonk actually the image should go in the "How it Works" section below

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

ask-bonk · 2026-02-14T18:18:19Z

The "Why Code Mode?" section now leads with two new paragraphs that directly explain the token cost problem with traditional MCP tool calling and how Code Mode solves it. I also added a new top bullet point ("Use far fewer tokens") and strengthened the token-related language in the existing bullets — making it clear that MCP servers can expose hundreds or thousands of tools without blowing up the context window, and that chaining eliminates per-step token overhead.

github run

threepointone · 2026-02-16T19:17:15Z

Should we should hold off on this till we have the codemode sdk rewrite (probably a week or so away)?

Added Code Mode docs & cross-refs.

716f6a2

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

ask-bonk bot requested review from a team, GregBrimble, MattieTK, WalshyDev, irvinebroque, korinne and mikenomitch as code owners February 14, 2026 17:19

ask-bonk bot mentioned this pull request Feb 14, 2026

Code Mode docs in Agents SDK docs #28342

Open

ask-bonk bot requested review from a team, elithrar, rita3ko, thomasgauvin, threepointone and whoiskatrin as code owners February 14, 2026 17:19

github-actions bot added product:workers Related to Workers product product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/m labels Feb 14, 2026

github-actions bot assigned elithrar, irvinebroque, rita3ko, thomasgauvin, threepointone, whoiskatrin, GregBrimble, korinne and MattieTK Feb 14, 2026

github-actions bot assigned mikenomitch Feb 14, 2026

irvinebroque reviewed Feb 14, 2026

View reviewed changes

Emphasize token savings in Why Code Mode

574f57a

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added Code Mode docs & cross-refs.#28343

Added Code Mode docs & cross-refs.#28343
ask-bonk[bot] wants to merge 2 commits intoproductionfrom
opencode/issue28342-20260214170959

ask-bonk bot commented Feb 14, 2026

Uh oh!

github-actions bot commented Feb 14, 2026

Uh oh!

github-actions bot commented Feb 14, 2026

Uh oh!

irvinebroque Feb 14, 2026

Uh oh!

irvinebroque Feb 14, 2026

Uh oh!

irvinebroque Feb 14, 2026

Uh oh!

irvinebroque Feb 14, 2026

Uh oh!

irvinebroque Feb 14, 2026

Uh oh!

ask-bonk bot commented Feb 14, 2026

Uh oh!

threepointone commented Feb 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

Conversation

ask-bonk bot commented Feb 14, 2026

Changes Made

1. New file: src/content/docs/agents/api-reference/code-mode.mdx

2. Updated: src/content/docs/workers/runtime-apis/bindings/worker-loader.mdx

Uh oh!

github-actions bot commented Feb 14, 2026

Uh oh!

github-actions bot commented Feb 14, 2026

Uh oh!

irvinebroque Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

irvinebroque Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

irvinebroque Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

irvinebroque Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

irvinebroque Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

ask-bonk bot commented Feb 14, 2026

Uh oh!

threepointone commented Feb 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

1. New file: `src/content/docs/agents/api-reference/code-mode.mdx`

2. Updated: `src/content/docs/workers/runtime-apis/bindings/worker-loader.mdx`