Documentación de woku - Guía para desarrolladores

Una vez conectado, el agente opera sobre los datos de tu empresa a través de un catálogo de herramientas. Cada herramienta ejecuta exactamente la misma consulta o comando que corre el panel administrativo, así que las dos superficies no pueden divergir en comportamiento. Antes de operar, el agente puede llamar a woku_guide, que entrega el método de woku y playbooks (de una intención a la secuencia de herramientas), y a design_voc_program, que propone un programa de escucha para tu viaje de cliente.

Herramientas por familia

El servidor expone 143 herramientas organizadas por familia:

Familia	Herramientas
Guía	`woku_guide`, `design_voc_program`
Empresa	`get_company`, `get_company_statistics`, `list_company_members`
Wokus	`list_wokus`, `get_woku`, `list_woku_reviews`, `update_woku`, `move_woku`, `update_woku_settings`, `delete_woku`, `send_woku_invitations`
NPS	`list_nps_tools`, `get_nps_statistics`, `list_nps_responses`, `send_nps_invitations`, `create_nps_tool`, `update_nps_tool`, `delete_nps_tool`
CSAT y CES	`get_csat_metrics`, `get_ces_metrics`, `list_csat_responses`, `list_ces_responses`, `send_csat_survey`, `send_ces_survey`, `create_csat_tool`, `update_csat_tool`, `delete_csat_tool`, `create_ces_tool`, `update_ces_tool`, `delete_ces_tool`
Formularios	`list_forms`, `get_form`, `get_form_summary`, `list_form_responses`, `send_form_invitations`, `create_form`, `update_form`, `delete_form`
Flujos de encuesta	`list_flows`, `get_flow`, `create_flow`, `update_flow`, `delete_flow`
Carpetas	`list_folders`, `get_folder`, `create_folder`, `move_folder`
Clientes	`list_clients`, `get_client_stats`, `list_client_feedback`, `get_client_form_config`, `create_client`, `update_client`, `import_clients`, `delete_client`
Trackers	`list_trackers`, `create_tracker`, `assign_tracker_to_woku`, `assign_tracker_to_entity`, `update_tracker`, `set_tracker_active`, `remove_tracker_value`, `list_entity_trackers`, `search_entities_by_trackers`
Tickets	`list_tickets`, `get_ticket`, `update_ticket`, `list_ticket_destinations`, `get_ticket_destination`, `create_ticket_destination`, `update_ticket_destination`, `delete_ticket_destination`, `test_ticket_destination`
Planes de acción	`list_action_plans`, `get_action_plan`, `approve_action_plan`, `change_action_plan_status`, `create_action_plan_task`, `update_action_plan_task`, `delete_action_plan_task`, `reorder_action_plan_tasks`, `get_action_plan_events`, `get_action_plan_conversation`, `reply_to_action_plan`, `list_action_plan_groups`, `get_action_plan_group`, `create_action_plan_group`, `update_action_plan_group`, `set_action_plan_group_enabled`, `delete_action_plan_group`
Metas	`get_goals_compliance`, `create_goal`, `update_goal`, `delete_goal`
Alertas y reglas	`list_alerts`, `list_alert_dispatches`, `list_alert_targets`, `create_alert`, `update_alert`, `delete_alert`, `evaluate_alert`, `list_alert_rules`, `create_alert_rule`, `update_alert_rule`, `delete_alert_rule`, `test_alert_rule`, `list_quarantines`, `create_quarantine`, `update_quarantine`, `delete_quarantine`, `simulate_quarantine`
Reportes	`list_report_definitions`, `get_report_definition`, `create_report_definition`, `update_report_definition`, `delete_report_definition`, `schedule_report_delivery`, `seed_report_templates`, `run_report`, `preview_report`, `send_report_now`, `list_generated_reports`, `get_woku_report`, `get_folder_report`, `get_company_nps_report`
Inteligencia de reseñas	`query_review_intelligence`
Facturación	`get_subscription`, `list_billing_plans`, `list_invoices`, `get_billing_profile`, `get_usage_balance`
Integraciones	`list_integration_connections`
Auditoría	`list_audit_log_entries`
Data Apps	`list_data_apps`, `get_data_app`
Flujos de datos	`list_data_flows`, `get_data_flow`, `list_data_flow_runs`, `list_data_flow_versions`
Búsqueda universal	`search`, `fetch`

Con esto, un agente puede diseñar un programa de escucha, resumir las reseñas de la última semana, comparar el NPS entre sucursales, correr un reporte, revisar el cumplimiento de metas, aprobar un plan de acción o crear un tracker, todo desde la conversación.

Toolsets

El catálogo es amplio, así que una conexión puede acotarlo. Agregando ?toolsets=nps,clients (separados por coma) a la URL del endpoint MCP se exponen solo esas familias; sin el parámetro, o con ?toolsets=all, se expone todo. Las familias guide, company y search están siempre disponibles.

Búsqueda universal

Las herramientas search y fetch siguen el contrato de investigación profunda de ChatGPT: search busca en todos los datos de la empresa y fetch trae el detalle de un resultado.

Lectura y escritura

Las conexiones manejan dos permisos: mcp:read para consultar datos y mcp:write para las herramientas que crean, editan o borran. Las herramientas de lectura funcionan solo con mcp:read; las de escritura requieren además mcp:write, y las destructivas (por ejemplo delete_woku) o de envío (por ejemplo send_nps_invitations, send_report_now) exigen también confirm: true en la llamada, para que nada se borre ni se envíe sin una confirmación explícita. Si la conexión no tiene el permiso mcp:write, las herramientas de escritura responden con un error que lo indica y el resto sigue funcionando con normalidad. La lista de herramientas que anuncia el servidor en una conexión viva (tools/list) es siempre la respuesta autoritativa sobre lo que está disponible.

​Herramientas por familia

​Toolsets

​Búsqueda universal

​Lectura y escritura

Herramientas por familia

Toolsets

Búsqueda universal

Lectura y escritura