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

# Dialer

# Dialer Tools

Manage phone numbers, calls, recordings, and webhooks through the MCP server.

<Info>
  **Setup note:** Trunk setup and KYC are completed in the **60db Dashboard** (Dialer section), not through the API or MCP. SIP credentials and PBX configuration remain in the dashboard; no credentials are exposed via MCP for security.
</Info>

## Available Tools

| Tool                                      | Purpose                                                           |
| ----------------------------------------- | ----------------------------------------------------------------- |
| `sixtydb_dialer_get_status`               | Check provisioning status                                         |
| `sixtydb_dialer_search_numbers`           | Browse available numbers                                          |
| `sixtydb_dialer_list_numbers`             | List rented numbers                                               |
| `sixtydb_dialer_buy_number`               | Allocate from pool (requires `confirm: true`, charges real money) |
| `sixtydb_dialer_release_number`           | Cancel rental (requires `confirm: true`)                          |
| `sixtydb_dialer_set_caller_id`            | Set default outbound ID                                           |
| `sixtydb_dialer_list_calls`               | Call history (CDR logs)                                           |
| `sixtydb_dialer_get_call`                 | Call details                                                      |
| `sixtydb_dialer_list_recordings`          | Recording list                                                    |
| `sixtydb_dialer_get_recording_url`        | Playback link (\~5 min validity)                                  |
| `sixtydb_dialer_get_recording_transcript` | Recording transcript                                              |
| `sixtydb_dialer_get_usage`                | Billing and wallet balance                                        |

**Note:** `confirm: true` is mandatory for operations that charge money or release resources. Without it, the tool explains the cost/consequence and does nothing.

## Rent Numbers (Requires Confirmation)

Reserve a phone number from the shared pool. Costs ₹600/month (\$6.00) immediately and renews monthly:

```json theme={null}
{
  "tool": "sixtydb_dialer_buy_number",
  "arguments": {
    "number": "+919876543210",
    "confirm": true
  }
}
```

Omit `number` to allocate the next available number from the pool.

## List Call History

Retrieve call logs (CDR):

```json theme={null}
{
  "tool": "sixtydb_dialer_list_calls",
  "arguments": {
    "limit": 50
  }
}
```

## List Recordings

Browse recorded calls:

```json theme={null}
{
  "tool": "sixtydb_dialer_list_recordings",
  "arguments": {
    "limit": 25,
    "direction": "outbound"
  }
}
```

## Get Transcript

Fetch speech-to-text for a recording:

```json theme={null}
{
  "tool": "sixtydb_dialer_get_recording_transcript",
  "arguments": {
    "id": "recording-uuid"
  }
}
```

Cached after first call; no additional charge for subsequent fetches.

## Check Usage & Billing

View charges and wallet balance:

```json theme={null}
{
  "tool": "sixtydb_dialer_get_usage",
  "arguments": {
    "limit": 50
  }
}
```

## Important Notes

* **Confirm flag:** Buying and releasing numbers requires explicit `confirm: true`. Without it, the tool refuses and explains the cost.
* **No credentials exposed:** SIP credentials and trunk setup details remain in the dashboard. MCP cannot access or modify them.
* **Pricing:** ₹600/month per number (billed immediately on purchase + monthly renewal); calls ₹0.30/min inbound/outbound (prorated per second).
* **Grace period:** 48 hours after renewal date; unpaid numbers are auto-released.