# Paddle

> Paddle is an MCP server for finance and payments. Query and manage Paddle Billing through search and sandboxed API calls. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Rather than one tool per API endpoint, the server exposes three: `search` the Paddle API reference, `execute` chained API calls in a sandbox, and `report_missing_tool` for telemetry. A fourth, `show_metrics_chart`, draws a metric as an interactive chart in clients that support MCP Apps. Through them an assistant can work with products, prices, subscriptions, customers and transactions.

Live and sandbox are separate hosts. `mcp.paddle.com` serves live data with OAuth or an API key, while `sandbox-mcp.paddle.com` accepts only a sandbox API key (prefixed `pdl_sdbx_`) because it does not support OAuth. With OAuth, a new connection gets read access by default, limited to what your Paddle user's role already allows, and you can change or revoke it under Paddle, Connectors, MCP in the dashboard. With an API key, its permissions are the only limit on what the assistant can do.

Paddle hosts the server, so nothing is installed. The GitHub repository only holds setup instructions for Claude Code, Claude Desktop, Codex and similar clients.

## Features

- **Search the API reference:** Looks up Paddle API operations from within the assistant.
- **Sandboxed chained calls:** Executes several API calls together in a sandbox.
- **Live and sandbox hosts:** Keeps test and live environments on separate endpoints.
- **Read-first OAuth:** New OAuth connections start with read access limited by your role.
- **Revocable connections:** Manage or revoke connections in the Paddle dashboard.
- **Metric charts:** Draws metrics as interactive charts in clients that support MCP Apps.

## Good for

- Look up a customer's subscriptions and payments
- Review pricing and product setup
- Test billing changes safely in the sandbox
- Pull revenue metrics into a chart
- Investigate transactions with chained API calls

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

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

Enter a Name (for example "Paddle"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

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

## Tools

- `search`: Searches the Paddle API reference.
- `execute`: Executes chained API calls in a sandbox.
- `report_missing_tool`: Sends telemetry about a missing tool.
- `show_metrics_chart`: Draws a metric as an interactive chart in clients that support MCP Apps.

## FAQ

### How do I authenticate to live?

With OAuth sign-in in your browser or a Paddle API key as a bearer token.

### Does sandbox support OAuth?

No. Sandbox needs a sandbox API key.

### What can a new OAuth connection do?

Read only by default, limited to what your Paddle user's role permits.

### Do I install anything?

No. Paddle hosts the server.

### How do I add Paddle to Claude Code?

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

### What are the best alternatives to Paddle?

The closest alternatives to Paddle are Paddle (Sandbox), Chartsy, Razorpay, Dodo Payments and BillDog.

## Where this comes from

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

## Alternatives

- [Paddle (Sandbox)](https://ai-powered.com/mcp/paddle-sandbox): Paddle (Sandbox) is a free MCP server for finance and payments.
- [Chartsy](https://ai-powered.com/mcp/chartsy): Chartsy is an MCP server for analytics and data.
- [Razorpay](https://ai-powered.com/mcp/razorpay): Razorpay is an open-source MCP server for finance and payments.
- [Dodo Payments](https://ai-powered.com/mcp/dodo-payments): Dodo Payments is a free MCP server for finance and payments.
- [BillDog](https://ai-powered.com/mcp/billdog): BillDog is a freemium MCP server for analytics and data.
- [Dodo Payments Docs](https://ai-powered.com/mcp/dodo-payments-docs): Dodo Payments Docs is a free MCP server for finance and payments.

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