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

# Tool List

> Every tool the Bolna MCP server exposes, grouped by agents, calls, phone numbers, batches, and account.

11 tools, backed one-to-one by the [Bolna REST API](/docs/api-reference/introduction).

| Type      | Meaning                                                                                                                                                                                                         |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Read`    | Looks something up. No side effects.                                                                                                                                                                            |
| `Write`   | Creates or changes something. Reversible or low-risk (e.g. `create_agent` just adds a new agent).                                                                                                               |
| `Write ⚠` | Flagged **destructive** in the tool's own definition (`destructiveHint: true`) — irreversible, or has a real-world effect like spending balance. Most clients pause for your confirmation before running these. |

The three `⚠` tools are `update_agent`, `delete_agent`, and `start_outbound_call` — see each one's row below for what makes it destructive.

## Agents

| Tool           | Type    | Description                                                        | API                                                  |
| -------------- | ------- | ------------------------------------------------------------------ | ---------------------------------------------------- |
| `list_agents`  | Read    | List agents in the account — ID, name, status, created date        | [List Agents](/docs/api-reference/agent/v2/get_all)       |
| `get_agent`    | Read    | Full config of one agent — prompts, LLM, voice, telephony, tools   | [Get Agent](/docs/api-reference/agent/v2/get)             |
| `create_agent` | Write   | Create a new agent, returns its ID                                 | [Create Agent](/docs/api-reference/agent/v2/create)       |
| `update_agent` | Write ⚠ | Patch an agent's name, prompts, welcome message, webhook, or voice | [Patch Update](/docs/api-reference/agent/v2/patch_update) |
| `delete_agent` | Write ⚠ | Permanently delete an agent and its history                        | [Delete Agent](/docs/api-reference/agent/v2/delete)       |

## Calls & executions

| Tool                    | Type    | Description                                                 | API                                                                |
| ----------------------- | ------- | ----------------------------------------------------------- | ------------------------------------------------------------------ |
| `start_outbound_call`   | Write ⚠ | Place a real outbound call, spends account balance          | [Make Call](/docs/api-reference/calls/make)                             |
| `list_agent_executions` | Read    | Call history for one agent, defaults to the last 7 days     | [Get Executions](/docs/api-reference/agent/v2/get_all_agent_executions) |
| `get_execution`         | Read    | Full call detail — transcript, status, cost, telephony data | [Get Execution](/docs/api-reference/executions/get_execution)           |

## Phone numbers & batches

| Tool                 | Type | Description                                         | API                                               |
| -------------------- | ---- | --------------------------------------------------- | ------------------------------------------------- |
| `list_phone_numbers` | Read | Phone numbers on the account and their linked agent | [Get All](/docs/api-reference/phone-numbers/get_all)   |
| `list_batches`       | Read | Batch campaigns for one agent — status and schedule | [Get Batches](/docs/api-reference/batches/get_batches) |

## Account

| Tool            | Type | Description                                         | API                                   |
| --------------- | ---- | --------------------------------------------------- | ------------------------------------- |
| `get_user_info` | Read | Account profile, wallet balance, concurrency limits | [User Info](/docs/api-reference/user/info) |

Not connected yet? See the [Quickstart](/docs/build-with-ai/mcp-quickstart) for setup and troubleshooting.

<Card title="Bolna MCP Server Repository" icon="github" href="https://github.com/bolna-ai/mcp">
  Full source, endpoint-verification notes, and issue tracker
</Card>
