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

# Tools

> The tools woku's MCP server exposes to an agent: wokus, NPS, CSAT, CES, forms, action plans, reports, billing, integrations, and more

Once connected, the agent operates on your company data through a catalog of tools. Every tool runs the exact same query or command the admin panel runs, so the two surfaces cannot diverge in behaviour.

Before operating, the agent can call `woku_guide`, which returns woku's method and playbooks (from an intent to the sequence of tools), and `design_voc_program`, which proposes a listening program for your customer journey.

## Tools by family

The server exposes **143 tools** organized by family:

| Family              | Tools                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Guide               | `woku_guide`, `design_voc_program`                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Company             | `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 and 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`                                                                                                                                                                                                                      |
| Forms               | `list_forms`, `get_form`, `get_form_summary`, `list_form_responses`, `send_form_invitations`, `create_form`, `update_form`, `delete_form`                                                                                                                                                                                                                                                                                                                           |
| Survey flows        | `list_flows`, `get_flow`, `create_flow`, `update_flow`, `delete_flow`                                                                                                                                                                                                                                                                                                                                                                                               |
| Folders             | `list_folders`, `get_folder`, `create_folder`, `move_folder`                                                                                                                                                                                                                                                                                                                                                                                                        |
| Clients             | `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`                                                                                                                                                                                                                                               |
| Action plans        | `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` |
| Goals               | `get_goals_compliance`, `create_goal`, `update_goal`, `delete_goal`                                                                                                                                                                                                                                                                                                                                                                                                 |
| Alerts and rules    | `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`                                                                                                                      |
| Reports             | `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`                                                                                                                          |
| Review intelligence | `query_review_intelligence`                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Billing             | `get_subscription`, `list_billing_plans`, `list_invoices`, `get_billing_profile`, `get_usage_balance`                                                                                                                                                                                                                                                                                                                                                               |
| Integrations        | `list_integration_connections`                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Audit               | `list_audit_log_entries`                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Data apps           | `list_data_apps`, `get_data_app`                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Data flows          | `list_data_flows`, `get_data_flow`, `list_data_flow_runs`, `list_data_flow_versions`                                                                                                                                                                                                                                                                                                                                                                                |
| Universal search    | `search`, `fetch`                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

With this, an agent can design a listening program, summarize last week's reviews, compare NPS across locations, run a report, review goal compliance, approve an action plan, or create a tracker, all from the conversation.

## Toolsets

The catalog is large, so a connection can narrow it. Adding `?toolsets=nps,clients` (comma-separated) to the MCP endpoint URL exposes only those families; without the parameter, or with `?toolsets=all`, everything is exposed. The `guide`, `company`, and `search` families are always available.

## Universal search

The `search` and `fetch` tools follow ChatGPT's deep research contract: `search` searches across all company data and `fetch` brings the detail of a result.

## Read and write

Connections handle two permissions: `mcp:read` to query data and `mcp:write` for the tools that create, edit, or delete. Read tools work with `mcp:read` alone; write tools also require `mcp:write`, and destructive ones (for example `delete_woku`) or sends (for example `send_nps_invitations`, `send_report_now`) additionally require `confirm: true` in the call, so nothing is deleted or sent without an explicit confirmation.

If the connection does not have the `mcp:write` permission, the write tools respond with an error indicating so and the rest keep working normally.

The list of tools the server advertises on a live connection (`tools/list`) is always the authoritative answer about what is available.
