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)?

threepointone · 2026-02-20T12:31:28Z

I just landed the codemode doc, so we just need to cross reference it now https://developers.cloudflare.com/agents/api-reference/codemode/

elithrar · 2026-02-20T15:01:48Z

/bonk review the comments from @irvinebroque and the last comment from @threepointone re: codemode doc landing. Ensure this feedback is incorporated into the changes here.

Then pull in the changes from #28480 so they are in this PR (as a single PR) and close as "addressing in #28480".

Review against our styleguide and docs best practices.

@threepointone

Remove the draft Code Mode page (code-mode.mdx) which is superseded by the codemode doc that @threepointone landed on production. Restore codemode.mdx from production and update worker-loader.mdx cross-refs to point to /agents/api-reference/codemode/. Addressing feedback from #28480.

ask-bonk · 2026-02-20T15:08:09Z

Addressing in #28480. @threepointone landed the codemode doc on production, so this PR now:

Removes the draft code-mode.mdx (superseded by the landed codemode.mdx)
Restores codemode.mdx from production (no changes)
Updates worker-loader.mdx with a cross-reference section pointing to /agents/api-reference/codemode/
Fixes heading levels (### → ##) and style guide compliance in the cross-ref section

The original feedback from @irvinebroque (token cost framing, MCP compatibility, benefits clarity) is all addressed in the production codemode doc that @threepointone rewrote.

ask-bonk · 2026-02-20T15:08:31Z

Here is a summary of what was done:

Summary

Feedback incorporated

@threepointone (latest): "I just landed the codemode doc" — the rewritten codemode SDK doc already exists on production at /agents/api-reference/codemode/. Our draft code-mode.mdx is now redundant.
@irvinebroque: Token cost framing, MCP compatibility emphasis, clearer benefits — all addressed in the production codemode doc that @threepointone rewrote with the SDK rewrite.

Changes made

Deleted src/content/docs/agents/api-reference/code-mode.mdx — the old draft page from this PR, superseded by the landed codemode.mdx
Restored src/content/docs/agents/api-reference/codemode.mdx from production — the rewritten doc @threepointone landed (unchanged)
Updated src/content/docs/workers/runtime-apis/bindings/worker-loader.mdx:
- Cross-reference section now points to /agents/api-reference/codemode/ (not the old /code-mode/)
- Fixed heading levels (### → ##) for proper hierarchy
- Tightened prose per style guide (one idea per sentence, removed duplicate link)
- Formatting cleanup (consistent indentation, - list markers)

Validation

npm run check passes with 0 errors, 0 warnings
No remaining references to the old /code-mode/ path
PR Added Code Mode docs & cross-refs. #28343 commented with "addressing in Add Code Mode MCP server to docs #28480"

github run

elithrar · 2026-02-20T15:11:37Z

/bonk I don't see the MCP server docs changes from #28480 here. Please address that. Check your work.

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

ask-bonk · 2026-02-20T15:17:55Z

All changes applied and validated. Here is a summary of what was done:

Changes made

Applied the MCP server docs changes from PR #28480 to src/content/docs/agents/model-context-protocol/mcp-servers-for-cloudflare.mdx with the following style guide improvements:

Content from PR #28480 (applied)

New "Cloudflare API MCP server" section (H2) — describes the unified MCP server at mcp.cloudflare.com, the search() and execute() tools, and the token savings via Codemode
Token comparison table — Native MCP (~1.17M tokens) vs Codemode (~1K tokens)
Connection instructions — JSON config snippet for MCP clients, OAuth flow, API token auth option
Agent/IDE plugin install instructions — Claude Code, Cursor, npx skills, clone/copy with directory table
Reorganized existing server table under new "Product-specific MCP servers" heading
Bug fixes: streamble-http → streamable-http typo, MCP Servers/MCP Client → lowercase

Style guide fixes applied on top of PR #28480

"Code Mode" → "Codemode" to match the actual page title at /agents/api-reference/codemode/
"For more details" → "For more information, refer to" (standard phrasing)
"Installing via" → "Install via" (imperative mood for heading)
Bold pseudo-headings (**Claude Code**, **Cursor**, etc.) → proper #### H4 headings for correct heading hierarchy
Vague [docs] link text in the agent table → descriptive text like "Claude Code skills", "Cursor skills", etc.
Cursor Marketplace bolded as a UI element

Validation

npm run check: 0 errors, 0 warnings

github run

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>

elithrar mentioned this pull request Feb 20, 2026

Add Code Mode MCP server to docs #28480

Closed

Add MCP server docs from PR #28480

8abd471

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

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!

threepointone commented Feb 20, 2026

Uh oh!

elithrar commented Feb 20, 2026

Uh oh!

ask-bonk bot commented Feb 20, 2026

Uh oh!

ask-bonk bot commented Feb 20, 2026

Summary

Feedback incorporated

Changes made

Validation

Uh oh!

elithrar commented Feb 20, 2026

Uh oh!

ask-bonk bot commented Feb 20, 2026

Changes made

Content from PR #28480 (applied)

Style guide fixes applied on top of PR #28480

Validation

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

Comments

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

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