Las herramientas se llaman área_verbo (por ejemplo offers_list). Un agente sólo ve las herramientas de los permisos que le concediste: account_whoami informa en agent.notGranted los que faltan (ver Convenciones).
Tipos
| Tipo | Significado |
|---|---|
| Lectura | No cambia nada. Se puede repetir sin efectos. |
| Escritura | Cambia algo de la cuenta. Queda en la auditoría. |
| Destructiva | Borra, retira, revoca o descarta algo, o corta un acceso. Revisala antes de aprobar. |
| Contacta terceros | Envía un correo o trae contenido de afuera de la cuenta. |
Cada herramienta declara sus anotaciones MCP exactas (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) en tools/list. Los asistentes suelen pedirte aprobación antes de ejecutar las que no son de sólo lectura.
Cuenta
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
account_whoami |
Cuenta, empresa y tu rol en ella, plan, permisos concedidos, qué cubre cada área y qué queda reservado al portal. | ninguno | Lectura |
Ofertas
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
offers_list |
Lista ofertas (eventos y estadías) con estado y fechas. 24 por página. | offers:read |
Lectura |
offers_get |
Lee una oferta completa con su revision. |
offers:read |
Lectura |
offers_summary |
Totales de ofertas, borradores, reservas y ventas del período. | offers:read |
Lectura |
offers_activity |
Actividad de una oferta o servicio: respuestas por estado, ocupación, cobrado, visitas, serie de 30 días e historial de publicación. | offers:read |
Lectura |
offers_drafts_list |
Lista los borradores privados del editor. | offers:read |
Lectura |
offers_draft_get |
Lee un borrador con la forma que acepta offers_save. |
offers:read |
Lectura |
offers_save |
Crea una oferta o la reemplaza completa. Informa juntos todos los campos faltantes o inválidos. Acepta dryRun. |
offers:write |
Escritura |
offers_set_published |
Publica o retira una oferta. Retirar corta la página y las reservas nuevas. | offers:write |
Destructiva |
offers_duplicate |
Copia una oferta sin publicar, sin reservas ni pagos. Devuelve fieldIds: id de cada campo original → id en la copia. |
offers:write |
Escritura |
offers_reconnect |
Mueve una oferta de un equipo revocado a uno activo. | offers:write |
Escritura |
offers_draft_save |
Guarda un borrador privado sin validar ni publicar (hasta 50). | offers:write |
Escritura |
offers_draft_delete |
Borra un borrador privado en su revision y libera su lugar. Nunca toca ofertas ni reservas. |
offers:write |
Destructiva |
services_list |
Lista los servicios recurrentes (membresías, cuotas, clases) con precio, frecuencia, lugares ocupados y estado, y los canales del mercado de la empresa. 24 por página. | offers:read |
Lectura |
services_get |
Lee un servicio recurrente completo con su revision; termsLocked indica que ya tiene adhesiones. |
offers:read |
Lectura |
services_save |
Crea un servicio recurrente o lo actualiza (lo omitido se conserva), con las reglas del editor del portal. Informa juntos todos los campos inválidos. Acepta dryRun y devuelve los próximos períodos. |
offers:write |
Escritura |
services_set_published |
Publica o retira un servicio recurrente. Retirar corta la página y las adhesiones nuevas; las existentes se conservan. | offers:write |
Destructiva |
Reservas y calendario
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
bookings_list |
Lista reservas recibidas. Filtro pluginId por instancia; 24 por página. |
bookings:read |
Lectura |
bookings_get |
Lee una reserva: fechas, cantidad, importes, pago y asistencia. | bookings:read |
Lectura |
calendar_month |
Vista mensual: ofertas por día y cantidades confirmadas y pendientes. | bookings:read |
Lectura |
Formularios y bandeja
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
forms_list |
Formularios del sitio (módulos Contacto y Postulación), publicados y en borrador, con la revision que piden forms_save y las herramientas site_*. published queda vacío mientras el sitio no está publicado (sitePublished). |
forms:read |
Lectura |
inbox_tags_list |
Etiquetas de la bandeja y valores de llegada. | forms:read |
Lectura |
forms_save |
Cambia un formulario en el borrador del sitio; se ve al publicar con site_publish. Acepta dryRun. |
forms:write |
Escritura |
plugin_forms_list |
Formularios propios (kind=form, plugin Formularios) o búsquedas laborales (kind=job, plugin Empleos) con estado, revision, cierre, límite y cuántas respuestas llegaron (total y nuevas). Sin contenido de respuestas. |
forms:read |
Lectura |
plugin_form_get |
Un formulario o búsqueda con sus preguntas, configuración y (búsqueda) área, modalidad, jornada, ubicación, salario, requisitos y beneficios. | forms:read |
Lectura |
plugin_forms_answers_summary |
Cantidad de respuestas de cada formulario o postulaciones de cada búsqueda, por estado. Sin respuestas, personas ni archivos. | forms:read |
Lectura |
plugin_form_save |
Crea o cambia un formulario o búsqueda (preguntas de 11 tipos, mensaje de confirmación, límite, cierre, datos del puesto). Se aplica al instante; uno nuevo queda en borrador. Acepta dryRun. |
forms:write |
Escritura |
plugin_form_set_state |
Abre, cierra, archiva o vuelve a borrador un formulario o búsqueda. Las respuestas se conservan. | forms:write |
Escritura |
registration_requirements_get |
Datos que la app de hiClient pide a quien se registra en la empresa (datos personales además del nombre, campos de la ficha y rostro), con la revision y el cambio pendiente de aplicar en la PC. |
forms:read |
Lectura |
registration_requirements_set |
Elige esos datos; la PC que recibe las solicitudes aplica el cambio cuando está en línea. | forms:write |
Escritura |
inbox_change |
Marca leído o no leído, cambia el estado o la nota de un mensaje. Cerrar revoca el enlace del visitante. | forms:write |
Destructiva |
inbox_set_tags |
Reemplaza las etiquetas de un mensaje. | forms:write |
Escritura |
inbox_tags_save |
Crea o renombra una etiqueta (hasta 20). | forms:write |
Escritura |
inbox_tags_delete |
Borra una etiqueta. Los mensajes no se tocan. | forms:write |
Destructiva |
inbox_defaults_set |
Elige si los mensajes nuevos llegan leídos y qué etiquetas reciben. | forms:write |
Escritura |
Sitio: perfil y publicación
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
site_status |
Dirección, estado real (draft, private, public), revision, cambios pendientes, rubro y cantidades. |
site:read |
Lectura |
site_get |
Lee el perfil (borrador o publicado): rubro, identidad, contenido, módulos con su visibilidad y estado operativo, páginas extra y preguntas. | site:read |
Lectura |
site_address_check |
Dice si una dirección es válida, está libre o la retiró esta cuenta (previous: true). |
site:read |
Lectura |
site_create |
Crea el sitio con la estructura del tipo de negocio, sin publicar. Pide la dirección y, si falta, el nombre público. | site:write |
Escritura |
site_content_set |
Lema, presentación, destacados, portada y fotos de la biblioteca. Lo omitido se conserva. | site:write |
Escritura |
site_identity_set |
Estilo visual del rubro, color de acento, monograma y logo. | site:write |
Escritura |
site_page_upsert |
Agrega o cambia una página extra: título, texto y foto opcional (hasta 6). | site:write |
Escritura |
site_page_remove |
Quita una página extra de los cambios pendientes. | site:write |
Destructiva |
site_faq_set |
Reemplaza la lista de preguntas frecuentes (hasta 20). | site:write |
Destructiva |
site_publish |
Publica los cambios pendientes. | site:write |
Escritura |
site_cancel_draft |
Descarta los cambios pendientes. | site:write |
Destructiva |
site_unpublish |
Deja de servir el sitio publicado. | site:write |
Destructiva |
site_publication_set |
Visibilidad, países, indexación y mensaje para visitantes bloqueados. | site:write |
Escritura |
site_private_link_renew |
Emite un enlace privado nuevo e invalida el anterior. | site:write |
Destructiva |
site_address_change |
Cambia la dirección; la anterior redirige a la nueva. | site:write |
Escritura |
El nombre, la descripción, la dirección, los horarios y los enlaces del negocio no son parte del sitio: se leen con profile_get y se cambian con profile_public_save. Las ofertas, los precios y la disponibilidad salen de la operación (offers_*, bookings_*).
Sitio: módulos
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
site_module_set |
Habilita o deshabilita un módulo (habilitado = se muestra en el perfil público, al instante) y cambia su título y su configuración (formularios, ofertas que lista, galería). En los plugins, además suspende o reanuda inscripciones, fija la fecha de cierre y archiva. No borra ofertas, reservas, pagos, respuestas ni mensajes. | site:write |
Escritura |
Módulos: about, stays, events, catalog, calendar, services, gallery, posts, faq, location, contact, registration, pages. Cada rubro ofrece los suyos y los nombra a su manera, por ejemplo «Habitaciones» para stays en un hotel.
Ocultar un módulo no desactiva su operación: las ofertas siguen publicadas y reservables y los mensajes siguen llegando. Una sección se ve cuando el módulo está visible y su fuente tiene contenido (shown); state y operateUrl dicen qué falta y dónde se resuelve. Todas las escrituras del sitio usan una sola revision: si cambió, responden conflict con currentRevision.
Sitio: archivos
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
site_media_list |
Biblioteca de archivos, trabajos recientes y uso del almacenamiento. | site:read |
Lectura |
site_media_catalog |
Busca fotos con licencia libre (CC0) en el catálogo. | site:read |
Lectura |
site_media_upload |
Sube una imagen o un documento chico en base64. Se convierte a un formato uniforme (WebP, MP4 o PDF) y la herramienta espera unos segundos el resultado. | site:write |
Escritura |
site_media_import |
Copia una foto del catálogo a la biblioteca (WebP) y espera unos segundos el resultado. | site:write |
Contacta terceros |
site_media_change |
Renombra, mueve de carpeta (un solo nivel), protege o envía a la papelera un archivo. sanitized: true si ajustó el nombre o la carpeta. |
site:write |
Escritura |
Mensajes y tickets
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
messages_list |
Mensajes recibidos, más nuevos primero. Filtro pluginId por instancia. |
messages:read |
Lectura |
messages_get |
Un mensaje con respuestas, conversación y notas privadas. | messages:read |
Lectura |
tickets_list |
Tickets de soporte de la cuenta. | messages:read |
Lectura |
tickets_get |
Un ticket y una página de sus mensajes. | messages:read |
Lectura |
tickets_create |
Abre un ticket de soporte. | messages:write |
Escritura |
tickets_reply |
Responde un ticket propio, salvo que soporte lo haya cerrado a nuevos mensajes. | messages:write |
Escritura |
tickets_set_status |
Cierra o reabre un ticket propio. | messages:write |
Escritura |
messages_settings_get |
Respuestas automáticas de la empresa por canal (chat de la app, mensaje del sitio, formulario): bienvenida, ausencia con horario y menú de opciones del chat. | messages:read |
Lectura |
messages_settings_set |
Reemplaza esas respuestas automáticas (sólo textos escritos por la empresa; enlaces de un catálogo cerrado). | messages:write |
Escritura |
contact_policy_get |
Cómo te contactan los clientes desde la app: quién puede escribir, llamar y hacer videollamadas (grupos combinables: cualquier persona, quien envió su solicitud, clientes aceptados, quien compró, quien señó o reservó, inscriptos a eventos próximos o en curso) y cómo se aceptan las solicitudes, con un resumen en una frase. | messages:read |
Lectura |
contact_policy_set |
Reemplaza esa política (sólo como lo pidió la empresa). | messages:write |
Escritura |
inbox_reply |
Responde a un visitante en tu nombre: le llega un correo con un enlace privado. Sólo aparece si concediste messages:reply. |
messages:reply |
Contacta terceros |
Los cambios de estado, notas y etiquetas de los mensajes están en Formularios y bandeja.
Publicaciones
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
publications_list |
Posts del perfil público (con sizeBytes y mediaBytes), listados de tus PC y envíos pendientes. |
publications:read |
Lectura |
publications_publish |
Publica o edita un post, o encola un envío a listados de una PC. Acepta dryRun. |
publications:write |
Escritura |
publications_delete |
Borra un post o quita un envío aceptado del historial. | publications:write |
Destructiva |
publications_enable |
Activa la pestaña de publicaciones del perfil público. | publications:write |
Escritura |
Reportes
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
reports_overview |
Contadores del tablero. | reports:read |
Lectura |
reports_dashboard |
Cifras de las tarjetas del inicio del portal. | reports:read |
Lectura |
reports_sales |
Ventas agregadas por día, moneda y estado (hasta 366 días). | reports:read |
Lectura |
reports_orders_list |
Pedidos de cobro en línea. 25 por página. | reports:read |
Lectura |
reports_orders_get |
Un pedido de cobro. | reports:read |
Lectura |
Equipos y alertas
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
devices_list |
Equipos activos y máximo del plan, con ubicación, rol, red local y respaldos de cada equipo. | devices:read |
Lectura |
devices_topology |
Mapa de equipos: redes locales, conexiones entre equipos y respaldos. | devices:read |
Lectura |
devices_pending_desktop |
Qué espera a la app de escritorio: cantidades por tipo (reservas, entradas, inscripciones, solicitudes…) y si hay una PC vinculada. | devices:read |
Lectura |
devices_access_feed |
Últimos accesos: hora, método, resultado y equipo. | devices:read |
Lectura |
devices_access_stats |
Conteo diario de accesos por resultado (hasta 90 días). | devices:read |
Lectura |
alerts_recipients_list |
Destinatarios de alertas, con el correo enmascarado. | devices:read |
Lectura |
devices_rename |
Renombra un equipo activo. | devices:write |
Escritura |
devices_revoke |
Revoca un equipo. Pide un ingreso reciente: responde portal_only y se hace en el portal. |
devices:write |
Destructiva |
devices_use_seat |
Elige qué equipo conserva un asiento del plan. Pide un ingreso reciente: responde portal_only y se hace en el portal. |
devices:write |
Escritura |
alerts_recipient_add |
Agrega un destinatario y le envía un código de verificación por correo. | devices:write |
Contacta terceros |
alerts_recipient_verify |
Confirma un destinatario con su código de 6 dígitos. | devices:write |
Escritura |
alerts_recipient_remove |
Quita un destinatario pendiente. | devices:write |
Destructiva |
alerts_channel_set |
Reanuda el canal de correo de alertas. | devices:write |
Escritura |
Perfil y ajustes
| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
profile_get |
Cuenta, organización, formato de fechas de la empresa, perfil público, notificaciones e inicio del portal. | profile:read |
Lectura |
profile_save |
Datos de la cuenta y la organización, incluido el formato de fechas de la empresa. | profile:write |
Escritura |
profile_public_save |
Perfil público y pestañas de la app móvil. | profile:write |
Escritura |
settings_language_set |
Idioma de la interfaz (es, en, pt). |
profile:write |
Escritura |
settings_appearance_set |
Tema dark o light. |
profile:write |
Escritura |
settings_notifications_set |
Tipos de notificación y canales web y correo. | profile:write |
Escritura |
settings_toasts_set |
Avisos emergentes: duración y tipos opcionales (confirmaciones, información, notificaciones nuevas). | profile:write |
Escritura |
workspace_cards_set |
Tarjetas visibles del inicio del portal. | profile:write |
Escritura |
workspace_banner_set |
Banner del inicio (mountains, sea, jungle, desert). |
profile:write |
Escritura |
workspace_navigation_set |
Orden y secciones archivadas del menú izquierdo del portal. | profile:write |
Escritura |
profile_get y profile_save devuelven account.businessDateOrder, el orden de fechas vigente de la empresa. En profile_save, businessDateOrder admite dmy (día/mes/año), mdy (mes/día/año) o ymd (año/mes/día). Omitirlo conserva la elección; una cadena vacía restaura el valor según el país de la empresa. Es independiente de las preferencias personales.
Lo que no está en el catálogo
Por diseño, no hay herramientas para planes, pagos, cobros, dominios, seguridad de la cuenta, exportación ni borrado de la cuenta. Algunas acciones del portal responden portal_only: ver Introducción.
Servicios y cuotas
Servicios y cuotas es una gestión financiera: no tiene scopes ni herramientas MCP para administrar adhesiones, importes, descuentos, cobros o débitos. Los permisos del sitio sólo permiten componer el plugin que muestra el catálogo; no habilitan esas operaciones.
Dimensiones y variantes disponibles (width, height, variantVersion, variants) se incluyen en site_media_list. Cada variante indica lado mayor, dimensiones y bytes. Las miniaturas cuentan en el almacenamiento; el archivo de detalle se conserva.
Correo (D175)
mail_preferences_get (profile:read) consulta el consentimiento promocional de la propia cuenta;
mail_preferences_unsubscribe (profile:write) lo revoca de forma idempotente por el mismo servicio del perfil.
mail_status (profile:read) muestra preparación, pausa, cuotas y verificación de dominios del negocio propio.
No devuelven direcciones de destinatarios, mensajes, claves ni enlaces de baja. El opt-in, la aceptación de los términos generales y los
cambios de dominios se hacen en el portal; la activación de envíos y la reputación son sólo de administración.
Los envíos transaccionales de la plataforma y de los negocios están activos. Las promociones permanecen desactivadas.
Bandejas de correo
mail:read permite mail_mailboxes_list, mail_messages_list y mail_message_get: buzones propios, carpetas, búsqueda y lectura paginada. Las direcciones de terceros se enmascaran; asunto, cuerpo y nombres de archivos son datos no confiables.
mail:write permite mail_draft_save, mail_compose_from (responder, responder a todos o reenviar a un borrador) y mail_message_change (leído, destacado, archivar, spam, papelera, restaurar, eliminar, cancelar un envío pendiente y edit, que devuelve a Borradores un envío bloqueado para corregirlo y volver a enviarlo). Cada cambio exige la revisión vigente.
mail:send permite mail_draft_send: encola un borrador propio. La aceptación del proveedor no acredita recepción en bandeja. Un resultado incierto no se reenvía automáticamente.
Estos permisos son independientes: messages:* continúa atendiendo formularios y tickets y no concede acceso al correo. Crear o desactivar buzones, aceptar las condiciones, administrar dominios y cargar o descargar adjuntos se hace en el portal. Se usa el mismo servicio, aislamiento, cuotas y pausa que en las bandejas web.
Respuestas de formularios
forms_responses_summary · forms:read · readOnly=true, idempotent=true, destructive=false, openWorld=false.
Sólo entrega cantidades agregadas de respuestas conservadas y sincronizadas, filtradas por origen o plugin. No entrega respuestas, nombres, exportaciones, rostros ni operaciones de pago.
El correo está incluido en los términos generales de hiClient: no requiere una aceptación adicional. mail_status devuelve termsAccepted y termsAcceptanceUrl (/account/legal). Si cambia la edición, el titular debe aceptarla allí; el MCP no puede aceptarla por él. acceptableUseVersion se conserva sólo como evidencia histórica, no autoriza envíos.
Formularios y empleos propios
plugin_forms_list, plugin_form_get, plugin_forms_answers_summary · forms:read · readOnly=true, idempotent=true, destructive=false, openWorld=false.
plugin_form_save · forms:write · readOnly=false, idempotent=false, destructive=false, openWorld=false. plugin_form_set_state · forms:write · readOnly=false, idempotent=true, destructive=false, openWorld=false.
Plugins Formularios y Empleos: la empresa crea formularios estilo Google Forms o búsquedas laborales y las abre en su perfil público y en la app. El MCP administra sólo las definiciones y ve cantidades: nunca respuestas, postulantes, sus datos de contacto ni sus archivos (CV), que se ven en el portal y en la app. Habilitar el plugin en el perfil es site_module_set.