> ## Documentation Index
> Fetch the complete documentation index at: https://woku.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Herramientas

> Las herramientas que el servidor MCP de woku expone a un agente: wokus, NPS, CSAT, CES, formularios, planes de acción, reportes, facturación, integraciones y más

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.