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

## Herramientas por familia

El servidor expone **36 herramientas** organizadas por familia:

| Familia                 | Herramientas                                                                                                     |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Wokus                   | `list_wokus`, `get_woku`, `list_woku_reviews`                                                                    |
| NPS                     | `list_nps_tools`, `get_nps_statistics`                                                                           |
| CSAT y CES              | `get_csat_metrics`, `get_ces_metrics`                                                                            |
| Formularios             | `list_forms`, `get_form_summary`, `list_form_responses`                                                          |
| Clientes                | `list_clients`, `get_client_stats`                                                                               |
| Empresa                 | `get_company`, `get_company_statistics`, `simulate_quarantine`                                                   |
| Alertas                 | `list_alerts`, `list_alert_dispatches`, `test_alert_rule`                                                        |
| Metas                   | `create_goal`, `get_goals_compliance`                                                                            |
| Planes de acción        | `list_action_plans`, `get_action_plan`, `approve_action_plan`, `reply_to_action_plan`, `update_action_plan_task` |
| Tickets                 | `list_tickets`, `get_ticket`, `update_ticket`                                                                    |
| Trackers                | `list_trackers`, `create_tracker`, `assign_tracker_to_woku`                                                      |
| Reportes                | `list_report_definitions`, `run_report`                                                                          |
| Inteligencia de reseñas | `query_review_intelligence`                                                                                      |
| Búsqueda universal      | `search`, `fetch`                                                                                                |

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

## 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 o modifican. Las herramientas de escritura son nueve:

`create_goal`, `create_tracker`, `assign_tracker_to_woku`, `update_ticket`, `reply_to_action_plan`, `update_action_plan_task`, `approve_action_plan`, `test_alert_rule` y `simulate_quarantine`.

El resto son de lectura. 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.