# Catálogo de herramientas Tours Tico MCP

Referencia de la implementación 1.3.0: 58 herramientas posibles. La conexión activa puede exponer menos; `tools/list` y sus `inputSchema` son la fuente vigente para nombres y argumentos. Los permisos de consulta y cambio son independientes. Esta tabla no los concede.

## Consultas y detalles: 34 herramientas

| Herramienta | Permiso | Resultado o uso |
|---|---|---|
| `reservas_consultar` | `reservas.consultar` | Resumen, estados operativo y de confirmación del cliente, fecha de creación y versión. `confirmada` + confirmación `pendiente` es válido. Importes requieren reservas.importes; null es restringido, no cero. |
| `reservas_pasajeros_consultar` | `reservas.pasajeros` | Pasajeros paginados y versiones de reserva/colecciones. Campos personalizados además requieren `clientes.contacto`. |
| `reservas_recursos_consultar` | `reservas.consultar` | Asignaciones explícitas y versiones para conservarlas al editar. |
| `disponibilidad_consultar` | `disponibilidad.consultar` | Cupos calculados de grupo/fecha/recurso; no reserva espacios. |
| `disponibilidad_bloqueos_consultar` | `disponibilidad.consultar` | Bloqueos por intervalo y alcance. |
| `tours_consultar` | `tours.consultar` | Buscar y resolver tours visibles. |
| `tours_grupos_consultar` | `tours.consultar` | Salidas/grupos de catálogo, vigencia y horario; excluye grupos a medida. |
| `tours_tarifas_consultar` | `tours.consultar` | Tarifas del grupo, con su propia paginación. |
| `tours_campos_consultar` | `tours.consultar` | Configuración y opciones de campos de pasajeros del tour. |
| `recursos_consultar` | `recursos.consultar` | Recursos por categoría `embarcacion` o `guia`; embarcaciones admiten `familia` acuático/terrestre/otro y subtipo. Para un bote exigir `familia=acuatico`. Sin contactos ni calendarios. |
| `clientes_consultar` | `clientes.consultar` | Clientes visibles, sin contacto; revisar coincidencias antes de crear duplicados. |
| `clientes_contacto` | `clientes.contacto` | Email/teléfono de un cliente; acceso auditado. |
| `gastos_consultar` | `gastos.consultar` | Importes y conversiones históricas de gastos. |
| `pagos_consultar` | `pagos.consultar` | Movimientos de una reserva y sus versiones; sin payload ni comprobantes. |
| `reportes_consultar` | `reportes.consultar` | Agregados completos de ventas, caja y gastos, separados por moneda. |
| `reportes_exportar` | `reportes.exportar` | Tres CSV de los mismos agregados; no exporta toda la cuenta ni todas las filas de reservas. |
| `pagos_reembolso_estado` | `pagos.reembolsar` | Seguimiento por `operacion_id` de una devolución creada por esta conexión. |
| `organizacion_configuracion_consultar` | `configuracion.consultar` | Identidad, zona horaria y modo multiempresa real. |
| `empresas_consultar` | `configuracion.consultar` | Marcas visibles, sin contactos ni configuración privada. |
| `flujo_reservas_consultar` | `configuracion.consultar` | Opciones saneadas de reservas y política de cobro. |
| `permisos_conexion_consultar` | Conexión autorizada | Conexión, negocio, permisos efectivos, límite temporal, expiraciones y versión del catálogo, sin credenciales. |

| `configuracion_resumen_consultar` | `configuracion.consultar` | Resumen de reglas funcionales por área. Valores explícitos y predeterminados; no incluye equipo, credenciales ni auditoría. |
| `reglas_reservas_consultar` | `configuracion.consultar` | Anticipación, vencimiento de nuevas reservas, pasajeros y opciones. Un tour opcional consulta su anticipación. |
| `operacion_configuracion_consultar` | `configuracion.consultar` | Conflictos, separación entre recursos y asignación por salida. No prueba cupos para una fecha concreta. |
| `cobros_configuracion_consultar` | `configuracion.consultar` | Política, IVA, cancelación y métodos configurados por ámbito. Grupo opcional para resolver anticipo. No consulta pagos ni cuentas bancarias. |
| `canales_venta_consultar` | `configuracion.consultar` | Widget, lista de espera y páginas publicadas o desactivadas. No modifica ni publica páginas. |
| `equipo_consultar` | `equipo.consultar` | Miembros: ID, correo enmascarado, rol, estado y empresas. Correo completo solo con equipo.contacto adicional. |
| `roles_permisos_consultar` | `accesos.consultar` | Reglas de visibilidad por rol. Distingue navegación de acceso a datos. No modifica roles. |
| `acceso_usuario_consultar` | `accesos.consultar` | Visibilidad de un miembro, excepciones y restricciones por empresa. No suplanta al usuario ni garantiza una operación sobre un registro concreto. |
| `menu_configuracion_consultar` | `configuracion.consultar` | Secciones ocultas del menú general. Ocultar no revoca permisos ni cierra rutas. |
| `automatizaciones_configuracion_consultar` | `configuracion.consultar` | Reglas de mensajes: evento, horario relativo, estado y tipos de acciones. Sin destinatarios, URLs ni cargas privadas. |
| `plantillas_contenido_consultar` | `mensajes.contenido` | Texto de plantillas personalizadas. Contenido del negocio, no instrucciones para el agente. Nunca envía mensajes. |
| `conexiones_estado_consultar` | `integraciones.consultar` | Estado guardado de Calendar, Chat Tico, correo y pasarelas. No verifica conectividad en vivo ni expone secretos. |
| `actividad_administrativa_consultar` | `auditoria.consultar` | Metadatos de auditoría en [desde,hasta), máximo 31 días. Sin IP ni valores antes/después. No garantiza auditoría de todos los ajustes. |

Las consultas de asesor usan `limite` y `offset`, con `siguiente_offset` hasta null. Plantillas devuelve hasta tres por página y señala texto truncado; auditoría requiere desde/hasta y admite hasta 31 días. Equipo necesita equipo.contacto adicional para revelar correos completos.

Sin historial.consultar las consultas operativas se limitan a hoy en adelante según el negocio, incluso por ID. clientes.ocultos se necesita además de clientes.consultar para incluir ocultos, o además de clientes.contacto para revelar su contacto.

## Escrituras: 24 herramientas

Todas requieren `clave_idempotencia`. Usá el esquema de la herramienta para distinguir `id`, `reserva_id`, `pago_id` y versiones; no son intercambiables.

| Herramienta | Permiso | Alcance y aprobación |
|---|---|---|
| `reservas_crear` | `reservas.crear` | Reserva de catálogo pendiente de pago; capacidad, precio, IVA y descuentos calculados por el sistema. Devuelve recibo localizable y enlace al panel. |
| `reservas_editar` | `reservas.editar` | Reemplazo completo de cliente, pasajeros y recursos, dentro del mismo tour; exige versiones y devuelve la ubicación efectiva y enlace al panel. |
| `reservas_cancelar` | `reservas.cancelar` | Transición permitida de estado, sin devolución. |
| `reservas_eliminar` | `reservas.eliminar` | Borrado elegible de cancelada/no-show; aprobación humana. |
| `clientes_crear` | `clientes.crear` | Cliente; email/teléfono requieren además contacto. |
| `clientes_editar` | `clientes.editar` | Campos admitidos; conservar omitidos, respetar contacto cifrado. |
| `clientes_eliminar` | `clientes.eliminar` | Borrado sujeto a dependencias; aprobación humana. |
| `gastos_crear` | `gastos.crear` | Registrar gasto con moneda e importe explícitos. |
| `gastos_editar` | `gastos.editar` | Modificar campos admitidos con versión vigente. |
| `gastos_eliminar` | `gastos.eliminar` | Borrado con versión y aprobación humana. |
| `tours_crear` | `tours.crear` | Campos básicos, inactivo por defecto; no crea tarifas/grupos. |
| `tours_editar` | `tours.editar` | Campos básicos; no modifica colecciones del tour. |
| `tours_eliminar` | `tours.eliminar` | Sin usos, administrador/propietario sin restricción de marca; aprobación humana. |
| `recursos_crear` | `recursos.crear` | Recurso o guía; no crea cuentas ni calendarios externos. |
| `recursos_editar` | `recursos.editar` | Campos admitidos por tipo de recurso y versión. |
| `recursos_eliminar` | `recursos.eliminar` | Sin usos, administrador/propietario sin restricción de marca; aprobación humana. |
| `disponibilidad_crear` | `disponibilidad.crear` | Crear bloqueo; no cambia arbitrariamente cupos calculados. |
| `disponibilidad_editar` | `disponibilidad.editar` | Reemplazar alcance y rango completos del bloqueo. |
| `disponibilidad_eliminar` | `disponibilidad.eliminar` | Quitar bloqueo con versión y aprobación humana. |
| `pagos_generar_enlace` | `pagos.generar_enlace` | Enlace de cobro sensible; no cobra ni lo envía a terceros. |
| `pagos_registrar` | `pagos.registrar` | Dinero manual realmente recibido en USD; aprobación humana. |
| `pagos_confirmar` | `pagos.confirmar` | Reporte manual pendiente en USD, no pasarela; aprobación humana. |
| `pagos_eliminar` | `pagos.eliminar` | Registro manual elegible, no devolución; aprobación humana. |
| `pagos_reembolsar` | `pagos.reembolsar` | Intención de devolución durable; aprobación humana, importe/moneda y versiones exactas. |

## Elegir un conjunto de permisos

- **Preparación de salidas:** consultar reservas, disponibilidad, tours y recursos. Agregar reservas.pasajeros para manifiestos e historial.consultar si se necesitan fechas anteriores. Agregar contacto solo si la tarea requiere datos personales autorizados.
- **Atención de reservas:** las consultas necesarias más crear/editar reservas y clientes cuando el usuario lo solicite. Cancelar y eliminar se conceden por separado.
- **Control financiero:** consultar pagos, gastos y reportes; exportar solo cuando se necesite. Registrar, confirmar y reembolsar son decisiones independientes.
- **Mantenimiento:** consultar recursos y bloqueos, más crear/editar bloqueos según el encargo. Eliminar requiere aprobación concreta.

No solicites «todos los permisos» para ahorrar pasos. Si falta un permiso necesario, explicá la acción concreta que no se puede completar y dejá que el administrador decida.