Add a global default for MCP codemode #49576

Activity

1. github-actions

   assigned

   neriousy

   on Sep 17, 2026
2. opencodejr commented on Oct 28, 2026

   

   opencodejrBot

   on Oct 28, 2026

   More actions

   Thanks for the suggestion! You're asking for a global default for MCP codemode, where each server's own codemode setting would still take precedence. That would let you use direct tools by default and opt chosen servers into Code Mode, or the other way round. Maintainers will consider it.

   Related issues and PRs:

   • [FEATURE]: Make direct MCP servers also available in codemode #54826: make direct MCP servers also available in Code Mode
   • [FEATURE]: ACP - allow disabling codemode for MCP servers passed via session/new #58476: turn off codemode for MCP servers passed through ACP
   • feat(core): default Cloudflare MCP servers to codemode false #57193: PR that defaults Cloudflare MCP servers to codemode: false

   As you mentioned, a plugin can do this until then. Here is a short one. Save it as ~/.config/opencode/plugins/mcp-codemode-default.ts (or put it in .opencode/plugins/ in a project). I haven't type-checked it, so please let us know if it doesn't load:

   import { Plugin } from "@opencode/plugin"
   
   // Global default for MCP `codemode`. Servers that set `codemode` themselves keep their own value.
   const DEFAULT_CODEMODE = false // false = direct tools by default, true = Code Mode by default
   
   export default Plugin.define({
     id: "mcp-codemode-default",
     setup: async (ctx) => {
       const fallback: boolean = ctx.options.codemode ?? DEFAULT_CODEMODE
       await ctx.mcp.transform((editor) => {
         for (const [, server] of editor.list()) {
           if (server.codemode === undefined) server.codemode = fallback
         }
       })
     },
   })

   One caveat: the order in which plugins run decides one case. If this plugin runs before OpenCode's built-in defaults, servers such as Executor would get your global default instead of the built-in codemode: false. Setting codemode on those servers in your config avoids this.

   I agree this is really a config preference, so we've kept the request open for a built-in option.