​

Quick Start

​

Installation Options

​

1. Using the Dodo Payments Remote MCP Server

You can use the hosted Remote MCP Server at https://mcp.dodopayments.com, so you don’t need to run the server yourself.

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}

​

2. Direct Installation

Run the MCP Server directly using npx:

# Set your API key
export DODO_PAYMENTS_API_KEY="My Bearer Token"

# Run the server
npx -y dodopayments-mcp

​

3. MCP Client Integration

For existing MCP clients (listed at modelcontextprotocol.io), configure the server using JSON:

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "My Bearer Token"
      }
    }
  }
}

​

Advanced Usage

​

Tool Filtering

The MCP Server supports various filtering options to manage tool exposure:

# Include specific tools
--tool <tool_name>

# Filter by resource
--resource <resource_pattern>

# Filter by operation type
--operation <read|write>

# List available tools
--list

# Exclude specific tools
--no-tool <tool_name>

Multiple filters can be combined for precise control.

​

Programmatic Integration

// Core imports
import { server, endpoints, init } from "dodopayments-mcp/server";

// Individual tool import
import createPayments from "dodopayments-mcp/tools/payments/create-payments";

// Initialize server with all endpoints
init({ server, endpoints });

// Manual server start
const transport = new StdioServerTransport();
await server.connect(transport);

// Custom server configuration
const myServer = new McpServer(...);

// Custom endpoint definition
const myCustomEndpoint = {
  tool: {
    name: 'my_custom_tool',
    description: 'My custom tool',
    inputSchema: zodToJsonSchema(z.object({ a_property: z.string() })),
  },
  handler: async (client: client, args: any) => {
    return { myResponse: 'Hello world!' };
  }
};

// Initialize with custom configuration
init({ server: myServer, endpoints: [createPayments, myCustomEndpoint] });

​

Available Tools

​

Payment Operations

​

Subscription Management

​

License Management

​

Customer Management

​

Payment Processing

​

Product Management

​

Discount Management

​

Other Operations

​

Security Considerations

1. API Key Protection

   • Never commit API keys to version control
   • Use environment variables for sensitive data
   • Rotate API keys periodically

2. Access Control

   • Use tool filtering to limit exposed endpoints
   • Implement proper authentication in custom endpoints
   • Monitor API usage and implement rate limiting

​

Best Practices

1. Tool Selection

   • Use filtering to optimize context window usage
   • Group related operations for better organization
   • Document custom tool implementations

2. Error Handling

   • Implement proper error handling in custom endpoints
   • Log and monitor server operations
   • Provide meaningful error messages

3. Performance

   • Use pagination for list operations
   • Cache frequently accessed data
   • Optimize custom endpoint implementations

​

Support

For additional support:

• Check modelcontextprotocol.io
• Contact DodoPayments support team