Servidor MCP

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/mcp

Agré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).