TypeScript MCP server that enables AI agents to safely perform payment operations through a lightweight, serverless-compatible interface to the Dodo Payments API.

Installation

NPX Directly

export DODO_PAYMENTS_API_KEY="My Bearer Token"
export DODO_PAYMENTS_WEBHOOK_KEY="My Webhook Key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"
npx -y dodopayments-mcp@latest

Remote HTTP

--transport=http --port=3000

Configuration

MCP Client JSON

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp", "--client=claude", "--tools=dynamic"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "My Bearer Token",
        "DODO_PAYMENTS_WEBHOOK_KEY": "My Webhook Key",
        "DODO_PAYMENTS_ENVIRONMENT": "live_mode"
      }
    }
  }
}

Remote HTTP Server

{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer <auth value>"
      }
    }
  }
}

Available Tools

Tool	Description
create_checkout_sessions	Create checkout sessions for payments
retrieve_checkout_sessions	Retrieve information about checkout sessions
create_payments	Create new payments
list_payments	List existing payments
create_subscriptions	Create new subscriptions
update_subscriptions	Update existing subscriptions
list_subscriptions	List all subscriptions
retrieve_usage_history_subscriptions	Retrieve detailed usage history for pay-as-you-go subscriptions
create_customers	Create new customers
list_customers	List existing customers
create_refunds	Create payment refunds
list_disputes	List disputed payments
create_products	Create new products
list_products	List all products
create_discounts	Create discount codes

Features

• Three tool operation modes: individual endpoints, dynamic discovery, or code execution
• Complete set of payment operations including checkout, subscriptions, and refunds
• Customer management and wallet operations
• Product and discount management
• License key management and validation
• Webhook configuration and management
• Billing and usage analytics
• Dispute and payout tracking
• Compatibility modes for different clients
• Advanced filtering by resource, operation type, and tools

Environment Variables

Required

• DODO_PAYMENTS_API_KEY - Bearer token for Dodo Payments API authentication
• DODO_PAYMENTS_WEBHOOK_KEY - Key for webhook authentication

Optional

• DODO_PAYMENTS_ENVIRONMENT - Environment mode (e.g., live_mode)

Notes

Built with Stainless. Supports filtering by --resource, --operation, --tool with wildcards. Offers dynamic tool discovery to avoid context window limitations. Includes Deno sandbox for code execution with network access restricted to the API base URL only. Compatible with multiple MCP clients including Claude, Cursor, and VS Code.