Capabilities Registry

Consultar horarios disponibles para un proveedor o servicio

Obtener horario semanal configurado de un proveedor

Reemplazar horario semanal de un proveedor

Crear nueva sesión/cita

Obtener detalle completo de una sesión

Listar sesiones con filtros y paginación

Cancelar sesión existente

Reagendar sesión a nueva fecha/hora

MCP tool hace cancel+create atómico. UI usa edit page.

Rationale:Reagendar como operación atómica (cancel+create en una transacción) evita estados inconsistentes donde la sesión original queda cancelada pero la nueva no se crea.

Avanzar sesión en ciclo de vida (confirmar, iniciar, completar, entregar, no-show)

UI tiene endpoints separados por acción. MCP unifica en un solo tool con param action.

Crear sesiones recurrentes

Marcar sesión como entregada con prueba de entrega

Cubierto por booking_update_status action=deliver con deliveryType param. Crea DeliveryProof.

Rationale:No se creó un tool separado porque booking_update_status unifica todo el ciclo de vida en un solo punto de entrada — reduce superficie de la API del agente.

Auto-avanzar sesiones por ciclo de vida (requested→expired, confirmed→in_progress, etc.)

Cron hourly. No requiere MCP — es automatización del sistema.

Auto-completar sesiones pasadas que no fueron marcadas manualmente

Auto-verificar entregas después de período de gracia

Expirar sesiones pendientes de confirmación

Reservar sesión desde agenda pública (flujo cliente)

Usa el mismo endpoint que booking.create-session pero con auth de cliente/guest.

Rationale:Booking público es un flujo interactivo con selección de horario, servicio y proveedor — exponerlo como MCP no agrega valor vs booking_create directo.

Confirmación post-booking público

Listar agendas públicas

Crear agenda pública

Obtener detalle de una agenda pública

Editar agenda pública existente

Eliminar agenda pública

Listar disputas

Listar recursos (salas, equipos)

Detalle de recurso

Listar planes de tratamiento/atención

Rationale:Planes de tratamiento son complejos (multi-sesión, objetivos, seguimiento) — MCP read sería útil pero write requiere supervisión.

Detalle de plan de tratamiento

Procesar cambios pendientes en planes de tratamiento

Listar clientes con búsqueda y paginación

Obtener detalle de cliente con resumen financiero

Crear nuevo cliente

Actualizar datos personales del cliente

Importar clientes desde archivo

No tiene API ni MCP tool — operación bulk UI-only.

Rationale:Import masivo requiere preview de conflictos y validación fila por fila antes de confirmar — exponerlo como tool sería destructivo sin UI de revisión.

Fusionar clientes duplicados

No tiene API ni MCP tool — operación destructiva, requiere supervisión humana.

Rationale:Merge resuelve identidades duplicadas con lógica de conflictos que requiere decisión humana explícita sobre qué atributos conservar.

Detectar clientes duplicados automáticamente

Desbloquear clientes automáticamente cuando pagan deuda

Listar servicios con filtros

Crear nuevo servicio

service_create es el tool general. admin_create_service es para setup/onboarding.

Actualizar servicio (precio, duración, estado)

Asignar o desasignar proveedor a servicio

Listar proveedores activos de la organización

MCP tool se llama admin_list_providers por herencia del setup flow. Funciona como list general.

Obtener detalle de proveedor con servicios y horario

Crear nuevo proveedor

Actualizar datos de proveedor

Métricas de rendimiento del proveedor (ocupación, revenue, no-shows)

MCP tool calcula stats inline. API retorna en el GET del provider. UI tiene página dedicada.

Rationale:Stats computadas on-demand en el tool permiten rangos de fecha dinámicos sin necesidad de endpoints de reporting adicionales.

Listar cobros/cargos con filtros y paginación

Obtener detalle de cobro con todos sus pagos

API filtra por cobroId como query param, no tiene ruta dedicada [cobroId].

Crear cobro manual para un cliente

Registrar pago manual contra un cobro existente

Listar pagos recibidos con resumen por tipo

Crear venta de servicios

Listar ventas con filtros

Balance financiero completo de un cliente

MCP tool calcula balance inline. En la UI se muestra en el detalle del cliente.

Rationale:Balance calculado en el tool en vez de campo en la API evita stale data: siempre refleja cobros y pagos actuales sin depender de vistas materializadas.

Reporte de antigüedad de cuentas por cobrar

Gestión de gastos operacionales

Libro de movimientos/transacciones contables

Proyecciones financieras y forecasting

Rationale:Proyecciones son lectura — útil para agentes que hacen análisis financiero.

Estados financieros (P&L, balance general)

Gestión de facturas

Verificar cobros automáticamente

Preview financiero de cierre de un cliente sin persistir

Crear cierre mensual inmutable de un cliente

Listar cierres de clientes con filtros de período y cliente

Reabrir cierre de un cliente (si el período org no está congelado)

Evaluar estado del cierre organizacional: clientes activos, cerrados, pendientes, % completado

Cerrar período organizacional (congela el período)

Distribuir utilidades de un período cerrado (congela período actual y anteriores)

Listar utilidades retenidas acumuladas por período

Listar registros de nómina con filtros de período, proveedor y estado

Resumen de nómina por período: totales por proveedor, estados, costo total

MCP tool calcula resumen inline. La generación de nómina sigue siendo UI-only por su complejidad (modes simple/legal, adjustments por proveedor).

Rationale:Generar nómina requiere configuración de modo (simple/legal) y ajustes manuales por proveedor — exponerlo como tool de lectura (consulta) es seguro, la escritura (generación) requiere supervisión humana.

Generar nómina mensual (cálculo de comisiones, liquidaciones)

UI-only por complejidad: modos simple/legal, ajustes manuales por proveedor, previsión.

Rationale:Generación requiere supervisión humana — múltiples configuraciones y ajustes que no se pueden automatizar sin riesgo.

Configurar parámetros de nómina (indicadores legales, porcentajes)

Gestión de vacaciones y días libres de proveedores

Obtener preferencias de comunicación de la organización

Actualizar canales y features de comunicación

Listar campañas de WhatsApp/email

Detalle de campaña con logs de entrega

Enviar mensaje WhatsApp o email a un cliente

Obtener dominio de email configurado y su estado de verificación

Registrar nuevo dominio de email para enviar campañas desde dirección propia via Resend

Verificar DNS del dominio de email y actualizar estado

Eliminar dominio de email configurado

Obtener configuración de dunning/cobranza

Actualizar configuración de dunning (pasos, periodo de gracia, bloqueo)

Ejecutar secuencia de dunning (5 pasos escalantes) — envío automático

Ejecuta la secuencia de 5 pasos: WhatsApp gentle → friendly → firm → urgent + admin notify → final + block bookings.

Rationale:Ejecución automática por cron — no requiere MCP, el agente configura vía dunning.configure.

Dashboard de NPS: score, promotores, pasivos, detractores

Envío automático de encuesta NPS post-sesión vía WhatsApp

Se envía después de sesión N (configurable). Clasifica: promoter 9-10, passive 7-8, detractor 0-6.

Gestionar audiencias/segmentos de clientes para campañas

Listar derivaciones entre proveedores/organizaciones

Detectar abandono de clientes y enviar re-engagement automático (3 pasos)

Secuencia de 3 pasos: día N, N+14, N+30 desde última sesión. Configurable abandonmentDays (default 30).

Recordatorio automático 24h antes de sesión

Recordatorio automático 1h antes de sesión

Recordatorio post-booking (ej: confirmar asistencia)

Obtener configuración detallada de recordatorios (7 tipos: booking, sesión 24h/1h, pago, pago vencido, follow-up, confirmación)

Actualizar configuración de recordatorios (parcial, por sección)

Resumen ejecutivo: sesiones de hoy, métricas mensuales, alertas

Tasas de ocupación por proveedor/día/semana

Revenue por día/semana/mes/servicio/proveedor

Estadísticas de inasistencia agrupadas por cliente/proveedor/servicio/día

Crear nueva organización desde cero

No tiene UI admin — el flujo de onboarding web es diferente al MCP.

Rationale:Usa X-Bootstrap-Key en vez de X-Org-Api-Key porque la org no existe aún. Retorna una API key admin one-time para los pasos de setup subsiguientes.

Listar proveedores activos de la organización (contexto setup)

Consolidar: admin_list_providers duplica provider.list. Mantener por backward-compat pero marcar deprecated.

Agregar servicio a la organización (setup)

Consolidar: admin_create_service duplica service_create. Diferencia original era auth (bootstrap key vs org key), pero ambos usan X-Org-Api-Key ahora.

Publicar/despublicar organización en el registry Servicialo

Actualizar perfil de la organización (nombre, descripción, logo, vertical)

El campo logoUrl del tool mapea al campo logo en la DB. No existe campo website en el schema.

Resumen compacto de la organización: servicios, proveedores, horarios, features activas, onboarding status

Tool MCP-only (~500 tokens). Punto de entrada recomendado para agentes.

Listar miembros de la organización

Invitar miembro a la organización

Leer configuración de la organización por capítulo o keys específicas (31 settings, 7 capítulos)

Tool unificado que cubre todos los settings: basics, availability, communication, finances, policies, reminders, client_data.

Actualizar configuración de la organización (parcial, validado)

Escribe a 6 modelos Prisma en una transacción. Valida todos los valores antes de escribir.

Configurar políticas de cancelación

Cubierto por settings_get con chapter=policies y settings_update con keys policies.*

Definir campos personalizados de cliente

Cubierto por settings_get con chapter=client_data y settings_update con keys client_data.*

Configuración financiera (moneda, impuestos, cuentas)

Cubierto por settings_get con chapter=finances y settings_update con keys finances.*

Configurar cuentas bancarias de la organización

Gestión de suscripción y facturación de la plataforma

Configurar integraciones externas (API keys, webhooks)

Configurar dominio personalizado

Actualizar tasas de cambio desde fuentes externas

Sincronizar registry Servicialo

Sincronizar calendarios externos (Google Calendar)

Reintentar notificaciones fallidas

Dashboard diario del proveedor: sesiones de hoy, estadísticas

Rationale:Portal del proveedor es interactivo — no tiene sentido exponer vía MCP, el agente admin ya tiene booking_list.

Calendario completo del proveedor (día/semana/mes)

Lista de clientes del proveedor con estadísticas

Editar disponibilidad semanal (self-service)

Usa el mismo endpoint que availability.set-provider-schedule pero con auth de proveedor.

Métricas de rendimiento del proveedor (6 meses)

Wizard de onboarding: perfil + disponibilidad

Acceso al portal de cliente (magic link / token)

Rationale:Portal de cliente es un flujo interactivo para el usuario final.

Recibir movimiento bancario vía webhook Habilitalo/Fintoc

Webhook con verificación HMAC-SHA256. Deduplica eventos y triggerea matching async vía Inngest.

Matching automático de movimientos bancarios contra cobros (exact/fuzzy)

MatchingEngine con ventana de 3 días, scoring EXACT (1.0) y FUZZY (0.7). Emite planificalo.cobro.paid.v1 al matchear.

Listar posiciones de reconciliación con filtros

Rationale:Un agente podría consultar posiciones pendientes de match para reportar al admin.

Match manual forzado de posición contra cobro

Rationale:Match manual requiere juicio humano sobre cuál cobro asociar.

Marcar posición como excepción para revisión manual

Dashboard de salud de datos: integridad, consistencia, alertas

Rationale:Herramienta de diagnóstico admin — no requiere MCP.

Generar audio desde texto vía ElevenLabs API (TTS synthesis)

Package @coordinalo/respondelo. Provider: ElevenLabs (eleven_multilingual_v2). Requiere ELEVENLABS_API_KEY. Cost: ~$0.30/1000 chars.

Rationale:Sin MCP tool: funcionalidad interna del pipeline, no expuesta a agentes. Sin UI: operación backend. Sin Cron: on-demand.

Almacenar y servir audio cacheado para textos repetidos (SHA256 hash → AudioAsset)

Tablas: TtsCache (textHash + voiceProfileId → AudioAsset), AudioAsset, VoiceProfile. Hit count tracking. Cache transparente dentro del servicio TTS.

Rationale:Sin interfaces externas: capa de optimización interna. El cache es transparente — se activa automáticamente en cada llamada TTS.

Endpoint principal del pipeline Respondelo (interpret → think → render)

Pendiente de conectar. Pipeline 4 fases: Interpret (STT, TODO), Think (LLM, placeholder), Render (TTS, implementado), Record. Session management con ResponseSession + Exchange.

Rationale:Sin MCP: endpoint para consumo por canales (WhatsApp, web widget, phone). Sin UI: backend API. Sin Cron: event-driven.