# Herramientas MCP

> Catálogo de las herramientas MCP de hiClient por área, con el permiso que exige cada una y si lee, escribe o borra.

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](https://docs.hi-client.com/agents/conventions.md?lang=es#whoami)).

## Tipos {#kinds}

| 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 {#account}

| 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 {#offers}

| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
| `offers_list` | Lista ofertas (eventos y estadías) con estado y fechas. 24 por página. | [`offers:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-read) | Lectura |
| `offers_get` | Lee una oferta completa con su `revision`. | [`offers:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-read) | Lectura |
| `offers_summary` | Totales de ofertas, borradores, reservas y ventas del período. | [`offers:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-read) | Lectura |
| `offers_drafts_list` | Lista los borradores privados del editor. | [`offers:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-read) | Lectura |
| `offers_draft_get` | Lee un borrador con la forma que acepta `offers_save`. | [`offers:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-write) | Escritura |
| `offers_set_published` | Publica o retira una oferta. Retirar corta la página y las reservas nuevas. | [`offers:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-write) | Escritura |
| `offers_reconnect` | Mueve una oferta de un equipo revocado a uno activo. | [`offers:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-write) | Escritura |
| `offers_draft_save` | Guarda un borrador privado sin validar ni publicar (hasta 50). | [`offers:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-write) | Escritura |
| `offers_draft_delete` | Borra un borrador privado en su `revision` y libera su lugar. Nunca toca ofertas ni reservas. | [`offers:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-read) | Lectura |
| `services_get` | Lee un servicio recurrente completo con su `revision`; `termsLocked` indica que ya tiene adhesiones. | [`offers:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#offers-write) | Destructiva |

## Reservas y calendario {#bookings}

| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
| `bookings_list` | Lista reservas recibidas. Filtro `pluginId` por instancia; 24 por página. | [`bookings:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#bookings-read) | Lectura |
| `bookings_get` | Lee una reserva: fechas, cantidad, importes, pago y asistencia. | [`bookings:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#bookings-read) | Lectura |
| `calendar_month` | Vista mensual: ofertas por día y cantidades confirmadas y pendientes. | [`bookings:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#bookings-read) | Lectura |

## Formularios y bandeja {#forms}

| 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`](https://docs.hi-client.com/agents/permissions.md?lang=es#forms-read) | Lectura |
| `inbox_tags_list` | Etiquetas de la bandeja y valores de llegada. | [`forms:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#forms-read) | Lectura |
| `forms_save` | Cambia un formulario en el borrador del sitio; se ve al publicar con `site_publish`. Acepta `dryRun`. | [`forms:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#forms-write) | Destructiva |
| `inbox_set_tags` | Reemplaza las etiquetas de un mensaje. | [`forms:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#forms-write) | Escritura |
| `inbox_tags_save` | Crea o renombra una etiqueta (hasta 20). | [`forms:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#forms-write) | Escritura |
| `inbox_tags_delete` | Borra una etiqueta. Los mensajes no se tocan. | [`forms:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#forms-write) | Destructiva |
| `inbox_defaults_set` | Elige si los mensajes nuevos llegan leídos y qué etiquetas reciben. | [`forms:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#forms-write) | Escritura |

## Sitio: perfil y publicación {#site}

| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
| `site_status` | Dirección, estado real (`draft`, `private`, `public`), `revision`, cambios pendientes, rubro y cantidades. | [`site:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |
| `site_content_set` | Lema, presentación, destacados, portada y fotos de la biblioteca. Lo omitido se conserva. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |
| `site_identity_set` | Estilo visual del rubro, color de acento, monograma y logo. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |
| `site_page_upsert` | Agrega o cambia una página extra: título, texto y foto opcional (hasta 6). | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |
| `site_page_remove` | Quita una página extra de los cambios pendientes. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Destructiva |
| `site_faq_set` | Reemplaza la lista de preguntas frecuentes (hasta 20). | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Destructiva |
| `site_publish` | Publica los cambios pendientes. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |
| `site_cancel_draft` | Descarta los cambios pendientes. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Destructiva |
| `site_unpublish` | Deja de servir el sitio publicado. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Destructiva |
| `site_publication_set` | Visibilidad, países, indexación y mensaje para visitantes bloqueados. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |
| `site_private_link_renew` | Emite un enlace privado nuevo e invalida el anterior. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Destructiva |
| `site_address_change` | Cambia la dirección; la anterior redirige a la nueva. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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 {#site-plugins}

| 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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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 {#site-media}

| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
| `site_media_list` | Biblioteca de archivos, trabajos recientes y uso del almacenamiento. | [`site:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-read) | Lectura |
| `site_media_catalog` | Busca fotos con licencia libre (CC0) en el catálogo. | [`site:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |
| `site_media_import` | Copia una foto del catálogo a la biblioteca (WebP) y espera unos segundos el resultado. | [`site:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#site-write) | Escritura |

## Mensajes y tickets {#messages}

| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
| `messages_list` | Mensajes recibidos, más nuevos primero. Filtro `pluginId` por instancia. | [`messages:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-read) | Lectura |
| `messages_get` | Un mensaje con respuestas, conversación y notas privadas. | [`messages:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-read) | Lectura |
| `tickets_list` | Tickets de soporte de la cuenta. | [`messages:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-read) | Lectura |
| `tickets_get` | Un ticket y una página de sus mensajes. | [`messages:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-read) | Lectura |
| `tickets_create` | Abre un ticket de soporte. | [`messages:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-write) | Escritura |
| `tickets_reply` | Responde un ticket propio, salvo que soporte lo haya cerrado a nuevos mensajes. | [`messages:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-write) | Escritura |
| `tickets_set_status` | Cierra o reabre un ticket propio. | [`messages:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-read) | Lectura |
| `contact_policy_set` | Reemplaza esa política (sólo como lo pidió la empresa). | [`messages:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#messages-reply) | Contacta terceros |

Los cambios de estado, notas y etiquetas de los mensajes están en [Formularios y bandeja](#forms).

## Publicaciones {#publications}

| 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`](https://docs.hi-client.com/agents/permissions.md?lang=es#publications-read) | Lectura |
| `publications_publish` | Publica o edita un post, o encola un envío a listados de una PC. Acepta `dryRun`. | [`publications:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#publications-write) | Escritura |
| `publications_delete` | Borra un post o quita un envío aceptado del historial. | [`publications:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#publications-write) | Destructiva |
| `publications_enable` | Activa la pestaña de publicaciones del perfil público. | [`publications:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#publications-write) | Escritura |

## Reportes {#reports}

| Herramienta | Para qué sirve | Permiso | Tipo |
|---|---|---|---|
| `reports_overview` | Contadores del tablero. | [`reports:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#reports-read) | Lectura |
| `reports_dashboard` | Cifras de las tarjetas del inicio del portal. | [`reports:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#reports-read) | Lectura |
| `reports_sales` | Ventas agregadas por día, moneda y estado (hasta 366 días). | [`reports:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#reports-read) | Lectura |
| `reports_orders_list` | Pedidos de cobro en línea. 25 por página. | [`reports:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#reports-read) | Lectura |
| `reports_orders_get` | Un pedido de cobro. | [`reports:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#reports-read) | Lectura |

## Equipos y alertas {#devices}

| 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`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-read) | Lectura |
| `devices_topology` | Mapa de equipos: redes locales, conexiones entre equipos y respaldos. | [`devices:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-read) | Lectura |
| `devices_access_feed` | Últimos accesos: hora, método, resultado y equipo. | [`devices:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-read) | Lectura |
| `devices_access_stats` | Conteo diario de accesos por resultado (hasta 90 días). | [`devices:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-read) | Lectura |
| `alerts_recipients_list` | Destinatarios de alertas, con el correo enmascarado. | [`devices:read`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-read) | Lectura |
| `devices_rename` | Renombra un equipo activo. | [`devices:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-write) | Escritura |
| `devices_revoke` | Revoca un equipo. Pide un ingreso reciente: responde `portal_only` y se hace en el portal. | [`devices:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-write) | Escritura |
| `alerts_recipient_add` | Agrega un destinatario y le envía un código de verificación por correo. | [`devices:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-write) | Contacta terceros |
| `alerts_recipient_verify` | Confirma un destinatario con su código de 6 dígitos. | [`devices:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-write) | Escritura |
| `alerts_recipient_remove` | Quita un destinatario pendiente. | [`devices:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-write) | Destructiva |
| `alerts_channel_set` | Reanuda el canal de correo de alertas. | [`devices:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#devices-write) | Escritura |

## Perfil y ajustes {#profile}

| 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`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-read) | Lectura |
| `profile_save` | Datos de la cuenta y la organización, incluido el formato de fechas de la empresa. | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `profile_public_save` | Perfil público y pestañas de la app móvil. | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `settings_language_set` | Idioma de la interfaz (`es`, `en`, `pt`). | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `settings_appearance_set` | Tema `dark` o `light`. | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `settings_notifications_set` | Tipos de notificación y canales web y correo. | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `settings_toasts_set` | Avisos emergentes: duración y tipos opcionales (confirmaciones, información, notificaciones nuevas). | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `workspace_cards_set` | Tarjetas visibles del inicio del portal. | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `workspace_banner_set` | Banner del inicio (`mountains`, `sea`, `jungle`, `desert`). | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#profile-write) | Escritura |
| `workspace_navigation_set` | Orden y secciones archivadas del menú izquierdo del portal. | [`profile:write`](https://docs.hi-client.com/agents/permissions.md?lang=es#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 {#not-included}

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](https://docs.hi-client.com/agents/overview.md?lang=es#portal-only).

## Servicios y cuotas {#recurring-services}

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}

`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-workspace}

`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 {#durable-responses}

`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}

`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`.
