@dodopayments/opencode-plugin 0.2.0

package/.mcp.json

@@ -0,0 +1,22 @@
+{
+    "mcpServers": {
+        "dodopayments-api": {
+            "type": "stdio",
+            "command": "npx",
+            "args": [
+                "-y",
+                "mcp-remote@latest",
+                "https://mcp.dodopayments.com/sse"
+            ]
+        },
+        "dodo-knowledge": {
+            "type": "stdio",
+            "command": "npx",
+            "args": [
+                "-y",
+                "mcp-remote@latest",
+                "https://knowledge.dodopayments.com/mcp"
+            ]
+        }
+    }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dodo Payments
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,195 @@
+# 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)
+[![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.
+
+## 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.
+
+## Install
+
+### Claude Code
+
+```bash
+claude plugins marketplace add dodopayments/dodo-agent-plugin
+claude plugins install dodopayments@dodopayments
+```
+
+The API MCP server uses browser OAuth by default, so no keys are required at install time. The first time your agent calls a Dodo tool, you'll be prompted to sign in.
+
+### Codex CLI
+
+Codex reads `.claude-plugin/marketplace.json` natively, so the same repo works:
+
+```bash
+codex plugin marketplace add dodopayments/dodo-agent-plugin
+codex plugin install dodopayments@dodopayments
+```
+
+### Cursor
+
+Manual install:
+
+```bash
+git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin
+```
+
+Restart Cursor. The plugin loads skills from `.claude/skills/` (via Cursor's Claude Code compat) and MCP servers from `.mcp.json`.
+
+### OpenCode
+
+OpenCode distributes via npm. Add to your `opencode.json`:
+
+```jsonc
+{
+    "$schema": "https://opencode.ai/config.json",
+    "plugin": ["@dodopayments/opencode-plugin"],
+    "mcp": {
+        "dodopayments-api": {
+            "type": "local",
+            "command": ["npx", "-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"],
+            "enabled": true
+        },
+        "dodo-knowledge": {
+            "type": "local",
+            "command": ["npx", "-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"],
+            "enabled": true
+        }
+    }
+}
+```
+
+OpenCode auto-discovers the eight skills from the installed package. Restart OpenCode to pick up the new config.
+
+## Included Skills
+
+| 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 |
+
+Skills source: [`dodopayments/skills`](https://github.com/dodopayments/skills) (bundled as a git submodule in `skills-src/`).
+
+## Included MCP Servers
+
+| Server | Purpose | Auth |
+|--------|---------|------|
+| `dodopayments-api` | Live API access (payments, subscriptions, customers, products, refunds, licenses, usage) | OAuth (browser) |
+| `dodo-knowledge` | Semantic search over the Dodo Payments documentation | None |
+
+Both servers are wired through `mcp-remote` so they run in any MCP-compatible client.
+
+## Configure (optional, Claude Code)
+
+If you prefer to run the API MCP locally with an API key instead of the remote SSE server, open `/plugins` in Claude Code, select **Dodo Payments**, and choose **Configure options**. Fill in:
+
+- `dodo_api_key` - your `dodo_test_...` or `dodo_live_...` key
+- `dodo_webhook_key` - your webhook signing secret
+- `dodo_environment` - `test_mode` or `live_mode`
+
+Then edit `.mcp.json` to point `dodopayments-api` at the local stdio server:
+
+```json
+{
+    "mcpServers": {
+        "dodopayments-api": {
+            "type": "stdio",
+            "command": "npx",
+            "args": ["-y", "dodopayments-mcp@latest"],
+            "env": {
+                "DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
+                "DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
+                "DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
+            }
+        }
+    }
+}
+```
+
+Run `/reload-plugins` to apply changes to your current session.
+
+## A prompt to try first
+
+Once the plugin is active, try:
+
+```
+Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.
+```
+
+Your agent will load the `webhook-integration` skill, use the `dodo-knowledge` MCP to pull the latest payload shapes, and write a handler with signature verification following the Standard Webhooks spec.
+
+## Local development
+
+Clone with the skills submodule:
+
+```bash
+git clone --recurse-submodules https://github.com/dodopayments/dodo-agent-plugin.git
+cd dodo-agent-plugin
+```
+
+Validate the Claude Code plugin and marketplace:
+
+```bash
+claude plugin validate .
+```
+
+Load the plugin directly for a dev session:
+
+```bash
+claude --plugin-dir ./dodo-agent-plugin
+```
+
+Refresh the bundled skills to the latest upstream version:
+
+```bash
+git submodule update --remote skills-src
+```
+
+## For maintainers
+
+The repo is configured to publish the OpenCode npm package on every GitHub Release.
+
+**One-time setup (already done for this repo):**
+
+- npm scope `@dodopayments` exists and is owned by Dodo Payments.
+- GitHub Actions secret `NPM_TOKEN` is provisioned with publish rights to the `@dodopayments` scope.
+
+**Release workflow:**
+
+1. Bump the version in `.claude-plugin/plugin.json`.
+2. Run `node scripts/sync-manifests.mjs` to propagate the version to Cursor, Codex, npm, and marketplace manifests.
+3. Commit and tag.
+4. Create a GitHub Release - the `Publish @dodopayments/opencode-plugin` workflow runs automatically and publishes to npm with provenance.
+
+**Manual dry-run:**
+
+- Workflow dispatch with `dry_run: true` to validate the release pipeline without publishing.
+
+**CI check:**
+
+- `node scripts/sync-manifests.mjs --check` is run by the workflow and fails the release if any manifest is out of sync.
+
+## Resources
+
+- [Dodo Payments documentation](https://docs.dodopayments.com)
+- [Agent Skills docs](https://docs.dodopayments.com/developer-resources/agent-skills)
+- [MCP Server docs](https://docs.dodopayments.com/developer-resources/mcp-server)
+- [Skills source repo](https://github.com/dodopayments/skills)
+- [Discord community](https://discord.gg/bYqAp4ayYh)
+
+## License
+
+MIT - see [LICENSE](./LICENSE).

package/opencode-plugin/README.md

@@ -0,0 +1,42 @@
+# @dodopayments/opencode-plugin
+
+OpenCode plugin that ships the Dodo Payments agent skills and references the Dodo Payments API and docs 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.
+
+## Install
+
+Add to your `opencode.json`:
+
+```jsonc
+{
+    "$schema": "https://opencode.ai/config.json",
+    "plugin": ["@dodopayments/opencode-plugin"],
+    "mcp": {
+        "dodopayments-api": {
+            "type": "local",
+            "command": ["npx", "-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"],
+            "enabled": true
+        },
+        "dodo-knowledge": {
+            "type": "local",
+            "command": ["npx", "-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"],
+            "enabled": true
+        }
+    }
+}
+```
+
+Then restart OpenCode. The eight Dodo Payments skills are auto-discovered from this package's `skills/` directory.
+
+## What you get
+
+- **Eight agent skills** (auto-loaded by OpenCode when relevant):
+    - `best-practices`, `checkout-integration`, `subscription-integration`, `webhook-integration`, `usage-based-billing`, `credit-based-billing`, `license-keys`, `billing-sdk`.
+- **Two referenced MCP servers** (you configure them in `opencode.json` as shown above):
+    - `dodopayments-api` - live API access via OAuth.
+    - `dodo-knowledge` - semantic search over Dodo Payments documentation.
+
+## License
+
+MIT. See [LICENSE](../LICENSE).

package/opencode-plugin/index.js

@@ -0,0 +1,30 @@
+// @dodopayments/opencode-plugin
+//
+// OpenCode plugin entry point for Dodo Payments.
+//
+// This plugin exists to make `@dodopayments/opencode-plugin` installable
+// from npm so users can reference it in their `opencode.json` "plugin" array.
+// It registers no runtime hooks - the value of this package is:
+//
+//   1. The bundled skills/ directory (OpenCode auto-discovers SKILL.md files
+//      from installed packages, so the 8 Dodo Payments skills become
+//      available once this package is installed).
+//
+//   2. The documented .mcp.json and opencode.json reference snippets, so
+//      users know exactly which MCP servers to add to their config.
+//
+// If future versions of this plugin need runtime behavior (e.g. injecting
+// Dodo-specific tools, hooking chat.message, etc.), add them to the returned
+// Hooks object. All Hooks fields are optional - see @opencode-ai/plugin types.
+//
+// @see https://opencode.ai/docs/plugins
+// @see https://docs.dodopayments.com/developer-resources/agent-skills
+
+/**
+ * @typedef {import("@opencode-ai/plugin").Plugin} Plugin
+ */
+
+/** @type {Plugin} */
+const dodopayments = async () => ({});
+
+export default dodopayments;

package/opencode.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "https://opencode.ai/config.json",
+    "plugin": [
+        "@dodopayments/opencode-plugin"
+    ],
+    "mcp": {
+        "dodopayments-api": {
+            "type": "local",
+            "command": [
+                "npx",
+                "-y",
+                "mcp-remote@latest",
+                "https://mcp.dodopayments.com/sse"
+            ],
+            "enabled": true
+        },
+        "dodo-knowledge": {
+            "type": "local",
+            "command": [
+                "npx",
+                "-y",
+                "mcp-remote@latest",
+                "https://knowledge.dodopayments.com/mcp"
+            ],
+            "enabled": true
+        }
+    }
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@dodopayments/opencode-plugin",
+    "version": "0.2.0",
+    "description": "Dodo Payments skills and MCP server hints for OpenCode.",
+    "type": "module",
+    "main": "opencode-plugin/index.js",
+    "exports": {
+        ".": "./opencode-plugin/index.js"
+    },
+    "files": [
+        "opencode-plugin/",
+        "skills/",
+        ".mcp.json",
+        "opencode.json",
+        "LICENSE"
+    ],
+    "scripts": {
+        "sync": "node scripts/sync-manifests.mjs",
+        "sync:check": "node scripts/sync-manifests.mjs --check",
+        "prepack": "node scripts/build-skills-for-npm.mjs materialize",
+        "postpack": "node scripts/build-skills-for-npm.mjs restore && git checkout skills/"
+    },
+    "keywords": [
+        "opencode",
+        "opencode-plugin",
+        "dodopayments",
+        "payments",
+        "billing",
+        "subscriptions",
+        "mcp",
+        "skills"
+    ],
+    "author": "Dodo Payments <support@dodopayments.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/dodopayments/dodo-agent-plugin.git"
+    },
+    "homepage": "https://docs.dodopayments.com/developer-resources/agent-skills",
+    "bugs": "https://github.com/dodopayments/dodo-agent-plugin/issues",
+    "peerDependencies": {
+        "@opencode-ai/plugin": ">=1.0.0"
+    },
+    "peerDependenciesMeta": {
+        "@opencode-ai/plugin": {
+            "optional": true
+        }
+    },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    }
+}