Skip to main content
The Dodo Agent Plugin wires two MCP servers and eight integration skills into your AI coding agent in a single install. It works with Claude Code, Codex CLI, Cursor, and OpenCode — and the MCP servers and skills CLI work with any MCP-compatible client.
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.
  • Eight agent skills — cheat sheets your agent loads on demand for checkout, subscriptions, webhooks, usage-based billing, credit-based billing, license keys, BillingSDK, and best practices.

​
Install the plugin

Choose your coding agent below. The install adds both MCP servers and all eight skills automatically.

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 reads .claude-plugin/marketplace.json natively, so the same plugin repo works:
codex plugin marketplace add dodopayments/dodo-agent-plugin
codex plugin install dodopayments@dodopayments
Both MCP servers and all eight skills are registered automatically.
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 .claude/skills/ (via Cursor’s Claude Code compatibility layer) and MCP servers from .mcp.json.
Cursor marketplace support is coming. For now, use the manual install above.
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.
Using a different agent? The MCP Server and Agent Skills guides cover Cursor, Claude Desktop, VS Code, 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 eight skills.

​
MCP servers

ServerPurposeAuth
dodopayments-apiLive API access — payments, subscriptions, customers, products, refunds, licenses, usageOAuth (browser)
dodo-knowledgeSemantic search across all Dodo Payments documentationNone
Both servers are wired through mcp-remote so they run in any MCP-compatible client.

​
Agent skills

SkillDescription
best-practicesComprehensive guide to integrating Dodo Payments with best practices
checkout-integrationCreating checkout sessions and payment flows
subscription-integrationImplementing subscription billing flows
webhook-integrationSetting up and handling webhooks for payment events
usage-based-billingImplementing metered billing with events and meters
credit-based-billingCredit entitlements, balances, and metered credit deduction
license-keysManaging license keys for digital products
billing-sdkUsing BillingSDK React components
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.

​
Other supported agents

The Agent Plugin covers Claude Code, Codex CLI, Cursor, and OpenCode. If you use a different agent, connect to Dodo Payments through the MCP servers and skills CLI:
AgentFastest pathAlso supports
Claude CodeAgent Plugin (one command)MCP server, individual skills
Codex CLIAgent Plugin (one command)MCP server
CursorAgent Plugin (git clone)MCP server config, skills CLI
OpenCodeAgent Plugin (npm)MCP server config, skills CLI
GitHub Copilot (VS Code)MCP Server guideSkills CLI
Claude DesktopMCP Server guide—
WindsurfMCP Server guideSkills CLI
Cline / Zed / othersMCP Server guideSkills 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:

​
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.
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.
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
Last modified on April 23, 2026