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

# Phone Number Tools

> Inspect organization phone numbers used for SMS and voice channels

The Bizzy MCP server provides 2 tools for inspecting the phone numbers connected
to your organization. Use these tools to discover which numbers are available or
to look up a specific number by ID.

<Note>
  Phone numbers are not yet generally available. These two tools are only
  advertised over `tools/list` when phone is enabled for your organization —
  if you don't see them, they aren't part of your server's tool set, and
  calling them by name will fail. Contact support to have phone enabled. The
  contact phone-number tools on the [Contact
  Tools](/mcp-server/tools/contacts) page are unaffected and always available.
</Note>

## getPhoneNumber

Get details of a specific phone number by ID.

**Permission:** `phone-numbers:read`

**Parameters:**

| Name            | Type          | Required | Description                            |
| --------------- | ------------- | -------- | -------------------------------------- |
| `phoneNumberId` | string (UUID) | Yes      | The ID of the phone number to retrieve |

**Returns:** The phone number object, or `null` if not found.

***

## listPhoneNumbers

List phone numbers for the organization with optional filtering.

**Permission:** `phone-numbers:read`

**Parameters:**

| Name       | Type   | Required | Default | Description                                                                                        |
| ---------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------- |
| `limit`    | number | No       | 100     | Maximum number of results                                                                          |
| `offset`   | number | No       | 0       | Offset for pagination                                                                              |
| `provider` | string | No       | -       | Filter by phone provider. Valid values: `telnyx`, `twilio`                                         |
| `status`   | string | No       | -       | Filter by phone number status. Valid values: `pending`, `active`, `disabled`, `errored`, `deleted` |

**Returns:**

```json theme={null}
{
  "phoneNumbers": [...],
  "count": 4,
  "limit": 100,
  "offset": 0
}
```

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Email Address Tools" icon="at" href="/mcp-server/tools/email-addresses">
    Inspect email addresses available for sending
  </Card>

  <Card title="Authentication" icon="key" href="/mcp-server/authentication">
    Learn how MCP clients authenticate to the server
  </Card>
</CardGroup>