
Paddle
MCP server giving AI agents read-only access to Paddle billing customers, subscriptions
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Paddle
Paddle is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http paddle https://gateway.pipeworx.io/paddle/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/paddle/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"paddle": {
"url": "https://gateway.pipeworx.io/paddle/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"paddle": {
"type": "http",
"url": "https://gateway.pipeworx.io/paddle/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"paddle": {
"serverUrl": "https://gateway.pipeworx.io/paddle/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"paddle": {
"type": "http",
"url": "https://gateway.pipeworx.io/paddle/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Freemium, from $49 a month
Free anonymous and registered tiers; paid credits and subscriptions for higher volume.
Prices change. Check pipeworx.io before you buy.
Paddle 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.