@dodopayments/opencode-plugin 0.3.1 → 0.3.3

package/.mcp.json

@@ -7,7 +7,8 @@
                 "-y",
                 "mcp-remote@latest",
                 "https://mcp.dodopayments.com/sse"
-            ]
+            ],
+            "enabled": true
         },
         "dodo-knowledge": {
             "type": "stdio",
@@ -16,7 +17,8 @@
                 "-y",
                 "mcp-remote@latest",
                 "https://knowledge.dodopayments.com/mcp"
-            ]
+            ],
+            "enabled": true
         }
     }
 }

package/README.md

@@ -146,6 +146,50 @@ Then edit `.mcp.json` to point `dodopayments-api` at the local stdio server:
 
 Run `/reload-plugins` to apply changes to your current session.
 
+## Enable / disable individual MCP servers
+
+Both MCPs ship enabled by default. You can turn either one off independently.
+
+### OpenCode
+
+The npm plugin reads two environment variables before registering MCPs:
+
+| Env var | Effect |
+|---|---|
+| `DODO_DISABLE_API_MCP=1` | Skips registering `dodopayments-api` |
+| `DODO_DISABLE_KNOWLEDGE_MCP=1` | Skips registering `dodo-knowledge` |
+
+Truthy values: `1`, `true`, `yes`, `on` (case-insensitive). Export the var in your shell profile or set it inline:
+
+```bash
+DODO_DISABLE_API_MCP=1 opencode
+```
+
+### Claude Code, Codex CLI, Cursor
+
+These clients load MCPs from the static `.mcp.json` shipped with the plugin. To disable a server, override its entry in your own project-level config and set `"enabled": false`.
+
+**Claude Code** - edit `.mcp.json` at your project root (or run `claude mcp disable dodopayments-api`):
+
+```json
+{
+    "mcpServers": {
+        "dodopayments-api": {
+            "type": "stdio",
+            "command": "npx",
+            "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"],
+            "enabled": false
+        }
+    }
+}
+```
+
+Run `/reload-plugins` to apply.
+
+**Codex CLI / Cursor** - the same `enabled: false` pattern works in any project-level `.mcp.json` that overrides the plugin's bundled file. Restart the client after editing.
+
+> Per-MCP toggles inside the Claude Code `/plugin` UI are tracked upstream in [anthropics/claude-code#27105](https://github.com/anthropics/claude-code/issues/27105) and [#46373](https://github.com/anthropics/claude-code/issues/46373). Until those land, the `enabled: false` override above is the supported path.
+
 ## A prompt to try first
 
 Once the plugin is active, try:

package/opencode-plugin/README.md

@@ -32,6 +32,25 @@ Two MCP servers (registered automatically):
 | `dodopayments-api` | Live API access (payments, subscriptions, customers, products, refunds, licenses, usage) | OAuth (browser) on first call |
 | `dodo-knowledge` | Semantic search over the Dodo Payments documentation | None |
 
+## Enable / disable individual MCP servers
+
+Both MCPs ship enabled. To disable either one, set the matching env var to `1` (or `true`) before launching OpenCode:
+
+| Env var | Effect |
+|---|---|
+| `DODO_DISABLE_API_MCP=1` | Skips registering `dodopayments-api` |
+| `DODO_DISABLE_KNOWLEDGE_MCP=1` | Skips registering `dodo-knowledge` |
+
+```bash
+# Disable just the API server (keep docs search)
+DODO_DISABLE_API_MCP=1 opencode
+
+# Disable both
+DODO_DISABLE_API_MCP=1 DODO_DISABLE_KNOWLEDGE_MCP=1 opencode
+```
+
+Persist the toggle by exporting the var in your shell profile or a project `.env` file your shell auto-loads. Truthy values: `1`, `true`, `yes`, `on` (case-insensitive). Anything else - including unset - keeps the MCP enabled.
+
 ## Overriding the defaults
 
 The plugin registers MCPs with nullish-assign semantics, so anything you declare in your own `opencode.json` wins. Example - swap the default remote OAuth server for the local stdio server with your own API key:

package/opencode-plugin/index.js

@@ -1,22 +1,13 @@
 // @dodopayments/opencode-plugin
-//
-// Registers the Dodo Payments MCP servers via OpenCode's `config` plugin
-// hook so users do not need to paste an `mcp: { ... }` block into their
-// `opencode.json`. The bundled skills/ directory is auto-discovered by
-// OpenCode separately.
-//
+// Registers Dodo Payments MCP servers via OpenCode's `config` hook.
 // @see https://opencode.ai/docs/plugins
-// @see https://docs.dodopayments.com/developer-resources/agent-skills
 
 /**
  * @typedef {import("@opencode-ai/plugin").Plugin} Plugin
  */
 
-// OpenCode loads the user's opencode.json before invoking plugin `config`
-// hooks on the same mutable config object. Nullish-assign (`??=`) therefore
-// lets a user override any entry here by declaring the same key in their
-// own opencode.json - e.g. swapping the default remote OAuth server for the
-// local stdio `dodopayments-mcp` with their own API key.
+// Nullish-assign (`??=`) lets users override any entry by declaring the
+// same MCP key in their own opencode.json.
 const DODO_MCP_SERVERS = {
     "dodopayments-api": {
         type: "local",
@@ -30,11 +21,27 @@ const DODO_MCP_SERVERS = {
     },
 };
 
+// Env vars chosen over opencode.json config because OpenCode's top-level
+// schema is strict and rejects unknown keys (anomalyco/opencode#9161).
+const DISABLE_FLAGS = {
+    "dodopayments-api": "DODO_DISABLE_API_MCP",
+    "dodo-knowledge": "DODO_DISABLE_KNOWLEDGE_MCP",
+};
+
+const TRUTHY = new Set(["1", "true", "yes", "on"]);
+
+function isDisabled(envVarName) {
+    const raw = process.env[envVarName];
+    if (raw === undefined || raw === null || raw === "") return false;
+    return TRUTHY.has(String(raw).trim().toLowerCase());
+}
+
 /** @type {Plugin} */
 const dodopayments = async () => ({
     config: async (config) => {
         config.mcp ??= {};
         for (const [name, entry] of Object.entries(DODO_MCP_SERVERS)) {
+            if (isDisabled(DISABLE_FLAGS[name])) continue;
             config.mcp[name] ??= entry;
         }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dodopayments/opencode-plugin",
-    "version": "0.3.1",
+    "version": "0.3.3",
     "description": "Dodo Payments skills and MCP server hints for OpenCode.",
     "type": "module",
     "main": "opencode-plugin/index.js",