Herramientas MCP soportadas

Las herramientas MCP de Soyio están diseñadas para que un agente pueda combinar operaciones de lectura y escritura en flujos completos. Un mismo prompt puede consultar productos, revisar plantillas, crear un workflow y publicar cambios si la conexión tiene permisos suficientes.

Superficies disponibles

Superficie	Identificador	Qué cubre
Configuración y recursos base	core	Usuarios de compañía, productos, sucursales, documentos, exports y permisos
Consentimientos	consents	Plantillas, acciones, commits, correcciones, revocaciones y métricas
Disclosures	disclosures	Plantillas y solicitudes de disclosure
Validaciones	validations	Intentos de validación y estadísticas
Solicitudes de derechos	dsrs	Creación, revisión y resolución de DSRs
Workflows	workflows	Automatizaciones, versiones, ejecuciones, eventos y configuración
Cookies	cookies	Sitios, escaneos, inventario, banners y decisiones auditables

Las herramientas disponibles dependen del modo de acceso, el entorno y los permisos de la conexión. Revisa esos conceptos en la introducción a MCP o consulta tus conexiones en el dashboard de Soyio.

Empieza con core cuando estés explorando una empresa por primera vez. Luego agrega toolsets específicos según la tarea, como workflows para automatizaciones, consents para plantillas de consentimiento o cookies para administrar banners.

Declara toolsets en la URL

Limita las herramientas visibles agregando toolsets a la URL del servidor MCP.

https://mcp.soyio.id/mcp?toolsets=core,workflows

Usa una lista separada por comas o all para solicitar todas las herramientas disponibles para la conexión.

URL	Herramientas visibles
https://mcp.soyio.id/mcp	Todos los toolsets autorizados para la conexión
https://mcp.soyio.id/mcp?toolsets=core	Solo configuración base
https://mcp.soyio.id/mcp?toolsets=core,consents	Configuración base y consentimientos
https://mcp.soyio.id/mcp?toolsets=disclosures,validations	Disclosures y validaciones
https://mcp.soyio.id/mcp?toolsets=dsrs,workflows	Solicitudes de derechos y workflows
https://mcp.soyio.id/mcp?toolsets=cookies	Sitios, inventario, banners y decisiones de cookies
https://mcp.soyio.id/mcp?toolsets=all	Todos los toolsets autorizados para la conexión

El servidor intersecta los toolsets de la URL con los toolsets autorizados para la conexión. Si pides un toolset no autorizado, Soyio no lo expone al cliente. Para ver cómo configurar estas URLs en clientes MCP, consulta configurar clientes MCP.

toolsets reduce el catálogo de herramientas visible en el cliente, pero no cambia permisos. La conexión aprobada en Soyio sigue siendo la fuente de autorización.

Configuración y recursos base

Usa esta superficie para entender la estructura de una compañía antes de operar otros módulos.

Herramienta	Qué hace
soyio_list_permissions	Lista permisos disponibles para API o dashboard
soyio_list_company_users	Lista usuarios de la compañía
soyio_get_company_user	Obtiene un usuario de compañía por token
soyio_list_products	Lista productos
soyio_get_product	Obtiene un producto por token
soyio_list_product_versions	Lista versiones guardadas de un producto
soyio_get_product_version	Obtiene una versión específica de un producto
soyio_list_branches	Lista sucursales o filiales
soyio_get_branch	Obtiene una sucursal por token
soyio_list_privacy_documents	Lista documentos de privacidad
soyio_get_privacy_document	Obtiene un documento de privacidad por token
soyio_list_privacy_document_versions	Lista versiones guardadas de un documento de privacidad
soyio_get_privacy_document_version	Obtiene una versión específica de un documento de privacidad
soyio_list_exports	Lista exports asincrónicos
soyio_get_export	Obtiene el estado y detalle de un export
soyio_create_export	Crea un export asincrónico para consent actions o consent commits

Ejemplos de prompts:

• “Lista los productos activos y dime cuáles tienen documentos de privacidad asociados”.
• “Crea un export de consent commits para revisar actividad reciente”.
• “Qué permisos API necesita una integración que solo lee workflows”.

Consentimientos

Usa esta superficie para crear y auditar plantillas de consentimiento y revisar la actividad asociada.

Herramienta	Qué hace
soyio_list_consent_templates	Lista plantillas de consentimiento
soyio_get_consent_template	Obtiene la última versión de una plantilla
soyio_list_consent_template_versions	Lista versiones guardadas de una plantilla
soyio_get_consent_template_version	Obtiene una versión específica de una plantilla
soyio_create_consent_template	Crea una plantilla de consentimiento
soyio_update_consent_template	Actualiza una plantilla y crea una nueva versión
soyio_list_consent_corrections	Lista correcciones de consentimiento iniciadas por la compañía
soyio_get_consent_correction	Obtiene una corrección por token
soyio_get_consent_revocation	Obtiene una revocación por token
soyio_list_consent_actions	Lista acciones de consentimiento
soyio_get_consent_action	Obtiene una acción de consentimiento por token
soyio_get_consent_action_stats	Obtiene estadísticas agregadas de acciones
soyio_list_consent_commits	Lista commits de consentimiento
soyio_get_consent_commit	Obtiene un commit por token
soyio_get_consent_commit_stats	Obtiene estadísticas agregadas de commits

Ejemplos de prompts:

• “Crea una plantilla de consentimiento para comunicaciones de marketing por email”.
• “Compara la versión actual de esta plantilla con la anterior”.
• “Resume las revocaciones y correcciones recientes de consentimiento”.

Disclosures

Usa esta superficie para administrar plantillas de disclosure y analizar solicitudes.

Herramienta	Qué hace
soyio_list_disclosure_templates	Lista plantillas de disclosure
soyio_get_disclosure_template	Obtiene una plantilla por token
soyio_create_disclosure_template	Crea una plantilla de disclosure
soyio_update_disclosure_template	Actualiza una plantilla existente
soyio_delete_disclosure_template	Elimina una plantilla sin solicitudes asociadas
soyio_list_disclosure_requests	Lista solicitudes de disclosure
soyio_get_disclosure_request	Obtiene una solicitud por token
soyio_get_disclosure_request_stats	Obtiene estadísticas agregadas de solicitudes

Ejemplos de prompts:

• “Crea una plantilla de disclosure para onboarding de clientes”.
• “Lista las solicitudes granted de la última semana”.
• “Resume métricas de solicitudes por estado”.

Validaciones

Usa esta superficie para revisar intentos de validación de identidad y métricas operacionales.

Herramienta	Qué hace
soyio_list_validation_attempts	Lista intentos de validación
soyio_get_validation_attempt	Obtiene un intento por token
soyio_get_validation_attempt_stats	Obtiene estadísticas agregadas de validaciones

Ejemplos de prompts:

• “Muéstrame intentos fallidos recientes y agrúpalos por motivo”.
• “Obtén estadísticas de validaciones en zona horaria America/Santiago”.
• “Revisa este intento de validación y resume su estado”.

Solicitudes de derechos

Usa esta superficie para crear, revisar y resolver solicitudes de derechos de titulares.

Herramienta	Qué hace
soyio_list_data_subject_requests	Lista solicitudes de derechos
soyio_get_data_subject_request	Obtiene una solicitud por token
soyio_create_data_subject_request	Crea una solicitud de derechos
soyio_resolve_data_subject_request	Resuelve una solicitud con estado terminal

Ejemplos de prompts:

• “Lista las solicitudes de acceso pendientes y priorízalas por antigüedad”.
• “Crea una solicitud de supresión para este titular”.
• “Prepara una respuesta de aprobación parcial para esta solicitud”.

Cookies

Usa esta superficie para completar el flujo desde la creación de un sitio hasta la publicación del banner y el análisis de decisiones.

Sitios y escaneos

Herramienta	Qué hace
soyio_list_cookie_sites	Lista sitios de cookies
soyio_get_cookie_site	Obtiene un sitio por token
soyio_create_cookie_site	Crea un sitio para un dominio registrable
soyio_update_cookie_site	Actualiza nombre, activación y opciones de escaneo
soyio_disable_cookie_site	Deshabilita el runtime sin borrar inventario ni evidencia
soyio_trigger_cookie_site_scan	Encola un escaneo o devuelve el escaneo activo

Proveedores e inventario

Herramienta	Qué hace
soyio_list_cookie_provider_groups	Lista grupos de proveedores de un sitio
soyio_get_cookie_provider_group	Obtiene un grupo de proveedores
soyio_create_cookie_provider_group	Crea un grupo de proveedores
soyio_update_cookie_provider_group	Actualiza nombre o descripción
soyio_delete_cookie_provider_group	Elimina el grupo y deja sus cookies sin asignar
soyio_list_cookie_inventory_items	Lista cookies detectadas o agregadas manualmente
soyio_get_cookie_inventory_item	Obtiene una cookie del inventario
soyio_create_cookie_inventory_item	Agrega una cookie manualmente
soyio_update_cookie_inventory_item	Edita o confirma su clasificación
soyio_delete_cookie_inventory_item	Elimina una cookie del inventario

Configuraciones y decisiones

Herramienta	Qué hace
soyio_list_cookie_banner_configs	Lista las últimas revisiones de cada configuración
soyio_get_cookie_banner_config	Obtiene la última revisión de una configuración
soyio_create_cookie_banner_config	Crea una configuración draft
soyio_update_cookie_banner_config	Crea una nueva revisión draft
soyio_publish_cookie_banner_config	Publica una revisión y captura su inventario
soyio_archive_cookie_banner_config	Archiva el linaje de una configuración
soyio_list_cookie_consent_actions	Lista decisiones auditables de visitantes
soyio_get_cookie_consent_action	Obtiene una decisión con el estado del sujeto, la materialización y la prueba del recibo
soyio_get_cookie_consent_action_stats	Obtiene métricas de decisiones por rango y zona horaria

Las acciones anónimas no tienen Agreement ni Evidence. Las acciones atribuidas incluyen estos identificadores solo después de completar la materialización.

Los tokens de sesión identificada no son herramientas MCP. Solicítalos desde tu backend con Crear un token de sesión identificada para cookies. El endpoint devuelve un JWT de vida corta que no debes exponer al modelo.

Confirma el recurso exacto antes de deshabilitar sitios, eliminar proveedores o cookies, y archivar configuraciones. Estas herramientas están marcadas como destructivas.

Entradas soportadas

Grupo	Entradas
Listas	limit, cursor, order_by y where. Omite cursor en la primera página y reutiliza solo el next_cursor recibido
Sitios	name, registrable_domain, enabled, scan_enabled, scan_interval_days y scan_report_recipients
Proveedores	name y description
Inventario	name, domain, path, category, description, declared_duration, cookie_provider_group_id y classification_status: "confirmed"
Banner	appearance, content, localized_content, URLs de documentos y campos de imagen del ícono
Estadísticas	where, period_days, from, to y timezone

Envía null en cookie_provider_group_id para dejar una cookie como first-party. Usa null en descripciones, duración, destinatarios o URLs cuando quieras borrar el valor actual.

Ejemplos

Confirma una sugerencia del scanner sin cambiar su categoría:

{
  "tool": "soyio_update_cookie_inventory_item",
  "arguments": {
    "cookie_inventory_item_id": "cinv_123",
    "classification_status": "confirmed",
    "response_format": "json"
  }
}

Publica una configuración draft:

{
  "tool": "soyio_publish_cookie_banner_config",
  "arguments": {
    "cookie_banner_config_id": "cbcfg_123",
    "response_format": "json"
  }
}

Revisa decisiones de un sitio durante los últimos 30 días:

{
  "tool": "soyio_get_cookie_consent_action_stats",
  "arguments": {
    "where": {
      "cookie_site_id": { "=": "csite_123" }
    },
    "period_days": 30,
    "timezone": "America/Santiago",
    "response_format": "json"
  }
}

Ejemplos de prompts:

• “Escanea este sitio y lista las cookies que todavía no tienen clasificación”.
• “Agrupa estas cookies bajo Google, confirma las sugerencias y muéstrame el resultado antes de publicar”.
• “Resume las decisiones del último mes por categoría y, cuando la materialización esté completa, enlaza las acciones con su Agreement y Evidence”.

Workflows

Usa esta superficie para crear, actualizar, publicar y auditar automatizaciones.

Los workflows tienen contratos más extensos que otros módulos. Para sesiones de autoría, usa el prompt soyio_author_workflow o consulta el recurso soyio://mcp/workflow-authoring-guide desde tu cliente MCP.

Herramienta	Qué hace
soyio_list_workflows	Lista workflows
soyio_get_workflow	Obtiene un workflow por token
soyio_get_workflow_stats	Obtiene estadísticas de ejecución
soyio_create_workflow	Crea un workflow usando el contrato de grafo
soyio_update_workflow	Actualiza el grafo de un workflow
soyio_delete_workflow	Elimina un workflow
soyio_publish_workflow	Publica un workflow
soyio_list_workflow_versions	Lista versiones guardadas de un workflow
soyio_get_workflow_version	Obtiene una versión específica
soyio_restore_workflow_version	Restaura una versión guardada
soyio_list_workflow_runs	Lista ejecuciones de un workflow
soyio_get_workflow_run	Obtiene una ejecución por token
soyio_force_run_workflow	Fuerza una ejecución de workflow
soyio_list_events	Lista eventos de Soyio
soyio_get_event	Obtiene un evento por token
soyio_list_workflow_event_contracts	Lista contratos de eventos para triggers
soyio_get_workflows_config	Obtiene configuración global de workflows
soyio_update_workflows_config	Actualiza variables y secretos de workflows

Ejemplos de prompts:

• “Crea un workflow que asigne DSRs nuevas a un usuario específico”.
• “Publica este workflow después de validar su grafo”.
• “Revisa ejecuciones fallidas de este workflow y resume posibles causas”.
• “Lista contratos de eventos disponibles para crear un trigger”.

Recursos MCP

Los recursos entregan contexto consultable al cliente MCP sin ejecutar cambios en Soyio.

Recurso	Qué contiene
soyio://mcp/api-coverage	Cobertura MCP frente al OpenAPI expuesto de Soyio
soyio://mcp/tool-catalog	Catálogo de herramientas disponibles
soyio://mcp/consent-authoring-guide	Guía para crear plantillas de consentimiento
soyio://mcp/workflow-authoring-guide	Guía para crear workflows

Los recursos MCP no ejecutan cambios. Úsalos para darle contexto al agente antes de pedirle que cree plantillas o workflows.

Prompts MCP

Los prompts ayudan a iniciar tareas frecuentes con estructura conocida.

Prompt	Cuándo usarlo
soyio_author_consent_template	Para diseñar o revisar una plantilla de consentimiento
soyio_author_workflow	Para diseñar o revisar un workflow

Límites y permisos

Los permisos y el entorno vienen de la conexión aprobada en Soyio. El parámetro toolsets solo reduce qué herramientas ve el cliente; no concede permisos nuevos. Si necesitas revisar cómo se autoriza una conexión, consulta cómo funciona la autorización o abre Configuración > MCP en el dashboard.

Las listas usan paginación con limit, cursor y order_by cuando el endpoint lo soporta. Los límites de la API de Soyio aplican también a llamadas realizadas desde MCP.

Siguiente paso

Conecta tu cliente siguiendo la guía de configuración MCP.