dodopayments

Dodo Payments Agent Plugin

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

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 installs plugins in two steps: register the marketplace from your shell, then install the plugin from inside the Codex TUI.

1. Register the marketplace:

   codex plugin marketplace add dodopayments/dodo-agent-plugin
   

2. Open Codex and run the /plugins slash command:

   codex
   

   Then type /plugins, switch to the Dodo Payments marketplace, select the dodopayments plugin, and choose Install plugin.

If you previously added the marketplace before this fix landed and the plugin doesn't appear under /plugins, refresh it:

codex plugin marketplace upgrade dodopayments

Codex CLI does not have a codex plugin install subcommand. Plugin installation always happens through the in-TUI /plugins flow (official docs).

Cursor

Manual install:

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 the plugin to your opencode.json:

{
    "$schema": "https://opencode.ai/config.json",
    "plugin": ["@dodopayments/opencode-plugin"]
}

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.

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:

{
    "plugin": ["@dodopayments/opencode-plugin"],
    "mcp": {
        "dodopayments-api": {
            "type": "local",
            "command": ["npx", "-y", "dodopayments-mcp@latest"],
            "environment": {
                "DODO_PAYMENTS_API_KEY": "dodo_test_...",
                "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
                "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
            },
            "enabled": true
        }
    }
}

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 (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.