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

# Tools

> The 16 tools the Plivo MCP server gives an AI app: 4 universal tools that reach every operation, 11 shortcuts for common tasks and docs search.

The Plivo MCP server gives an AI app 16 tools: 4 universal tools that reach all [135 operations](https://plivo.com/docs/mcp/operations.md), 11 shortcuts for common tasks, and `search_docs` for Plivo's docs. Your AI app picks the tool. You don't need to name one.

## Universal tools

The usual path is `plivo_api_search` → `plivo_api_details` → `plivo_api_read` or `plivo_api_write`.

| Tool | What it does | Asks first |
| - | - | - |
| `plivo_api_search` | Finds operations by what you want to do, such as "send an SMS" or "buy a number". | — |
| `plivo_api_details` | Shows one operation's parameters and whether it needs your approval. | — |
| `plivo_api_read` | Calls any of the 60 read operations: messages, calls, numbers, recordings, AI agents and more. | — |
| `plivo_api_write` | Calls any of the 75 write operations. | 64 operations |

## Shortcuts

| Tool | What it does | Calls | Asks first |
| - | - | - | - |
| `get_account` | Gets your account details. | `GET /` | — |
| `list_numbers` | Lists the phone numbers on your account. | `GET /Number/` | — |
| `search_numbers` | Searches numbers available to buy in a country. | `GET /PhoneNumber/` | — |
| `buy_number` | Buys a number found with `search_numbers`. | `POST /PhoneNumber/{number}/` | Costs money |
| `list_messages` | Lists sent and received messages. | `GET /Message/` | — |
| `get_message` | Gets one message by its UUID. | `GET /Message/{message_uuid}/` | — |
| `send_sms` | Sends an SMS or MMS. | `POST /Message/` | Costs money |
| `list_calls` | Lists completed calls. Without an end time filter, Plivo searches the last 7 days. | `GET /Call/` | — |
| `get_call` | Gets the record of one completed call. | `GET /Call/{call_uuid}/` | — |
| `make_call` | Starts an outbound call. The `answer_url` must return [Plivo XML](https://plivo.com/docs/voice/xml/overview.md). | `POST /Call/` | Costs money |
| `hangup_call` | Hangs up a live call or cancels a queued one. | `DELETE /Call/{call_uuid}/` | Can't be undone |

Paths are under `/v1/Account/{auth_id}`.

## Docs search

| Tool | What it does | Asks first |
| - | - | - |
| `search_docs` | Searches Plivo's guides and API reference: concepts, how-tos, Plivo XML and error codes. | — |
