# Paddle (Sandbox)

> Paddle (Sandbox) is a free MCP server for finance and payments. Sandbox MCP server giving AI assistants safe access to Paddle Billing test data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web, CLI, vscode
- **Website:** https://sandbox-mcp.paddle.com
- **Repository:** https://github.com/paddlehq/paddle-remote-mcp-instructions
- **MCP Registry name:** com.paddle/mcp-sandbox
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says Paddle hosts this endpoint, so there is nothing to install or run locally. It is the sandbox side of Paddle's MCP offering, letting an assistant work against Paddle API operations such as products, prices, subscriptions, customers and transactions without touching live billing data.

The server exposes a search tool over the API reference and an execute tool that runs chained API calls in a sandbox. A show_metrics_chart tool also draws metrics as interactive charts in clients that support MCP Apps. Access is controlled by a sandbox API key with the sandbox prefix, and the README notes that key scopes are the only limit on what the assistant can do.

The listing suits developers and billing teams who want to set up plans, trials or test payment flows through an AI client before going live. The live endpoint at mcp.paddle.com is a separate server with OAuth support, which this sandbox endpoint does not offer.

## Features

- **Sandbox API access:** Runs Paddle Billing API operations against test data through a single MCP endpoint.
- **API reference search:** A search tool lets the assistant look up Paddle API documentation while it works.
- **Chained API execution:** An execute tool runs multi-step API call sequences in the sandbox environment.
- **Metrics charts:** A show_metrics_chart tool renders metrics as interactive charts in MCP Apps-capable clients.
- **Scoped API key auth:** Authenticates with a bearer sandbox API key whose permissions define what the assistant can do.

## Good for

- Prototyping subscription plans and trial periods before launch
- Testing webhook and payment event flows against sandbox data
- Exploring Paddle Billing API operations from an AI coding assistant
- Checking product and price configurations in a test account

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-sandbox https://sandbox-mcp.paddle.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sandbox-mcp.paddle.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-sandbox": {
      "url": "https://sandbox-mcp.paddle.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-sandbox": {
      "type": "http",
      "url": "https://sandbox-mcp.paddle.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-sandbox": {
      "serverUrl": "https://sandbox-mcp.paddle.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-sandbox": {
      "type": "http",
      "url": "https://sandbox-mcp.paddle.com/mcp"
    }
  }
}
```

## Tools

- `search`: Searches the Paddle API reference.
- `execute`: Runs chained Paddle API calls in a sandbox.
- `report_missing_tool`: Reports missing tools for telemetry.
- `show_metrics_chart`: Draws a metric as an interactive chart in MCP Apps clients.

## FAQ

### Does the sandbox server support OAuth?

No. The README says the sandbox server doesn't support OAuth and requires a sandbox API key prefixed pdl_sdbx_ in the Authorization header.

### How do I connect it to Claude Code?

The README gives a command using claude mcp add with the HTTP transport, the sandbox endpoint and a bearer authorization header containing your sandbox key.

### Is there any local install?

No. The README says Paddle hosts the server, so there is nothing to install or run, and the repository holds setup instructions only with no source code.

### Is Paddle (Sandbox) free?

Yes. Paddle (Sandbox) is free to use.

### How do I add Paddle (Sandbox) to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-sandbox https://sandbox-mcp.paddle.com/mcp

### What are the best alternatives to Paddle (Sandbox)?

The closest alternatives to Paddle (Sandbox) are Acp Sandbox, Polar MCP by usefulapi, Autumn MCP by usefulapi, Klap and SW Accounting documentation.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Acp Sandbox](https://ai-powered.com/mcp/acp-sandbox): Acp Sandbox is a free MCP server for finance and payments.
- [Polar MCP by usefulapi](https://ai-powered.com/mcp/polar-mcp-by-usefulapi): Polar MCP by usefulapi is a freemium MCP server for finance and payments.
- [Autumn MCP by usefulapi](https://ai-powered.com/mcp/autumn-mcp-by-usefulapi): Autumn MCP by usefulapi is a freemium MCP server for finance and payments.
- [Klap](https://ai-powered.com/mcp/klap-2): Klap is an open-source MCP server for finance and payments.
- [SW Accounting documentation](https://ai-powered.com/mcp/sw-accounting-documentation): SW Accounting documentation is a free MCP server for finance and payments.
- [Pin Payments MCP by usefulapi](https://ai-powered.com/mcp/pin-payments-mcp-by-usefulapi): Pin Payments MCP by usefulapi is a freemium MCP server for finance and payments.
- [Braintree MCP by usefulapi](https://ai-powered.com/mcp/braintree-mcp-by-usefulapi): Braintree MCP by usefulapi is a freemium MCP server for finance and payments.
- [Papaya Global MCP by usefulapi](https://ai-powered.com/mcp/papaya-global-mcp-by-usefulapi): Papaya Global MCP by usefulapi is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/paddle-sandbox
