Build with AI Coding Agents

The Dodo Agent Plugin wires two MCP servers and seventeen integration skills into your AI coding agent in a single install. It works with Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro, and OpenCode. Gemini CLI gets the two MCP servers only. The MCP servers and skills CLI work with any MCP-compatible client. The plugin follows the Agent Plugins 1.0.0 specification, so clients with native support load it directly from the root plugin.json and mcp.json. Clients that predate the spec load the same content through generated compatibility manifests.

Three primitives, one plugin. The Agent Plugin bundles everything you need:

API MCP server — live access to payments, subscriptions, customers, products, refunds, licenses, and usage. Authenticates via browser OAuth (no local keys required).
Knowledge MCP server — semantic search across all Dodo Payments documentation. No credentials needed.
Seventeen agent skills — cheat sheets your agent loads on demand for checkout, subscriptions, webhooks, usage-based and credit-based billing, license keys, product catalog, discounts, localized pricing, mobile checkout, refunds and disputes, customer management, framework adapters, BillingSDK, Better Auth, testing and go-live, and best practices.

Install the plugin

Choose your coding agent below. Every install adds both MCP servers; all of them except Gemini CLI also add the seventeen skills.

Claude Code

Install from the marketplace:

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

The API MCP server uses browser OAuth by default — no keys required at install time. The first time your agent calls a Dodo tool, you’ll be prompted to sign in.

Dodo Agent Plugin on GitHub

Source code, configuration options, and local development instructions

Codex CLI

Codex installs plugins in two steps: register the marketplace from your shell, then install the plugin from inside the Codex TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

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.

Both MCP servers and all seventeen skills are registered automatically once the plugin is installed.

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

If you previously added the marketplace and the plugin doesn’t appear under /plugins, refresh it:

codex plugin marketplace upgrade dodopayments

Cursor

Manual install — clone the repo into Cursor’s local plugins directory:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

Restart Cursor. The plugin loads skills from skills/ and MCP servers from .mcp.json, as declared in .cursor-plugin/plugin.json.

Recent Cursor builds also recognize Agent Plugins 1.0.0 directly and accept either .cursor-plugin/marketplace.json or .claude-plugin/marketplace.json as a marketplace source. This plugin ships .claude-plugin/marketplace.json — use that path. The generated .cursor-plugin/plugin.json is kept for older builds.

Versions before 0.5.0 shipped skills/ as symlinks into a git submodule, so this clone produced a plugin with no working skills. Skills now ship as real files. If you installed an earlier version, delete the directory and re-clone.

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. No manual mcp block required.Skills need one extra line. OpenCode does not scan installed packages for skills, so point it at the package’s skills/ directory yourself:

npm install --save-dev @dodopayments/opencode-plugin

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

Relative skills.paths entries resolve against the project directory, so the package must exist in that project’s node_modules — OpenCode’s own plugin cache is a different location. An absolute path works too, and avoids the local-install requirement.

A skills path that does not exist is ignored silently. Verify rather than assume:

opencode run "List every skill available to you by name."

You should see all seventeen. Versions before 0.5.0 documented these skills as auto-discovered — they were not, so OpenCode users had MCP servers but no skills.

VS Code / GitHub Copilot

Clone the repo anywhere, then register it:

git clone https://github.com/dodopayments/dodo-agent-plugin.git

Open the Chat view, go to Plugins, and add the cloned folder. You can also register it directly in settings.json:

{
  "chat.pluginLocations": { "~/dodo-agent-plugin": true }
}

The key is a path, the value enables it. Absolute paths and ~/ both work; a relative path resolves against each workspace folder. The setting is read live, so a running window picks it up without a restart. Skills load from skills/, and both MCP servers load from .mcp.json.

chat.pluginLocations is marked experimental and is a restricted setting, so the workspace must be trusted for it to apply. Agent-plugin support overall is a preview feature governed by chat.plugins.enabled, which is on by default — you only need to set it if your organization disables it by policy.

VS Code does not key off the Agent Plugins $schema. Its loader probes .plugin/plugin.json, then .claude-plugin/plugin.json, then a root plugin.json, and defaults MCP to .mcp.json rather than mcp.json. Because this repo ships a generated .claude-plugin/plugin.json, VS Code loads it through that compatibility branch and gets the mcp-remote bridge rather than the native transports in mcp.json. Everything works — the path differs.

Kiro

Kiro reads the Agent Plugins manifest natively and loads this as a Power.

Clone the repository

git clone https://github.com/dodopayments/dodo-agent-plugin.git

Open the Powers panel

In Kiro, open the Powers panel — the Ghosty icon with the lightning bolt.

Import the folder

Choose Add Custom Power → Import power from a folder, select the cloned directory (the one containing plugin.json), and click Install.

Skills load from skills/, MCP servers from mcp.json, and Kiro-specific presentation comes from the dev.kiro extension namespace in plugin.json.

For plugins in the Agent Plugins format, Kiro manages MCP servers internally — they are not written to your user-level ~/.kiro/settings/mcp.json, so don’t expect to find them there. Kiro can also install a Power directly from a GitHub URL; see Kiro’s install docs.

Gemini CLI (MCP only)

Gemini CLI has no agent-skill primitive, so only the two MCP servers are available — the seventeen skills are not. dodo-knowledge still covers a good share of what the skills provide, and it stays current automatically.

git clone https://github.com/dodopayments/dodo-agent-plugin.git \
  ~/.gemini/extensions/dodopayments

Restart Gemini CLI. gemini-extension.json at the repo root is the manifest.

Using a different agent? The MCP Server and Agent Skills guides cover Claude Desktop, Windsurf, Cline, Zed, and any MCP-compatible client.

What you get

Once the plugin is installed, your agent has access to two MCP servers and seventeen skills.

MCP servers

Server	Purpose	Auth
`dodopayments-api`	Live API access — payments, subscriptions, customers, products, refunds, licenses, usage	OAuth (browser)
`dodo-knowledge`	Semantic search across all Dodo Payments documentation	None

Both servers speak Streamable HTTP. The canonical mcp.json declares them natively (type: "streamable-http"), which is what spec-native clients such as Codex CLI and Kiro use. The generated compatibility manifest .mcp.json wires the same two endpoints through mcp-remote instead, so they also run in clients that cannot dial Streamable HTTP directly — Claude Code, VS Code, and Cursor via the git-clone install documented above, whose .cursor-plugin/plugin.json points at .mcp.json.

Agent skills

Skill	Description
`dodo-best-practices`	SDK setup, environments, API keys, and the canonical checkout-to-webhook architecture
`framework-adapters`	Official `@dodopayments/*` route handlers for Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun, and Convex
`testing-and-go-live`	Test mode, test payment methods, webhook testing, and the production launch checklist
`checkout-integration`	Checkout Sessions, payment links, and overlay or inline checkout
`subscription-integration`	Subscription lifecycle, trials, plan changes, proration, and on-demand charges
`mobile-checkout`	In-app checkout for React Native, Flutter, iOS, and Android
`webhook-integration`	Receiving and verifying webhooks using the Standard Webhooks specification
`credit-based-billing`	Credit entitlements, balances, ledger, rollover, overage, and meter-based deduction
`usage-based-billing`	Meters, event ingestion, aggregation, and per-unit pricing
`license-keys`	License key activation, validation, and instance management
`product-catalog-management`	Products, pricing, add-ons, collections, images, and digital product delivery
`discounts-and-promotions`	Discount codes, eligibility rules, stacking, and subscription-cycle limits
`localized-pricing`	Localized pricing, adaptive currency, and purchasing power parity
`customer-management`	Customers, the self-service portal, saved payment methods, and wallets
`refunds-and-disputes`	Issuing refunds, handling disputes and chargebacks, and reconciling access
`billing-sdk`	BillingSDK React components for pricing tables and billing UI
`better-auth-integration`	The `@dodopayments/better-auth` plugin for customer sync, checkout, and portal access

Skills load automatically — your agent picks the right one when it detects a relevant task. See the Agent Skills documentation for the full list and individual installation.

Try this prompt 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.

Client support

Clients with an Agent Plugin install

One install wires both MCP servers, plus the skills on every client that has a skill primitive.

Agent	Install	Skills	MCP servers
Claude Code	marketplace command	17	2
Codex CLI	marketplace command	17	2
Cursor	git clone	17	2
VS Code / GitHub Copilot	git clone	17	2
Kiro	git clone	17	2
OpenCode	npm	17	2
Gemini CLI	git clone	0	2

OpenCode needs one extra skills.paths entry before its seventeen skills load — see the install section above.
Gemini CLI has no agent-skill primitive, so skills are unavailable there by design.

Other MCP-compatible clients

These have no Agent Plugin install. Configure the two MCP servers by hand, and add skills through the Skills CLI where supported.

Agent	MCP servers	Skills
Claude Desktop	MCP Server guide	not supported
Windsurf	MCP Server guide	Skills CLI
Cline / Zed / others	MCP Server guide	Skills CLI

Docs built for agents

Every Dodo Payments documentation page is available in a format optimized for AI consumption:

Full docs index: docs.dodopayments.com/llms.txt — serves the complete documentation index for context ingestion.
Plain markdown: Append .md to any documentation URL to get the raw markdown version (e.g., /api-reference/introduction.md).
Source repository: github.com/dodopayments/dodo-docs — clone for offline indexing.

What your agent can do

With the plugin installed, your coding agent can:

Create checkout sessions and payment links — One-time payments and subscriptions
Stand up subscription and usage-based billing end-to-end — Subscriptions, Usage-based billing, Credit-based billing
Generate Standard Webhooks–compliant handlers with signature verification — Webhooks
Mount route handlers in your framework using the official adapters — Framework adaptors
Wire BillingSDK React components for pricing tables and subscription management — BillingSDK
Author license-key flows for digital products — License keys
Implement credit-based billing with entitlements, balances, rollover, and overage — Credits
Build and manage your product catalog with add-ons and collections — Products, Add-ons, Product collections
Add discounts and localized pricing — Discount codes, Localized pricing, Adaptive currency
Ship mobile in-app checkout for React Native, Flutter, iOS, and Android — Mobile integration
Handle refunds, disputes, and customer self-service — Refunds, Disputes, Customer portal
Test the integration and go live safely — Test mode vs live mode

Security and best practices

Never commit production API keys. Use test mode during development. The Agent Plugin uses browser OAuth by default — only switch to local API keys if your workflow requires it.

Use test mode first. Sandbox your integration with dodo_test_... keys before going live. See Test Mode vs Live Mode.
OAuth is the default. The Agent Plugin authenticates via browser OAuth (no local secrets). Only use API-key mode if you need it — see the Configure section below.
Review agent-generated code. Always verify webhook handlers include signature verification following the Standard Webhooks spec.

Configure with an API key

By default, the Agent Plugin uses the remote MCP server with browser OAuth — no local credentials needed. If your workflow requires a local API key (e.g., CI environments, headless servers), you can switch to stdio mode.

Local API key mode — Claude Code

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:

{
  "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.

Local API key mode — OpenCode

Declare dodopayments-api yourself in opencode.json — your entry wins over the plugin’s default remote server:

{
  "$schema": "https://opencode.ai/config.json",
  "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
    }
  }
}

Restart OpenCode to apply.

Next steps

MCP Server

Full reference for both MCP servers — all supported clients, configuration, and available tools

Agent Skills

Individual skill installation, skill reference, and per-agent setup instructions

Sentra IDE Assistant

AI-powered billing assistant for VS Code, Cursor, and Windsurf — ask, build, and plan in your editor

API Reference

Complete OpenAPI reference for all Dodo Payments endpoints

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Install the plugin

Dodo Agent Plugin on GitHub

What you get

MCP servers

Agent skills

Try this prompt first

Client support

Clients with an Agent Plugin install

Other MCP-compatible clients

Docs built for agents

What your agent can do

Security and best practices

Configure with an API key

Next steps

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

​Install the plugin

Dodo Agent Plugin on GitHub

​What you get

​MCP servers

​Agent skills

​Try this prompt first

​Client support

​Clients with an Agent Plugin install

​Other MCP-compatible clients

​Docs built for agents

​What your agent can do

​Security and best practices

​Configure with an API key

​Next steps

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

Install the plugin

What you get

MCP servers

Agent skills

Try this prompt first

Client support

Clients with an Agent Plugin install

Other MCP-compatible clients

Docs built for agents

What your agent can do

Security and best practices

Configure with an API key

Next steps