Tilopay MCP
Conecta tu asistente de IA al API de Tilopay para consultar transacciones, crear enlaces de pago y analizar tus ventas, tendencias y estacionalidad.
Endpoint MCP
https://mcp.tilopay.com/mcpAgrégalo como servidor MCP remoto en Claude, ChatGPT, Cursor o Lovable.
Herramientas por área
Diagnóstico y ayuda
tilopay_diagnostics
Verifica credenciales y qué endpoints del API responden.
tilopay_help_guides
Responde cómo usar Tilopay con las guías oficiales de tilopay.com/guias.
tilopay_debug_code
Analiza código, errores o stack traces y devuelve diagnóstico, causa raíz y corrección.
Análisis de ventas
tilopay_sales_summary
Métricas calculadas: totales por moneda, ticket promedio, aprobación, días y horas fuertes, tendencia.
tilopay_analyze_sales
Agente analista: informe en lenguaje natural con tendencias, riesgos y recomendaciones.
Transacciones
tilopay_list_transactions
Transacciones por rango de fechas, con filtros de moneda, orden, correo y ambiente.
tilopay_get_transaction
Detalle completo de una transacción a partir del número de orden.
tilopay_modify_transaction
Captura, reembolsa o reversa una transacción existente.
Links de pago
tilopay_create_charge
Genera un enlace de cobro para un monto y moneda específicos.
tilopay_get_payment_link
Detalle de un enlace de pago por su ID.
tilopay_delete_payment_link
Elimina un enlace de pago.
tilopay_send_payment_link_whatsapp
Comparte un enlace de pago por WhatsApp con el mensaje listo para enviar.
tilopay_send_payment_link_email
Envía un enlace de pago por correo electrónico al cliente.
Contactos
tilopay_save_contact
Guarda un contacto con teléfono y correo para reutilizarlo en cobros.
tilopay_list_contacts
Lista los contactos guardados del comercio.
tilopay_delete_contact
Elimina un contacto guardado.
Perfil del negocio y recetas
tilopay_get_business_profile
Perfil del negocio y la siguiente pregunta pendiente (máximo 4).
tilopay_save_business_profile
Guarda el tipo de negocio, canales, patrón de cobros y metas.
tilopay_recommend_automations
Recetas y automatizaciones según el perfil y los módulos activos.
Catálogo
tilopay_catalog_list_items
Lista los productos o servicios del catálogo.
tilopay_catalog_get_item
Detalle de un producto o servicio del catálogo.
Microtienda
tilopay_store_create
Crea un enlace de tienda con catálogo, carrito y pago en la misma página.
tilopay_store_list
Lista las microtiendas activas con su enlace.
tilopay_store_delete
Desactiva una microtienda.
tilopay_orders_setup
Activa la gestión de pedidos: nombre de la tienda, logo y recordatorio diario.
tilopay_orders_settings
Muestra la configuración de la tienda.
tilopay_orders_status
Resumen de pedidos: pendientes de pago, pagados sin entregar y entregados hoy.
tilopay_orders_list
Lista los pedidos por estado y por fecha.
tilopay_orders_pending
Pedidos pagados que aún no se han entregado.
tilopay_order_mark_delivered
Marca uno o varios pedidos como entregados por su código o cliente.
tilopay_orders_disable
Apaga la gestión de pedidos y su recordatorio.
Cobros recurrentes
tilopay_recurring_list_plans
Lista los planes de cobro recurrente.
tilopay_recurring_get_plan
Detalle de un plan recurrente.
tilopay_recurring_get_subscriber
Detalle de un suscriptor de un plan.
tilopay_recurring_subscriber_payments
Pagos realizados por un suscriptor.
tilopay_recurring_manage_subscriber
Pausa, reactiva o elimina un suscriptor.
Cobros con tarjetas almacenadas
tilopay_saved_cards_list_groups
Grupos de cobro con tarjetas almacenadas.
tilopay_saved_cards_list_affiliates
Afiliados con tarjeta almacenada de un grupo.
tilopay_saved_cards_list_collections
Cobros masivos realizados.
tilopay_saved_cards_collection_detail
Detalle de un cobro masivo.
tilopay_saved_cards_create_payments
Cobra a afiliados o grupos con su tarjeta almacenada.
API BaaS (cuentas, pagos y transferencias)
baas_list_assignments
Contextos (assignments) disponibles para las credenciales BaaS.
baas_diagnostics
Verifica credenciales BaaS, login, token y acceso a cuentas.
baas_list_accounts
Cuentas accesibles (IBAN y moneda), sin saldos.
baas_list_balances
Saldos en tiempo real de las cuentas accesibles.
baas_get_balance
Saldo actual de una cuenta identificada por IBAN.
baas_list_payments
Pagos de una cuenta con filtros de fecha, estado, moneda, método y dirección.
baas_search_payment
Busca un pago por UUID, identificador público o referencia.
baas_get_payment
Detalle de un pago BaaS por su UUID.
baas_request_statement
Solicita un estado de cuenta (rango máximo 60 días).
baas_get_statement_status
Estado de la solicitud y enlace de descarga cuando está listo.
baas_analyze_payments
Informe analítico de pagos BaaS: éxito, fallas, reversiones y neto por moneda.
baas_validate_destination
Valida un destino antes de enviar: teléfono SINPE Móvil o cuenta IBAN.
baas_send_transfer
Envía dinero por SINPE Móvil (método por defecto) o transferencia inmediata a cuenta, con código de 6 dígitos por correo y límites por operación y diarios.
baas_get_transfer_status
Estado de una transferencia enviada, por identificador o referencia.
Comprobantes de cobro
tilopay_list_receipts
Comprobantes recientes con código, monto, cliente y enlace para compartir.
tilopay_send_receipt
Reenvía el comprobante en texto al cliente por WhatsApp.
Acceso y credenciales
El servidor exige autenticación OAuth: al conectar tu cliente MCP inicias sesión con tu cuenta y autorizas el acceso. No se piden credenciales de Tilopay en las llamadas.
El administrador registra el API key, API user y API password de cada usuario en el panel de usuarios; se guardan cifradas (AES-256-GCM) y el servidor las usa automáticamente según quién esté conectado. Nunca se devuelven al cliente.
Las herramientas del API BaaS son opcionales: se habilitan cuando el administrador registra el correo y la contraseña BaaS del usuario, también cifrados. Las consultas de cuentas, saldos, pagos y estados de cuenta son de solo lectura.
Las transferencias salientes por SINPE Móvil o transferencia inmediata sí están habilitadas, siempre con doble confirmación: el sistema envía un código de 6 dígitos al correo del usuario y solo con ese código se ejecuta el envío. Cada operación se valida contra los límites por transferencia (₡250.000 o $500 por defecto) y el acumulado diario (₡500.000 o $1.000), editables por un administrador en el perfil de cada usuario. El MCP no aprueba ni revierte movimientos de terceros.
Límites de uso y auditoría
Cada llamada se limita a 60 por minuto por usuario y 120 por minuto por IP. Al superarlo, la herramienta responde con el tiempo de espera y la llamada queda registrada como bloqueada.
Todas las llamadas se registran con herramienta, usuario autenticado, IP, cliente, resultado y duración (sin credenciales ni datos de tarjeta).