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

# Phone Numbers MCP Tools

> Use DialNexa phone numbers MCP tools through the remote MCP server.

DialNexa phone numbers MCP tools let an MCP-compatible AI client search, purchase, inspect, and configure phone numbers. Each tool page includes its exact server description, input schema, safety level, request shape, and retry guidance.

## Available Phone Numbers MCP Tools

| Tool                                                                                          | Safety                              | What it does                                                                                                          |
| --------------------------------------------------------------------------------------------- | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| [`list_organization_phone_numbers`](/docs/mcp-tools/phone-numbers/list-organization-phone-numbers) | Read only                           | Returns phone numbers owned by the organization, including which agent (if any) is assigned inbound/outbound on each. |
| [`get_organization_phone_number`](/docs/mcp-tools/phone-numbers/get-organization-phone-number)     | Read only                           | Returns details for one of the organization's phone numbers by ID (e.g. phn\_abc123).                                 |
| [`search_plivo_numbers`](/docs/mcp-tools/phone-numbers/search-plivo-numbers)                       | Read only                           | Searches Plivo for phone numbers available to purchase in a given country.                                            |
| [`purchase_phone_number`](/docs/mcp-tools/phone-numbers/purchase-phone-number)                     | Billable - retry unsafe             | Purchases a phone number from Plivo and registers it to the organization.                                             |
| [`create_sip_trunk`](/docs/mcp-tools/phone-numbers/create-sip-trunk)                               | Changes state - verify before retry | Links an organization-owned SIP trunk phone number for outbound/inbound calling.                                      |
| [`delete_phone_number`](/docs/mcp-tools/phone-numbers/delete-phone-number)                         | Destructive                         | Releases/deletes one of the organization's phone numbers.                                                             |
| [`list_phone_number_pricing`](/docs/mcp-tools/phone-numbers/list-phone-number-pricing)             | Read only                           | Returns phone number rental pricing by telephony provider and country.                                                |
| [`list_countries`](/docs/mcp-tools/phone-numbers/list-countries)                                   | Read only                           | Returns the global list of countries phone numbers/calls can be configured for, with their country codes.             |
| [`list_org_phone_country_rules`](/docs/mcp-tools/phone-numbers/list-org-phone-country-rules)       | Read only                           | Returns the organization's configured rules per country (e.g. allowed prefixes, dialing mode) for outbound calling.   |
| [`list_enabled_network_groups`](/docs/mcp-tools/phone-numbers/list-enabled-network-groups)         | Read only                           | Returns the telephony network groups currently enabled for the organization's outbound calling.                       |

## Before you call a tool

Connect with OAuth or a workspace API key and complete MCP initialization first. Use IDs exactly as another DialNexa tool returned them, including prefixes such as `agent_`, `call_`, and `workflow_`.

For operations that change data, verify the target and current state before the call. Billable and destructive tools require extra care because retrying an uncertain result can spend money or repeat an irreversible action.

## Related guides

* [MCP quickstart](/docs/mcp-tools/quickstart)
* [MCP responses and errors](/docs/mcp-tools/errors)
* [MCP connection and authentication](/docs/mcp-tools/overview)