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

# MCP tools

> All 18 Topcalls MCP tools: the 10 that only read, the 8 that change things, and which ones ask you to confirm first.

## What can the 18 Topcalls MCP tools do?

Topcalls has 10 tools that only read and 8 that change things. Your AI app picks the tool from what you ask. The names below are the ones it sees.

Every tool checks your role in the account each time it runs. A tool that your role doesn't allow is refused, in the app as in Topcalls.

## Which tools only read?

These 10 tools work on read-only and full-access connections, within what your role allows.

| Tool | What it does |
| - | - |
| `whoami` | Shows which Topcalls account the connection uses, whether it's read only, and which app it was approved for. |
| `get_balance` | Shows the credit balance and whether it's frozen. With the billing permission it also shows billing settings such as auto-recharge. |
| `list_calls` | Lists calls, newest first, with status, direction, campaign, lead, start and end, billed seconds, cost and summary. Filters by campaign, status or dates. |
| `get_call` | Shows one call with its summary, status, timing, cost and transcript. The recording isn't included. |
| `list_campaigns` | Lists campaigns with their name, status and direction, and the numbers that answer for inbound ones. |
| `get_campaign` | Shows one campaign: status, direction, attempts per lead, its lead lists and the numbers that answer for it. |
| `list_leads` | Lists leads with name, status, phone, email, tags, notes and the lead lists each one is in. |
| `get_lead_status_counts` | Counts leads by status: New, Contacted, Converted and Unsubscribed. |
| `list_phone_numbers` | Lists phone numbers with label, status, capabilities and the campaign that answers inbound calls on each. |
| `list_integration_flows` | Lists the Integrations flows that can run as tools. |

## Which tools change things?

These 8 tools need a full-access connection.

| Tool | What it does |
| - | - |
| `save_campaign_draft` | Creates a campaign draft, or changes a draft or paused campaign. A draft calls no one until it's launched. It can also edit a running inbound campaign. |
| `launch_campaign` | Starts a draft campaign now or at a set time. Refused when the Launch checklist is incomplete, the safety review fails or the credit is too low. Places real calls that use credit. |
| `pause_campaign` | Pauses a running campaign. No new calls start until it's resumed. |
| `resume_campaign` | Resumes a paused campaign after the safety review runs again. Real calls start again and use credit. |
| `cancel_campaign` | Stops a campaign for good and cancels the calls it has not placed yet. |
| `start_test_call` | Places one real test call with a campaign's agent, to a lead of the account or the company's verified contact phone. No other number can be called. Uses credit. |
| `import_leads` | Adds leads to a lead list. A number already in the list is skipped. If any row is invalid, nothing is imported. |
| `run_integration_flow` | Runs one of the account's Integrations flows. A flow can change data in the apps it connects to. |

## Which tools ask me to confirm first?

Topcalls marks five tools as not undoable: `save_campaign_draft`, `launch_campaign`, `cancel_campaign`, `start_test_call` and `run_integration_flow`. AI apps like Claude and ChatGPT can use that mark to ask you before they run one. Whether the app asks is up to the app.

## Which tools does ChatGPT get?

Every tool except the two Integrations tools, `list_integration_flows` and `run_integration_flow`. Other apps get all 18.

## What does a tool return?

* Text from your account, such as transcripts and lead notes, comes back marked as data, not as instructions.
* One result stays under 72 KB, and a list page carries at most 50 rows. If a result is too large, ask for fewer items or a narrower range.
* Recordings are never returned. Call tools return summaries and transcripts, and say whether a recording exists.

Read-only connections only see the 10 reading tools. See [Security and limits](https://docs.topcalls.ai/mcp/security.md) for the rest.


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