Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Paddle Billing mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
AnythingMCP ist im Connector-Verzeichnis von Claude gelistet: Füg es mit einem Klick zu Claude hinzu (öffnet in neuem Tab), melde dich an und wähle, welche MCP-Server Claude nutzen darf.
Zusammenfassung
Paddle Billing, der Merchant of Record für Softwareverkäufe: Produkte, Preise und Rabatte, Kunden mit Adressen und Firmen, Abos mit Vorschau, Pausieren und Fortsetzen, Transaktionen und PDF-Rechnungen, Erstattungen und Gutschriften, CSV-Berichte, Umsatz- und MRR-Kennzahlen, Events und Webhook-Benachrichtigungen. Live oder Sandbox; Kündigen und Einmalbelastungen sind bei der Installation aus.
Frag einfach
Beispiel-Prompts für Paddle Billing
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Paddle Billing klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Paddle Billing + Claude
Paddle Billing, der Merchant of Record für Softwareverkäufe: Produkte, Preise und Rabatte, Kunden mit Adressen und Firmen, Abos mit Vorschau, Pausieren und Fortsetzen, Transaktionen und PDF-Rechnungen, Erstattungen und Gutschriften, CSV-Berichte, Umsatz- und MRR-Kennzahlen, Events und Webhook-Benachrichtigungen. Live oder Sandbox; Kündigen und Einmalbelastungen sind bei der Installation aus.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
PADDLE_API_KEY, PADDLE_API_URL
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Paddle-Billing-Konto, live oder Sandbox, und das Recht, dort API-Schlüssel anzulegen.
- Öffne in Paddle Developer tools, Authentication, API keys und lege einen Schlüssel an.
- Gib dem Schlüssel die Rechte, die die Tools brauchen: Lesen für Produkte, Preise, Rabatte, Kunden, Adressen, Firmen, Abos, Transaktionen, Adjustments, Berichte, Benachrichtigungen und Events, Schreiben nur für die Entitäten, die die KI ändern soll. Ein Aufruf auf eine Entität ohne Recht antwortet mit 403.
- Füge den Schlüssel in
PADDLE_API_KEYein, ohne Anführungszeichen und ohneBearer. Live-Schlüssel beginnen mitpdl_live_apikey_, Sandbox-Schlüssel mitpdl_sdbx_apikey_. - Setz
PADDLE_API_URLaufhttps://api.paddle.comfür das Live-Konto oder aufhttps://sandbox-api.paddle.comfür ein Sandbox-Konto, ohne Schrägstrich am Ende. Ein Schlüssel funktioniert nur auf dem Host seiner eigenen Umgebung. - Installiere den Connector und rufe
paddle_list_event_typesauf: Es braucht keine IDs und bestätigt den Schlüssel.
Der Connector schickt den Schlüssel als Bearer-Token und legt mit dem Header Paddle-Version die API-Version 1 fest. Er deckt nur Paddle Billing ab, nicht Paddle Classic.
Was er liest: den Katalog, also Produkte mit ihren Preisen, Preise mit Abrechnungszyklus, Testphase, Länder-Overrides und Mengengrenzen sowie Rabatte mit Code, Typ, Nutzungslimit, bisheriger Nutzung und Ablaufdatum; Kunden (Suche nach E-Mail oder Text) mit ihren Adressen, Firmen (Firmenname, Handelsregisternummer, USt-IdNr., Rechnungskontakte) und Guthaben pro Währung; Abos mit Status, Positionen, Abrechnungszeitraum, nächstem Abrechnungsdatum und geplanter Pause, Kündigung oder Fortsetzung, auf Wunsch mit einer Vorschau der nächsten Belastung; Transaktionen (Checkouts, Verlängerungen, Rechnungen) mit Summen, Steueraufschlüsselung, Zahlungen mit Fehlercodes und Rechnungsnummer, gefiltert nach Kunde, Abo, Status, Rechnungsnummer oder Abrechnungs- bzw. Erstelldatum; Adjustments (Erstattungen, Gutschriften, Chargebacks) mit ihrem Freigabestatus; frühere Berichte; Nettoumsatz, MRR und aktive Abonnenten pro Tag wie im Paddle-Dashboard; Events der letzten 90 Tage; Benachrichtigungsziele, die verschickten Webhook- und E-Mail-Benachrichtigungen und jeden Zustellversuch mit HTTP-Status und Antwort deines Endpunkts.
Was er schreibt: legt Produkte, Preise, Rabatte, Kunden, Adressen und Firmen an und ändert sie (archiviert wird mit status: archived; in Paddle wird nichts gelöscht); ändert Abos (Tarif- oder Mengenwechsel mit einem proration_billing_mode, Rabatt, Abrechnungsdatum, Adresse, Einzugsart), pausiert sie, setzt sie fort und aktiviert ein Abo in der Testphase, was die erste Zahlung sofort einzieht; legt Transaktionen an und ändert sie, entweder als Checkout, den der Kunde bezahlt (seine checkout.url), oder als Rechnung mit collection_mode: manual und status: billed; erstattet oder schreibt eine Transaktion mit paddle_create_adjustment gut (Erstattungen starten als pending_approval, bis Paddle sie geprüft hat); erzeugt Links zum Kundenportal, fordert CSV-Berichte an und stellt Benachrichtigungen erneut zu. Eine geplante Pause oder Kündigung entfernst du mit paddle_update_subscription und scheduled_change: null.
Erst die Vorschau: paddle_preview_subscription_update, paddle_preview_transaction und paddle_preview_prices berechnen Belastungen, Steuern und Summen, ohne etwas zu speichern. Vor einem Tarifwechsel holt die KI die Vorschau, zeigt dir die sofortige Belastung und wartet auf dein Ja. Auf dem Live-Host bewegen abgerechnete Transaktionen, Abo-Änderungen, Aktivierungen und Erstattungen echtes Geld.
Bei der Installation deaktiviert: paddle_cancel_subscription (eine sofortige Kündigung ist endgültig) und paddle_create_subscription_charge (belastet die gespeicherte Zahlungsmethode mit einem Einmalbetrag). Ein Workspace-Admin schaltet sie bewusst ein.
Datenformate: Jede Antwort hat data und meta.request_id. IDs tragen ein Präfix: pro_ Produkt, pri_ Preis, dsc_ Rabatt, ctm_ Kunde, add_ Adresse, biz_ Firma, sub_ Abo, txn_ Transaktion, adj_ Adjustment, rep_ Bericht, ntf_ Benachrichtigung. Beträge sind Strings in der kleinsten Währungseinheit: "1999" in USD sind 19,99, JPY hat keine Nachkommastellen. Die Summen einer Transaktion stehen in details.totals (subtotal, discount, tax, total, grand_total), pro Position in details.line_items. Datumsangaben sind RFC 3339 in UTC. Filter mit mehreren Werten werden mit Komma getrennt.
Dateien und Berichte: paddle_get_transaction_invoice und paddle_get_adjustment_credit_note liefern einen temporären PDF-Link, der nach etwa einer Stunde abläuft. Berichte laufen im Hintergrund: paddle_create_report, dann paddle_get_report, bis der Status ready ist, dann paddle_get_report_csv für einen CSV-Link, der nach wenigen Minuten abläuft. Berichtstypen sind Transaktionen, Transaktionspositionen, Adjustments, Adjustment-Positionen, Rabatte, Produkte und Preise, Saldo, Auszahlungsabgleich, Checkouts und Abos.
Paginierung: Listen-Tools liefern bis zu per_page Einträge (standardmäßig 50, höchstens 200). Solange meta.pagination.has_more true ist, nimmt die KI den Wert after aus der URL in meta.pagination.next und übergibt ihn als after.
Limits: Paddle erlaubt 240 Anfragen pro Minute und IP-Adresse und antwortet darüber mit 429.
Häufige Fehler: Fehler kommen als error.type, error.code und error.detail, error.errors nennt die ungültigen Felder. 401 heißt falscher Schlüssel oder ein Schlüssel der anderen Umgebung (Sandbox-Schlüssel auf dem Live-Host oder umgekehrt). 403 forbidden heißt, dem Schlüssel fehlt das Recht für diese Entität: Bearbeite den Schlüssel in Paddle und ergänze es. 404 entity_not_found heißt falsche ID oder eine ID aus der anderen Umgebung.
Der Connector löscht nichts, legt keine Benachrichtigungsziele an und ändert keine, und er funktioniert nicht mit Paddle-Classic-Konten.
Schritt 2 — Adapter installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Schritt 3 — Connector in Claude hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.
- Öffne in Claude Customize → Connectors.
- Klicke auf + und dann auf Add custom connector.
- Gib einen Namen ein, z. B.
Paddle Billing, und die Remote-MCP-Server-URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add. - Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.
Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.
Verfügbare Tools
| Tool | What it does |
|---|---|
paddle_list_products | List products in the catalog with name, tax category, type, status and custom data |
paddle_get_product | Get one product by id (pro_...) with its name, description, tax category, image URL, status and custom data; include prices to list its… |
paddle_create_product | Create a catalog product (what you sell) |
paddle_update_product | Update a product: name, description, tax category, image, custom data, or archive it with status archived |
paddle_list_prices | List prices with their product id, unit price (amount in the lowest currency unit), billing cycle, trial period, quantity limits and status |
paddle_get_price | Get one price by id (pri_...): product, description, unit price and overrides per country, billing cycle, trial period, tax mode and… |
paddle_create_price | Create a price for a product: amount and currency, optional billing cycle (subscription) and trial, country overrides and quantity limits |
paddle_update_price | Update a price: description, name, amount, billing cycle, trial, overrides, quantity limits, custom data, or archive it |
paddle_list_discounts | List discounts with code, type (flat, flat_per_seat, percentage), amount, recurring settings, usage limit, times used, expiry and status |
paddle_get_discount | Get one discount by id (dsc_...): code, type, amount, currency, whether it recurs and for how many intervals, usage limit, times used… |
paddle_create_discount | Create a discount: percentage or flat amount, optional checkout code, recurring behaviour, usage limit, product or price restrictions and… |
paddle_update_discount | Update a discount: amount, code, recurring settings, limits, restrictions, expiry, custom data, or archive it with status archived |
paddle_list_customers | List customers with name, email, locale, marketing consent and status |
paddle_get_customer | Get one customer by id (ctm_...): name, email, locale, marketing consent, status, custom data and timestamps |
paddle_create_customer | Create a customer by email (unique per account) with optional name, locale and custom data |
paddle_update_customer | Update a customer: email, name, locale, custom data, or archive it with status archived |
paddle_list_customer_addresses | List the addresses saved for a customer (add_... ids): country, postal code, region, city and lines |
paddle_create_customer_address | Add an address to a customer |
paddle_update_customer_address | Update a customer address: lines, city, postal code, region, country, custom data, or archive it |
paddle_list_customer_businesses | List the businesses saved for a customer (biz_... ids): company name, company number, tax identifier (VAT number) and contacts, used for… |
paddle_create_customer_business | Add a business to a customer for B2B billing: name, company number, VAT or tax id and invoice contacts |
paddle_update_customer_business | Update a customer business: name, company number, tax identifier, contacts, custom data, or archive it |
paddle_list_customer_credit_balances | Credit balances of a customer per currency: available, reserved and used credit created by adjustments (credits) on their subscriptions |
paddle_create_customer_portal_session | Create authenticated links to the Paddle customer portal for a customer, where they can update payment methods, see invoices and cancel |
paddle_list_subscriptions | List subscriptions with status, customer, address, items (price and quantity), currency, billing period, next billing date and any… |
paddle_get_subscription | Get one subscription by id (sub_...): status, customer, items, discount, billing cycle and current period, next billing date, scheduled… |
paddle_preview_subscription_update | Preview what an update to a subscription would charge or credit, without changing it: immediate transaction, next transaction and the… |
paddle_update_subscription | Update a subscription: change items or quantities (upgrade, downgrade, add-ons) with a proration mode, apply a discount, change billing… |
paddle_pause_subscription | Pause a subscription at the end of the billing period (default) or immediately, optionally with a date to resume automatically |
paddle_resume_subscription | Resume a paused subscription now (effective_from immediately) or at a given date-time, or change the date of a scheduled resume |
paddle_cancel_subscription | Cancel a subscription at the end of the billing period (default, can be undone by removing the scheduled change) or immediately (final) |
paddle_activate_subscription | End the trial of a trialing subscription now and start billing it: the first payment is collected immediately |
paddle_create_subscription_charge | Bill a one-time charge on a subscription (e.g. extra seats or a setup fee), now or with the next renewal |
paddle_list_transactions | List transactions (checkouts, renewals, invoices) with status, customer, subscription, items, totals in the lowest currency unit, invoice… |
paddle_get_transaction | Get one transaction by id (txn_...): status, items, totals and tax breakdown (details.totals, amounts in the lowest currency unit)… |
paddle_create_transaction | Create a transaction: a draft or ready checkout for a customer to pay (returns checkout.url), or an invoice for manual collection (status… |
paddle_update_transaction | Update a draft or ready transaction: items, customer, address, business, currency, discount, billing details, or set status billed or… |
paddle_preview_transaction | Preview a transaction without creating it: line items, tax, discounts and totals for given prices, customer or location |
paddle_get_transaction_invoice | Get a temporary link to the PDF invoice of a billed or completed transaction |
paddle_preview_prices | Localized price preview for a list of prices: subtotal, tax, discount and total per item in the customer's currency and country, as on a… |
paddle_list_adjustments | List adjustments (refunds, credits, chargebacks) with action, status (pending_approval, approved, rejected, reversed), transaction… |
paddle_create_adjustment | Refund or credit a billed or completed transaction, fully or for some items |
paddle_get_adjustment_credit_note | Get a temporary link to the PDF credit note of an approved adjustment |
paddle_list_reports | List reports you requested with type, status (pending, ready, failed, expired), filters, row count and expiry |
paddle_create_report | Request a CSV report: transactions, transaction_line_items, adjustments, adjustment_line_items, discounts, products_prices, balance… |
paddle_get_report | Get one report by id (rep_...): type, status, filters, number of rows and when it expires |
paddle_get_report_csv | Get a temporary download link for a ready report as CSV |
paddle_get_revenue_metrics | Net revenue per day for a date range in the account balance currency, as shown in the Paddle dashboard (amounts in the lowest currency unit) |
paddle_get_mrr_metrics | Monthly recurring revenue per day for a date range, as shown in the Paddle dashboard (amounts in the lowest currency unit) |
paddle_get_active_subscribers_metrics | Number of active subscribers per day for a date range, as shown in the Paddle dashboard metrics |
paddle_list_event_types | List the event types Paddle can send (transaction.completed, subscription.canceled, ...) with a description and the API version of each |
paddle_list_events | List events (what happened in the account): event_type, occurred_at and the full entity in data |
paddle_list_notification_settings | List notification destinations (webhook URLs and emails) with their subscribed event types, active flag and API version |
paddle_list_notifications | List webhook and email notifications sent for events, with status (delivered, failed, needs_retry, not_attempted), times attempted and the… |
paddle_get_notification | Get one notification by id (ntf_...): status, event payload, destination, attempts and last error |
paddle_list_notification_logs | List the delivery attempts of a notification with the HTTP status and response body your endpoint returned, to debug failing webhooks |
paddle_replay_notification | Send a notification again to its destination, e.g. after fixing a failing webhook endpoint |
Beispiel-Prompts
- „Wie hoch waren Nettoumsatz und MRR pro Tag im letzten Monat, und wie viele aktive Abonnenten hatten wir am Monatsende?“
- „Finde die Kundin [email protected] und zeig ihre Abos mit Status, Positionen und nächstem Abrechnungsdatum.“
- „Berechne die Vorschau für den Wechsel dieses Abos auf den Jahrespreis mit anteiliger Abrechnung und zeig mir die sofortige Belastung, bevor du etwas änderst.“
- „Liste die Transaktionen dieser Woche mit Status past_due auf, mit Kunde, Betrag und Zahlungsfehler.“
- „Welche Webhook-Benachrichtigungen sind in den letzten 24 Stunden fehlgeschlagen, und was hat unser Endpunkt geantwortet?“
FAQ
Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.
Nächste Schritte
- Connector-Startseite
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
- Mit Microsoft Copilot verbinden
War dieser Guide hilfreich?