Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Paddle Billing con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Resumen
Paddle Billing, el merchant of record para la venta de software: productos, precios y descuentos, clientes con direcciones y empresas, suscripciones con vista previa, pausa y reanudación, transacciones y facturas en PDF, reembolsos y créditos, informes CSV, métricas de ingresos y MRR, eventos y notificaciones webhook. Live o sandbox; la cancelación y los cargos únicos vienen desactivados al instalar.
Prueba a pedir
Prompts de ejemplo para Paddle Billing
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Paddle Billing, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Paddle Billing + Claude
Paddle Billing, el merchant of record para la venta de software: productos, precios y descuentos, clientes con direcciones y empresas, suscripciones con vista previa, pausa y reanudación, transacciones y facturas en PDF, reembolsos y créditos, informes CSV, métricas de ingresos y MRR, eventos y notificaciones webhook. Live o sandbox; la cancelación y los cargos únicos vienen desactivados al instalar.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
PADDLE_API_KEY, PADDLE_API_URL
Paso 1 — Obtener credenciales
La configuración lleva unos 2 minutos. Necesitas una cuenta de Paddle Billing, live o sandbox, y permiso para crear claves de API en ella.
- En Paddle abre Developer tools, Authentication, API keys y crea una clave.
- Dale a la clave los permisos que necesitan las herramientas: lectura para productos, precios, descuentos, clientes, direcciones, empresas, suscripciones, transacciones, ajustes, informes, notificaciones y eventos, y escritura solo para las entidades que la IA deba cambiar. Una llamada sobre una entidad sin permiso responde 403.
- Pega la clave en
PADDLE_API_KEY, sin comillas ni prefijoBearer. Las claves live empiezan porpdl_live_apikey_y las de sandbox porpdl_sdbx_apikey_. - Define
PADDLE_API_URLcomohttps://api.paddle.compara la cuenta live ohttps://sandbox-api.paddle.compara una cuenta sandbox, sin barra final. Una clave solo funciona en el host de su propio entorno. - Instala el conector y ejecuta
paddle_list_event_types: no necesita ids y confirma la clave.
El conector envía la clave como bearer token y fija la versión 1 de la API con la cabecera Paddle-Version. Solo cubre Paddle Billing, no Paddle Classic.
Qué lee: el catálogo, es decir, productos con sus precios, precios con ciclo de facturación, periodo de prueba, ajustes por país y límites de cantidad, y descuentos con código, tipo, límite de uso, veces usado y caducidad; clientes (búsqueda por email o texto) con sus direcciones, empresas (razón social, número de registro, NIF-IVA, contactos de facturación) y saldos de crédito por moneda; suscripciones con estado, artículos, periodo de facturación, próxima fecha de cobro y cualquier pausa, cancelación o reanudación programada, si quieres con una vista previa del próximo cargo; transacciones (checkouts, renovaciones, facturas) con totales, desglose de impuestos, pagos con códigos de error y número de factura, filtradas por cliente, suscripción, estado, número de factura o fecha de facturación o creación; ajustes (reembolsos, créditos, contracargos) con su estado de aprobación; informes anteriores; ingresos netos, MRR y suscriptores activos por día, como en el panel de Paddle; eventos de los últimos 90 días; destinos de notificación, las notificaciones webhook y de email enviadas y cada intento de entrega con el estado HTTP y la respuesta de tu endpoint.
Qué escribe: crea y actualiza productos, precios, descuentos, clientes, direcciones y empresas (se archivan con status: archived; en Paddle no se borra nada); actualiza suscripciones (cambio de plan o de cantidad con un proration_billing_mode, descuento, fecha de facturación, dirección, modo de cobro), las pausa, las reanuda y activa una suscripción en prueba, lo que cobra el primer pago al momento; crea y actualiza transacciones, ya sea un checkout que paga el cliente (su checkout.url) o una factura con collection_mode: manual y status: billed; reembolsa o acredita una transacción con paddle_create_adjustment (los reembolsos empiezan como pending_approval hasta que Paddle los revisa); crea enlaces al portal del cliente, solicita informes CSV y reenvía notificaciones. Una pausa o cancelación programada se quita con paddle_update_subscription y scheduled_change: null.
Primero la vista previa: paddle_preview_subscription_update, paddle_preview_transaction y paddle_preview_prices calculan cargos, impuestos y totales sin guardar nada. Antes de un cambio de plan, la IA ejecuta la vista previa, te muestra el cargo inmediato y espera tu sí. En el host live, las transacciones facturadas, los cambios de suscripción, las activaciones y los reembolsos mueven dinero real.
Desactivadas al instalar: paddle_cancel_subscription (una cancelación inmediata es definitiva) y paddle_create_subscription_charge (cobra un cargo único en el método de pago guardado). Un admin del workspace las activa a conciencia.
Formatos de datos: cada respuesta tiene data y meta.request_id. Los ids llevan un prefijo: pro_ producto, pri_ precio, dsc_ descuento, ctm_ cliente, add_ dirección, biz_ empresa, sub_ suscripción, txn_ transacción, adj_ ajuste, rep_ informe, ntf_ notificación. Los importes son cadenas en la unidad mínima de la moneda: "1999" en USD son 19,99 y el JPY no tiene decimales. Los totales de una transacción están en details.totals (subtotal, discount, tax, total, grand_total) y por artículo en details.line_items. Las fechas son RFC 3339 en UTC. Los filtros con varios valores van separados por comas.
Archivos e informes: paddle_get_transaction_invoice y paddle_get_adjustment_credit_note devuelven un enlace temporal al PDF que caduca en aproximadamente una hora. Los informes se generan en segundo plano: paddle_create_report, luego paddle_get_report hasta que el estado sea ready, y después paddle_get_report_csv para un enlace CSV que caduca a los pocos minutos. Los tipos de informe son transacciones, líneas de transacción, ajustes, líneas de ajuste, descuentos, productos y precios, saldo, conciliación de pagos, checkouts y suscripciones.
Paginación: las herramientas de lista devuelven hasta per_page elementos (50 por defecto, 200 como máximo). Mientras meta.pagination.has_more sea true, la IA toma el valor after de la URL en meta.pagination.next y lo pasa como after.
Límites: Paddle permite 240 peticiones por minuto por dirección IP y por encima responde 429.
Errores habituales: los errores llegan como error.type, error.code y error.detail, y error.errors enumera los campos no válidos. 401 significa una clave incorrecta o una clave del otro entorno (una clave sandbox en el host live o al revés). 403 forbidden significa que a la clave le falta el permiso para esa entidad: edita la clave en Paddle y añádelo. 404 entity_not_found significa un id incorrecto o un id del otro entorno.
El conector no borra nada, no crea ni cambia destinos de notificación y no funciona con cuentas de Paddle Classic.
Paso 2 — Instalar el adapter
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
Paso 3 — Añadir el conector en Claude
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
Paddle Billing, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| 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 |
Ejemplos de prompts
- "¿Cuáles fueron los ingresos netos y el MRR por día el mes pasado, y cuántos suscriptores activos teníamos al final del mes?"
- "Busca a la clienta [email protected] y muestra sus suscripciones con estado, artículos y próxima fecha de cobro."
- "Calcula la vista previa de pasar esta suscripción al precio anual con prorrateo y muéstrame el cargo inmediato antes de cambiar nada."
- "Lista las transacciones past_due de esta semana con cliente, importe y error de pago."
- "¿Qué notificaciones webhook fallaron en las últimas 24 horas y qué respondió nuestro endpoint?"
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
- Página del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?