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

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 o consents para plantillas de consentimiento.

Declarar toolsets en la URL

Puedes limitar 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?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=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”.

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.