Skip to content

MCP server

Paddle MCP Server

Official Paddle MCP server that lets AI clients manage Paddle Billing products, prices, customers, transactions, subscriptions and reports via the Paddle API.

  • Official
  • Runs locally
  • API key

Repository and documentation last checked Built from public product pages and documentation. SourcesClaim this listing

ecommerceguide summary

Paddle MCP Server gives AI clients tools for the Paddle Billing API, covering products, prices, discounts, customers, addresses, transactions, adjustments, subscriptions, saved payment methods, notifications, simulations and reports. Paddle publishes it as the npm package @paddle/paddle-mcp, run locally over stdio with a Paddle API key against either the sandbox or production environment. Setup is documented for Claude Desktop, Cursor, Windsurf and VS Code, with tool loading limited to read-only or non-destructive operations if preferred.

Why it stands out

Published by Paddle itself, with sandbox or production switching and one-click install links for Cursor and VS Code.

What Paddle MCP Server does

ecommerceguide editorial
  • Maintained by Paddle in the PaddleHQ/paddle-mcp-server repository, Apache-2.0 licensed
  • Runs locally via npx -y @paddle/paddle-mcp over stdio
  • Authenticates with a Paddle API key set per environment
  • Read and write tools: create_product, update_subscription, cancel_subscription, create_adjustment
  • Tool filter accepts all, read-only, non-destructive (default) or named tools
  • One-click install links provided for Cursor and VS Code
  • Works with Paddle Billing, not Paddle Classic
  • Generates reports and fetches PDF invoices and credit notes

How ecommerce teams could use it

ecommerceguide editorial

Illustrative scenarios written by ecommerceguide from the product's documented capabilities. They are not customer case studies.

  1. A subscription software business billing through Paddle Billing

    An engineer investigates a subscription that renewed incorrectly while working in Cursor

    Intended outcomeThe server lists and gets the subscription and its transactions, then applies update, pause or cancel calls from the same conversation

  2. A digital goods seller using Paddle as merchant of record

    Someone needs revenue and customer figures without opening the Paddle dashboard

    Intended outcomeClaude Desktop calls create_report, get_report and get_report_csv, and lists customers, transactions and credit balances

  3. A team building a new Paddle integration

    Developers want to test billing events before going live

    Intended outcomeTools create simulations and simulation runs, replay events and preview prices and transactions in the sandbox environment

Who it suits

ecommerceguide editorial

Best for

You run Paddle Billing and work in Claude Desktop, Cursor, Windsurf or VS Code, where the local stdio package and API key setup are documented.

Probably not for

You use Paddle Classic, which this server states it does not support, or need a hosted remote endpoint instead of a local npm package.

Business size
Any stagePaddle states no size or revenue audience; the Apache-2.0 package suits any store already on Paddle Billing.
Verticals
B2B commerce, Digital products and memberships

Technical details

From the vendor's own pages

From the server's repository, documentation and MCP directory listings.

What an agent can do
Manage products, Customers, Payments, Orders, Analytics
Transport
stdio (local)
Authentication
API key'you'll need an API key... replace your_api_key with your actual Paddle API key' (PADDLE_API_KEY env var)
Package
@paddle/paddle-mcp (npm)
Language
TypeScript
Licence
Apache-2.0
Repository last updated
27 Sep 2026

Connect Paddle MCP Server

Third-party data
Install command
npx -y @paddle/paddle-mcp

Command as listed on the repository README, not tested by ecommerceguide. Check the official documentation (opens in a new tab) for configuration and credentials before running it.

Works with

Ecommerce platforms and services

  • Paddle logoPaddle

Systems this server reads from or writes to.