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

# Tools Reference

> Every tool the Voxworks MCP connector offers a connected assistant, grouped by area, with the permission each one needs.

## About this list

You don't call these tools yourself. The assistant chooses them based on what you ask. This list helps you see what an assistant can do and which [permission](/mcp/permissions) each tool needs. Tools that make changes preview them first, and only save once the preview is confirmed.

Permissions are shortened here: **Scripts read**, **Scripts write** (create new script revisions), **Publish**, **Recs** (review and approve AI recommendations), **Calls**, **Transcripts** and **Operations**.

***

## Scripts

| Tool | What it does | Needs |
| - | - | - |
| `list_scripts` | Lists the team's scripts, most recently updated first. | Scripts read |
| `search_scripts` | Finds scripts by name. | Scripts read |
| `get_script` | Reads a script with its main and pre-call flows. | Scripts read |
| `export_script` | Reads a script with every flow and tool it uses. | Scripts read |
| `get_flow` | Reads one flow. | Scripts read |
| `review_script` | Checks a script against the engine's rules and its recent calls. | Scripts read (Calls to include recent calls) |
| `compile_script` | Checks a changed script without saving it. | Scripts read |
| `diff_script` | Shows what a change would alter. | Scripts read |
| `upsert_script` | Saves a script change as a new version. | Scripts write (Publish to make it live) |
| `update_script_settings` | Changes a script's name, voice, voicemail or guidelines as a draft. | Scripts write |
| `list_voices` | Lists the voices a script can use. | Scripts read |
| `duplicate_script` | Makes a full copy of a script. | Scripts write |
| `list_script_revisions` | Shows a script's version history. | Scripts read |
| `get_script_revision` | Reads one past version. | Scripts read |
| `rollback_script` | Puts back an earlier version of a script or flow. | Scripts write |
| `start_script_generation` | Writes a new script with AI, optionally from your own script document. | Scripts write |
| `get_script_generation` | Follows a script being written. | Scripts read |

## Recommendations

| Tool | What it does | Needs |
| - | - | - |
| `recommend_script_improvements` | Lists the open recommendations that still apply to a script. | Scripts read |
| `list_recommendations` | Lists a script's recommendations. | Scripts read |
| `get_recommendation` | Reads one recommendation. | Scripts read |
| `approve_recommendation` | Applies one recommendation. | Scripts write + Recs |
| `approve_recommendations` | Applies several recommendations. | Scripts write + Recs |
| `undo_recommendations` | Reverts applied recommendations and reopens them. | Scripts write + Recs |
| `reject_recommendation` | Rejects a recommendation. | Recs |
| `update_recommendation_status` | Dismisses a recommendation. | Recs |
| `create_recommendations` | Files new suggested changes on a script. | Recs |
| `request_recommendation_generation` | Asks for a fresh review of one script. | Scripts write |
| `request_team_recommendation_generation` | Asks for a fresh review of every script that has reviews turned on. | Recs |

## Surveys

All survey tools also need the Surveys module and the survey permissions in your role.

| Tool | What it does | Needs |
| - | - | - |
| `list_surveys` | Lists the team's surveys. | Scripts read |
| `get_survey` | Reads a survey with its compile result and any problems. | Scripts read |
| `check_survey` | Checks a survey draft without saving it. | Scripts read |
| `create_survey` | Creates a checked survey as an editable draft and starts its test compile. | Scripts write |
| `start_survey_generation` | Converts a questionnaire into a survey in the background. | Scripts write |
| `get_survey_generation` | Follows a survey being converted. | Scripts read |

## Calls and operations

| Tool | What it does | Needs |
| - | - | - |
| `list_calls` | Lists recent calls, filtered by script, batch, status or dates. | Calls |
| `get_call` | Reads one call in full. | Calls (Transcripts to include what was said and the steps it went through) |
| `get_call_transcripts` | Reads the transcripts of up to five calls. | Calls + Transcripts |
| `list_batches` | Lists outbound batches. | Operations |
| `get_batch` | Reads one batch in full. | Operations |
| `list_automations` | Lists automations. | Operations |
| `get_automation_executions` | Reads recent automation runs. | Operations |
| `list_phone_numbers` | Lists phone numbers and what answers them. | Operations |
| `get_account_overview` | Shows plan, balance or credits and usage. | Operations |
| `get_calendar_setup_options` | Lists the calendar booking tools the team can use. | Operations |

## Help

| Tool | What it does | Needs |
| - | - | - |
| `search_docs` | Searches this documentation. | — |
| `read_doc` | Reads one documentation page. | — |
| `search_playbook` | Searches the Voxworks playbook. | — |
| `get_playbook_doc` | Reads one playbook page. | — |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.