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.
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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Paddle Billing. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?