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

# Tools overview

> Every tool the VoiceAIWrapper MCP server offers.

You don't call these tools yourself. You ask in plain words and the AI app picks the tool. This reference is for knowing what is possible and what each tool returns.

## All tools

| Tool | What it does | Scope | Changes data |
| - | - | - | - |
| [`create_inbound_receptionist`](/documentation/mcp/tools/agents#create_inbound_receptionist) | Build an agent that answers phone calls | `agents.write` | Yes |
| [`create_outbound_agent`](/documentation/mcp/tools/agents#create_outbound_agent) | Build an agent that makes phone calls | `agents.write` | Yes |
| [`create_website_chatbot`](/documentation/mcp/tools/agents#create_website_chatbot) | Build a website agent plus its web widget | `agents.write` | Yes |
| [`get_agent_build_status`](/documentation/mcp/tools/agent-builds#get_agent_build_status) | Check a build: building, ready or failed | `agents.read` | No |
| [`retry_agent_build`](/documentation/mcp/tools/agent-builds#retry_agent_build) | Carry on a failed build | `agents.write` | Yes |
| [`list_agents`](/documentation/mcp/tools/agents#list_agents) | List the organization's agents | `agents.read` | No |
| [`get_agent`](/documentation/mcp/tools/agents#get_agent) | Show one agent | `agents.read` | No |
| [`update_agent`](/documentation/mcp/tools/agents#update_agent) | Change name, greeting, instructions or language | `agents.write` | Yes, asks first |
| [`create_web_widget`](/documentation/mcp/tools/web-widgets#create_web_widget) | Add a voice and chat widget to an agent | `agents.write` | Yes |
| [`get_widget_embed_code`](/documentation/mcp/tools/web-widgets#get_widget_embed_code) | Get a widget's embed code again | `agents.read` | No |
| [`connect_phone_number`](/documentation/mcp/tools/phone-numbers#connect_phone_number) | Connect a free phone number to an agent | `agents.write` | Yes, asks first |
| [`get_setup_status`](/documentation/mcp/tools/setup-and-calls#get_setup_status) | What's left before calls work | `agents.read` | No |
| [`list_recent_calls`](/documentation/mcp/tools/setup-and-calls#list_recent_calls) | The latest 20 calls | `agents.read` | No |
| [`whoami`](/documentation/mcp/tools/account#whoami) | The connected account and organization | `agents.read` | No |

## Tool hints

Each tool tells the AI app how careful to be:

* **Read-only** tools only look. AI apps usually run them without asking.
* **Destructive** tools (`update_agent`, `connect_phone_number`) overwrite live settings with no undo. AI apps ask you to confirm first.
* **Open world** tools (the three create tools and `retry_agent_build`) reach outside VoiceAIWrapper: the build reads your business's website.

## What a tool returns

Every reply has:

* **Text** written for you, which the AI app usually shows or summarizes.
* **Structured data** (`structuredContent`) that follows the tool's published output schema. The same data is also sent as a JSON text block, for AI apps that only read text.

A refusal comes back as a tool error with a sentence saying what happened and what to do next. See [Errors](/documentation/mcp/errors.md).

## Ids

Tools hand out and take opaque ids:

* `agent_id`: an agent, from `list_agents` or a finished build. It is the same id the VoiceAIWrapper app uses, so a link from the chat opens the right agent.
* `build_id`: one agent build, from a create tool.

Ids only work in the connected organization.

## Repeating a request safely

The create tools and `create_web_widget` take an optional `request_id`. Send the same `request_id` when you retry the same request and nothing is built twice:

* Same `request_id`, same details: you get the first result back.
* Same `request_id`, different details: refused. Use a new `request_id` for a new request.
* No `request_id`, same details within 10 minutes: treated as the same request.

Request ids are kept for 24 hours.


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