@dodopayments/opencode-plugin 0.3.2 → 0.4.0

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

@@ -1,17 +1,17 @@
 # Dodo Payments Agent Plugin
 
 [![License](https://img.shields.io/github/license/dodopayments/dodo-agent-plugin.svg?style=flat-square)](./LICENSE)
-[![Version](https://img.shields.io/badge/version-0.2.0-blue.svg?style=flat-square)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.4.0-blue.svg?style=flat-square)](./CHANGELOG.md)
 [![npm](https://img.shields.io/npm/v/@dodopayments/opencode-plugin.svg?style=flat-square)](https://www.npmjs.com/package/@dodopayments/opencode-plugin)
 [![Discord](https://img.shields.io/discord/1305511580854779984?label=discord&style=flat-square)](https://discord.gg/bYqAp4ayYh)
 
-The official Dodo Payments plugin for AI coding agents. Installs eight integration skills and two MCP servers across **Claude Code**, **Codex CLI**, **Cursor**, and **OpenCode** from a single source of truth.
+The official Dodo Payments plugin for AI coding agents. Installs seventeen integration skills and two MCP servers across **Claude Code**, **Codex CLI**, **Cursor**, and **OpenCode** from a single source of truth.
 
 ## What you get
 
 - **Dodo Payments API MCP server** - Live API access (payments, subscriptions, customers, products, refunds, licenses, usage). Authenticates via browser OAuth, no local credentials required.
 - **Dodo Knowledge MCP server** - No credentials. Semantic search over the current Dodo Payments documentation.
-- **Eight agent skills** - Written as `SKILL.md` files with YAML frontmatter. Your agent loads the relevant skill on its own when a task calls for it.
+- **Seventeen agent skills** - Written as `SKILL.md` files with YAML frontmatter. Your agent loads the relevant skill on its own when a task calls for it.
 
 ## Install
 
@@ -71,7 +71,7 @@ OpenCode distributes via npm. Add the plugin to your `opencode.json`:
 }
 ```
 
-Restart OpenCode. Both MCP servers (`dodopayments-api`, `dodo-knowledge`) are registered automatically via the plugin's `config` hook, and the eight skills are auto-discovered from the installed package. No manual `mcp` block required.
+Restart OpenCode. Both MCP servers (`dodopayments-api`, `dodo-knowledge`) are registered automatically via the plugin's `config` hook, and the seventeen skills are auto-discovered from the installed package. No manual `mcp` block required.
 
 If you prefer the local stdio API server with your own API key instead of the default remote OAuth server, declare `dodopayments-api` yourself in `opencode.json` - your entry wins over the plugin default:
 
@@ -95,16 +95,52 @@ If you prefer the local stdio API server with your own API key instead of the de
 
 ## Included Skills
 
+**Getting started**
+
+| Skill | Description |
+|-------|-------------|
+| `best-practices` | SDK setup, environments, API keys, and the canonical checkout-to-webhook architecture |
+| `framework-adapters` | Official `@dodopayments/*` handlers for Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun, Convex |
+| `testing-and-go-live` | Test mode, test payment methods, webhook testing, production launch checklist |
+
+**Accepting payments**
+
+| Skill | Description |
+|-------|-------------|
+| `checkout-integration` | Checkout Sessions, payment links, and overlay checkout |
+| `subscription-integration` | Subscription lifecycle, trials, plan changes, proration, on-demand charges |
+| `mobile-checkout` | In-app checkout for React Native, Flutter, iOS, and Android |
+| `webhook-integration` | Receiving and verifying webhooks via the Standard Webhooks spec |
+
+**Billing models**
+
+| Skill | Description |
+|-------|-------------|
+| `credit-based-billing` | Credit entitlements, balances, ledger, rollover, overage, meter-based deduction |
+| `usage-based-billing` | Meters, event ingestion, aggregation, and per-unit pricing |
+| `license-keys` | License key activation, validation, and instance management |
+
+**Catalog and pricing**
+
+| Skill | Description |
+|-------|-------------|
+| `product-catalog-management` | Products, pricing, add-ons, collections, images, digital delivery |
+| `discounts-and-promotions` | Discount codes, eligibility, stacking, subscription-cycle limits |
+| `localized-pricing` | Localized pricing, adaptive currency, and purchasing power parity |
+
+**Customers and operations**
+
+| Skill | Description |
+|-------|-------------|
+| `customer-management` | Customers, self-service portal, payment methods, wallets |
+| `refunds-and-disputes` | Refunds, disputes and chargebacks, access reconciliation |
+
+**UI and integrations**
+
 | Skill | Description |
 |-------|-------------|
-| `best-practices` | Comprehensive guide to integrating Dodo Payments with best practices |
-| `checkout-integration` | Creating checkout sessions and payment flows |
-| `subscription-integration` | Implementing subscription billing flows |
-| `webhook-integration` | Setting up and handling webhooks for payment events |
-| `usage-based-billing` | Implementing metered billing with events and meters |
-| `credit-based-billing` | Credit entitlements, balances, and metered credit deduction |
-| `license-keys` | Managing license keys for digital products |
-| `billing-sdk` | Using BillingSDK React components |
+| `billing-sdk` | BillingSDK React components for pricing tables and billing UI |
+| `better-auth-integration` | The `@dodopayments/better-auth` plugin for customer sync, checkout, portal |
 
 Skills source: [`dodopayments/skills`](https://github.com/dodopayments/skills) (bundled as a git submodule in `skills-src/`).
 
@@ -146,6 +182,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

@@ -1,6 +1,6 @@
 # @dodopayments/opencode-plugin
 
-Official OpenCode plugin for Dodo Payments. Ships eight integration skills and auto-registers two MCP servers.
+Official OpenCode plugin for Dodo Payments. Ships seventeen integration skills and auto-registers two MCP servers.
 
 This package is part of [`dodopayments/dodo-agent-plugin`](https://github.com/dodopayments/dodo-agent-plugin) - the universal Dodo Payments plugin that also installs into Claude Code, Codex, and Cursor.
 
@@ -18,12 +18,12 @@ Add to your `opencode.json`:
 Restart OpenCode. That's it.
 
 - Both MCP servers are registered automatically via the plugin's `config` hook.
-- The eight skills are auto-discovered from this package's `skills/` directory.
+- The seventeen skills are auto-discovered from this package's `skills/` directory.
 - The first call to `dodopayments-api` opens a browser for OAuth. `dodo-knowledge` needs no auth.
 
 ## What you get
 
-Eight agent skills (auto-loaded when relevant): `best-practices`, `checkout-integration`, `subscription-integration`, `webhook-integration`, `usage-based-billing`, `credit-based-billing`, `license-keys`, `billing-sdk`.
+Seventeen agent skills (auto-loaded when relevant): `best-practices`, `framework-adapters`, `testing-and-go-live`, `checkout-integration`, `subscription-integration`, `mobile-checkout`, `webhook-integration`, `credit-based-billing`, `usage-based-billing`, `license-keys`, `product-catalog-management`, `discounts-and-promotions`, `localized-pricing`, `customer-management`, `refunds-and-disputes`, `billing-sdk`, `better-auth-integration`.
 
 Two MCP servers (registered automatically):
 
@@ -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.2",
+    "version": "0.4.0",
     "description": "Dodo Payments skills and MCP server hints for OpenCode.",
     "type": "module",
     "main": "opencode-plugin/index.js",