# Paddle (Sandbox)

Paddle (Sandbox) is an MCP server for Claude Code that connects an AI agent to Paddle Billing's sandbox. It can test prices, subscriptions, payments, and webhooks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: PaddleHQ
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PaddleHQ/paddle-remote-mcp-instructions
- Updated: 2026-11-03
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/paddle-sandbox

## What it does

The server exposes Paddle sandbox operations for products, prices, subscriptions, customers, and transactions. Its `search` tool looks up API reference material, while `execute` runs chained API calls against the test environment. Name the connection `paddle-sandbox` to direct the agent to sandbox operations.

Paddle hosts the server, so there is no server process to install or run locally. Authentication requires a sandbox API key beginning with `pdl_sdbx_`, sent in the `Authorization` header. OAuth is not supported for sandbox connections. A further tool can render interactive metric charts in clients that support MCP Apps.

## Requirements
- Remote server: `https://sandbox-mcp.paddle.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http paddle-sandbox https://sandbox-mcp.paddle.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add paddle-sandbox --url https://sandbox-mcp.paddle.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "paddle-sandbox": {
            "url": "https://sandbox-mcp.paddle.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "paddle-sandbox": {
            "type": "http",
            "url": "https://sandbox-mcp.paddle.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http paddle-sandbox https://sandbox-mcp.paddle.com/mcp
```

## When to use it
- test product and price creation in Paddle’s sandbox
- exercise a subscription or payment flow
- run chained API operations against the test environment
- chart metrics in an MCP Apps-compatible client

## Example prompts
- Use `paddle-sandbox` to create a Pro test plan priced at $79 per month with a 14-day trial.
- Show me the products and prices in the test environment through `paddle-sandbox`.
- Use `paddle-sandbox` to chart revenue by week for the last 3 months.

## Similar
- [paddle-webhooks](https://affpapa.org/en/nevibecode/skills/paddle-webhooks.md) — skill · 258 installs
- [payment-integration](https://affpapa.org/en/nevibecode/skills/payment-integration.md) — skill · 361 installs
- [stripe-integration-expert](https://affpapa.org/en/nevibecode/skills/borghei-stripe-integration-expert.md) — skill · 116 installs
- [stripe-best-practices](https://affpapa.org/en/nevibecode/skills/stripe-best-practices-2.md) — skill · 102700 installs
- [subscription-integration](https://affpapa.org/en/nevibecode/skills/subscription-integration.md) — skill · 1000 installs
- [payment-gateway-integration](https://affpapa.org/en/nevibecode/skills/payment-gateway-integration.md) — skill · 531 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
