# Paddle

> Paddle is a freemium MCP server for finance and payments. MCP server giving AI agents read-only access to Paddle billing customers, subscriptions. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/paddle
- **Repository:** https://github.com/pipeworx-io/mcp-paddle
- **MCP Registry name:** io.github.pipeworx-io/paddle
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The Pipeworx Paddle pack lets an AI client read customer records, subscription state, transactions and refund or chargeback adjustments from Paddle Billing. Each of its four tools returns a bounded set of records with fields such as status, currency, totals and timestamps, so a question like which accounts are past due can be answered without writing API code.

The pack is hosted on the Pipeworx gateway, so it can be added as a remote streamable-HTTP endpoint or run locally through an npm stdio bridge. Access to Paddle data requires a Paddle Billing API key passed per call, and the README says the sandbox environment can be selected instead of production. The server is read-only.

It suits finance, revenue operations and support teams who want an assistant to answer questions about billing state. Because the endpoint also lists shared gateway meta-tools, the tool count an client sees is larger than the four Paddle tools.

## Features

- **Customer record lookup:** Returns bounded Paddle customer records with IDs, email, name, status, locale and timestamps.
- **Subscription state reporting:** Shows subscriptions with status, recurring items, billing cycle, next billing date and scheduled changes.
- **Transaction and payment status:** Lists transactions with customer, currency, totals, payment and processing status.
- **Refund and chargeback visibility:** Lists adjustments covering refunds, credits and chargebacks with their status and reason.
- **Sandbox or production selection:** Accepts an environment setting so calls can target Paddle's sandbox API or production.

## Good for

- Finding which subscriptions are past due or trialing
- Checking whether a customer's recent payment completed
- Reviewing refunds and chargebacks for a revenue report
- Looking up a billing customer by email address

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http paddle https://gateway.pipeworx.io/paddle/mcp
```

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

```sh
https://gateway.pipeworx.io/paddle/mcp
```

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

```json
{
  "mcpServers": {
    "paddle": {
      "url": "https://gateway.pipeworx.io/paddle/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "paddle": {
      "serverUrl": "https://gateway.pipeworx.io/paddle/mcp"
    }
  }
}
```

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

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

## Tools

- `paddle_list_customers`: Find recent or updated customer records.
- `paddle_list_subscriptions`: Inspect active, trialing, paused, past-due, or canceled subscriptions.
- `paddle_list_transactions`: Inspect transaction and payment state.
- `paddle_list_adjustments`: Inspect refunds, credits, and chargebacks.

## FAQ

### Does the pack modify Paddle data?

No. The README states the pack is read-only.

### Do I need a Paddle API key?

Yes. A Paddle Billing API key is passed as _apiKey and needs read permission for each requested resource.

### Is there a free tier for the gateway?

The Pipeworx pricing page describes anonymous use capped at 50 tool calls a day and a free registered account at 200 a day.

### Can I run it locally?

Yes. The @pipeworx/mcp-paddle npm package runs as a local stdio bridge that forwards calls to the hosted gateway, so network access is required.

### Is Paddle free?

Paddle has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

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

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

### What are the best alternatives to Paddle?

The closest alternatives to Paddle are Paddle (Sandbox), Polar MCP by usefulapi, Pin Payments MCP by usefulapi, Recurly and Recurly MCP by usefulapi.

## 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

- [Paddle (Sandbox)](https://ai-powered.com/mcp/paddle-sandbox): Paddle (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.
- [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.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.
- [Recurly MCP by usefulapi](https://ai-powered.com/mcp/recurly-mcp-by-usefulapi): Recurly 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.
- [Checkout.com MCP by usefulapi](https://ai-powered.com/mcp/checkout-com-mcp-by-usefulapi): Checkout.com MCP by usefulapi is a freemium MCP server for finance and payments.
- [Invoiced MCP by usefulapi](https://ai-powered.com/mcp/invoiced-mcp-by-usefulapi): Invoiced MCP by usefulapi is a freemium MCP server for finance and payments.

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