Saltar al contenido
Docs
hi-client.com (se abre en una pestaña nueva)

Herramientas MCP

Descargar

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

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.