Documentación de woku - Guía para desarrolladores

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.

​Tools by family

​Toolsets

​Universal search

​Read and write

Tools by family

Toolsets

Universal search

Read and write