# Available tools

DIDWW MCP currently exposes 82 purpose-built tools. The MCP client chooses the
appropriate tool from a natural-language request, so the tool names do not
normally need to be included in a conversation.

This reference lists the exact tool names, their customer-facing purpose, the
type of access they require, and whether DIDWW uses an additional confirmation
before applying the action.

## Access and confirmation

The **Access** column uses the following values:

- **Read-only** retrieves information without changing the DIDWW account.
- **Session** changes only the active account used by the current MCP session.
- **Write** creates, updates, assigns, submits, or cancels account data.
- **Write, purchase** purchases a DIDWW service from the active account's
  prepaid balance.
- **Write, destructive** terminates or deletes a resource.
- **Write, external action** sends an invitation email to another person.

The **DIDWW confirmation** column describes DIDWW's server-side confirmation.
This is separate from any tool approval displayed by the MCP client.

- **Yes** means the first request returns a preview and changes nothing. The
  action is applied only after the preview is confirmed.
- **Conditional** means confirmation is required only when the requested
  change has the effect described in the tool's purpose.
- **No** means DIDWW does not present a separate server-side preview. The
  action may be applied when the MCP client calls the tool.

Note

Tool availability is evaluated for the active DIDWW account. The account's
roles, enabled services, record ownership, and the requested arguments can
prevent a tool from completing an action. Account tools identify actions
that the active account cannot use.

## Account selection

See [Multiple accounts](connection-details.html#mcp-multiple-accounts) for account selection and
permission behavior.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `list_accounts` | **List available accounts.** Lists every DIDWW account available to the signed-in user, including the roles held on each account, unavailable tools, and whether the account is currently active. | Read-only | No |
| `current_account` | **Show the active account.** Returns the DIDWW account currently used by the MCP session, including its roles and unavailable tools. | Read-only | No |
| `switch_account` | **Switch the active account.** Changes the DIDWW account used for later requests and returns the selected account's roles and unavailable tools. | Session | No |

## Phone number coverage and DIDs

See [Phone numbers](work-with-didww-mcp/phone-numbers.html) for customer
workflows and limitations.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `search_coverage` | **Search DID coverage.** Finds DID groups and SKUs by country, city, region, prefix, number type, or supported feature. Returns pricing, included channels, registration requirements, availability, and back-ordering information. | Read-only | No |
| `list_dids` | **List DIDs.** Lists the active account's phone numbers and their descriptions. Supports filters for number, text contained in the description, country, DID group, and status. | Read-only | No |
| `get_did` | **Get a DID.** Returns the description, routing, capacity, verification, billing, and other supported details for one phone number. | Read-only | No |
| `get_did_history` | **Get DID history.** Returns purchase, renewal, cancellation, restoration, stock-removal, and renewal-setting events from the last 90 days for one phone number. | Read-only | No |
| `buy_did` | **Buy DID.** Purchases one or more phone numbers from the active account's prepaid balance after showing availability, charges, service restrictions, and any delayed provisioning. Back-ordering is allowed by default unless explicitly disabled. | Write, purchase | Yes |
| `update_did` | **Update a DID.** Adds, changes, or clears the phone number's description. The tool can also continue automatic monthly renewal, limit renewal to a specified number of additional cycles, or stop renewal at the current expiration date. A stopped renewal can be resumed before expiration. It can remove the DID from its emergency calling service, stopping that number's charge from the next renewal. A service with no remaining numbers is automatically canceled within a few hours, and DIDWW notifies the customer. Returns the resulting description, expiration date, and renewal setting. | Write | No |
| `update_did_description` | **Update DID descriptions in bulk.** Applies one shared description to 1-100 DIDs or clears their descriptions. DIDWW validates every DID before applying any change. If an ID is malformed, unknown, belongs to another account, or is otherwise inaccessible, the complete request fails without changing any DID and identifies every offending ID. On success, the response returns every affected phone number with its resulting description, the count, and a message. | Write | No |
| `delete_did` | **Terminate a DID.** Immediately stops incoming calls and SMS and removes the number from active service. Stopping renewal with `update_did` is the preferred reversible alternative when the customer only wants to stop future payments. A terminated number can generally be restored for approximately 35 days before it returns to public stock. A number on a pending order is canceled with a refund instead. Bulk Order numbers cannot be terminated through this action. | Write, destructive | Yes |
| `restore_did` | **Restore a terminated DID.** Restores a recently terminated phone number. An expired number requires a paid renewal and confirmation before it can be restored. | Write | Conditional |

## Inbound voice routing

See [Inbound routing](work-with-didww-mcp/inbound-routing.html) for trunk,
group, assignment, and number-list behavior.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `list_trunks` | **List inbound trunks.** Lists SIP, PSTN, phone.systems(TM), and trunk-group routing destinations, including supported filters and DID-assignment counts. | Read-only | No |
| `get_trunk` | **Get an inbound trunk.** Returns the supported configuration and DID assignments for one trunk. Password values are never returned. | Read-only | No |
| `create_sip_trunk` | **Create a SIP inbound trunk.** Creates an inbound SIP destination using a fixed host or SIP-registration mode. Registration credentials are generated by DIDWW and returned with the password masked. | Write | No |
| `update_sip_trunk` | **Update a SIP inbound trunk.** Changes only the supplied SIP and routing settings. Changes can affect live incoming calls immediately, and returned passwords are masked. | Write | No |
| `create_pstn_trunk` | **Create a PSTN inbound trunk.** Creates a destination that forwards incoming calls to a telephone number. DIDWW shows the applicable per-minute rate before confirmation. The trunk cannot be created when no rate is available for the destination. | Write | Yes |
| `update_pstn_trunk` | **Update a PSTN inbound trunk.** Changes only the supplied settings. Changing the destination requires confirmation of its new per-minute rate. Other changes apply without a DIDWW confirmation. | Write | Conditional |
| `create_phone_systems_trunk` | **Create a phone.systems(TM) inbound trunk.** Creates an inbound route to the account's phone.systems(TM) cloud PBX. The phone.systems(TM) feature must be enabled for the active account. | Write | No |
| `update_phone_systems_trunk` | **Update a phone.systems(TM) inbound trunk.** Changes only the supplied settings of an existing phone.systems(TM) trunk. | Write | No |
| `assign_did_to_trunk` | **Assign DIDs to an inbound trunk.** Assigns, reassigns, or unassigns up to 100 phone numbers in one all-or-nothing operation. The destination can be a SIP, PSTN, phone.systems(TM), or trunk-group route. | Write | No |
| `delete_trunk` | **Delete an inbound trunk.** Permanently deletes an inbound trunk. A trunk assigned to a DID cannot be deleted. | Write, destructive | Yes |
| `list_trunk_groups` | **List inbound trunk groups.** Lists failover and load-balancing groups, their assigned-DID counts, and member trunks in routing order. | Read-only | No |
| `create_trunk_group` | **Create an inbound trunk group.** Creates a failover or load-balancing group containing up to 10 existing inbound trunks. Routing uses member priority and weight. | Write | No |
| `update_trunk_group` | **Update an inbound trunk group.** Changes supported group settings. A supplied member list replaces the complete existing list. Removed members are detached from the group but are not deleted. | Write | No |
| `delete_trunk_group` | **Delete an inbound trunk group.** Permanently deletes a group that has no assigned DIDs. Member trunks are detached and retained by default, or eligible members can also be permanently deleted. | Write, destructive | Yes |
| `list_voice_in_number_lists` | **List inbound number lists.** Lists caller-number filters, their matching modes, entry counts, and attached trunks. List entries are retrieved separately. | Read-only | No |
| `get_voice_in_number_list` | **Get an inbound number list.** Returns one caller-number filter and its stored entries. Entries are paginated and retain their exact stored values. | Read-only | No |
| `create_voice_in_number_list` | **Create an inbound number list.** Creates an allow or reject filter for full caller numbers or prefixes. The list does not affect calls until it is attached to a SIP or PSTN trunk. | Write | No |
| `update_voice_in_number_list` | **Update an inbound number list.** Changes list settings or atomically adds and removes entries. Removed entries must match their exact stored values. Changes immediately affect every attached trunk. | Write | No |
| `delete_voice_in_number_list` | **Delete an inbound number list.** Permanently deletes a number list and all its entries. A list attached to a trunk must be detached before it can be deleted. | Write, destructive | Yes |

## Messaging

See [Messaging](work-with-didww-mcp/messaging.html) for inbound SMS routing
workflows and limitations.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `list_sms_trunks` | **List SMS trunks.** Lists SMS trunks and SMS trunk groups, with supported filters for name and type. | Read-only | No |
| `get_sms_trunk` | **Get an SMS trunk.** Returns the supported configuration and DID assignments for one SMS trunk or group. | Read-only | No |
| `create_sms_trunk` | **Create an SMS trunk.** Creates an HTTP IN or SMS to Email destination for incoming messages. | Write | No |
| `update_sms_trunk` | **Update an SMS trunk.** Changes supported delivery settings for an existing SMS trunk. | Write | No |
| `delete_sms_trunk` | **Delete an SMS trunk.** Permanently deletes an eligible SMS trunk. A group deletion also deletes its member trunks. | Write, destructive | Yes |
| `assign_did_to_sms_trunk` | **Assign DIDs to an SMS trunk.** Assigns, reassigns, or unassigns up to 100 SMS-enabled phone numbers in one all-or-nothing operation. | Write | No |
| `create_sms_trunk_group` | **Create an SMS trunk group.** Creates a group from existing inbound SMS trunks and their priorities. | Write | No |
| `update_sms_trunk_group` | **Update an SMS trunk group.** Changes the name or member trunks of an existing SMS trunk group. | Write | No |

## Capacity

See [Capacity](work-with-didww-mcp/voice-capacity.html) for capacity
types, assignments, and billing behavior.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `list_capacity_pools` | **List capacity pools.** Lists purchased channel pools, covered countries, renewal information, free channels, and metered rates. | Read-only | No |
| `buy_capacity_channels` | **Purchase capacity channels.** Purchases additional flat-rate channels for a capacity pool from the active account's prepaid balance. | Write, purchase | Yes |
| `list_capacity_groups` | **List capacity groups.** Lists shared capacity groups and the capacity pool used by each group. | Read-only | No |
| `create_capacity_group` | **Create a capacity group.** Creates a shared group using purchased channels and can enable metered, pay-per-use channels. | Write | Yes |
| `update_capacity_group` | **Update a capacity group.** Renames a group or changes its shared and metered channel limits. Increasing metered capacity requires a preview. | Write | Conditional |
| `delete_capacity_group` | **Delete a capacity group.** Deletes an empty group and returns its reserved shared channels to the capacity pool. | Write, destructive | Yes |
| `assign_did_to_capacity_group` | **Assign a DID to a capacity group.** Lets a phone number draw shared or metered channels from the group's capacity pool. | Write | No |
| `unassign_did_from_capacity_group` | **Unassign a DID from a capacity group.** Stops a phone number from drawing channels from its current shared capacity group. | Write | No |
| `assign_dedicated_channels_to_did` | **Manage dedicated channels.** Reserves purchased pool channels for one phone number or releases an existing reservation. | Write | No |

## Billing

See [Billing and payments](work-with-didww-mcp/billing-and-payments.html) for
available billing information and limitations.

All billing tools are read-only. DIDWW MCP cannot add funds, charge a saved
card, remove a saved card, or otherwise manage payment methods.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `get_balance` | **Get the balance.** Returns the active account's prepaid balance and supported billing-standing information. | Read-only | No |
| `get_dashboard` | **Get the account summary.** Returns a read-only summary of available account, service, and billing information. | Read-only | No |
| `list_invoices` | **List invoices.** Lists invoices and supports filtering by year and month. | Read-only | No |
| `get_invoice` | **Get an invoice.** Returns supported details for one invoice. | Read-only | No |
| `list_payments` | **List payments.** Lists completed and recorded payments for the active account. | Read-only | No |
| `list_orders` | **List orders.** Lists purchase orders, newest first. | Read-only | No |
| `list_refunds` | **List refunds.** Lists completed refunds that returned funds. | Read-only | No |
| `list_credit_cards` | **List saved cards.** Lists masked saved-card information without returning full card details. | Read-only | No |

## Compliance and verification

See [Compliance and verification](work-with-didww-mcp/compliance-and-verification.html) for the end-user
registration flow and secure document handling.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `list_requirements` | **List registration requirements.** Lists country and DID-type requirements, required fields, proof types, and whether each requirement applies to the active account. | Read-only | No |
| `list_identities` | **List identities.** Lists end-user identities and supported proof information. | Read-only | No |
| `create_identity` | **Create an identity.** Creates a personal or business identity for the actual end user, who may be the DIDWW customer's subscriber. Use the identity type and required fields from the registration requirement. Business identities require a company name and authorized representative. Provide verified information only. The identity can be validated before proof documents are uploaded securely and its address is created. | Write | No |
| `update_identity` | **Update an identity.** Changes supported identity fields needed by a registration or emergency requirement. | Write | No |
| `delete_identity` | **Delete an identity.** Permanently deletes an eligible identity with all its addresses and stored documents. Deletion is blocked for a system identity, one linked to a phone number, one with a new or pending address verification, or one used by an unfinished emergency calling service or SMS campaign. Permanent supporting documents require compliance permission. The response identifies the applicable blocker. | Write, destructive | Yes |
| `list_addresses` | **List addresses.** Lists end-user addresses and supported proof information. | Read-only | No |
| `create_address` | **Create an address.** Creates an address under an existing end-user identity. | Write | No |
| `update_address` | **Update an address.** Changes supported address fields. | Write | No |
| `delete_address` | **Delete an address.** Permanently deletes an eligible address and its stored proof documents. | Write, destructive | Yes |
| `validate_address` | **Validate an address.** Checks an address and its identity against a registration or emergency requirement without changing account data. | Read-only | No |
| `create_regulation_upload_link` | **Create a requirement-based upload link.** Creates a one-time browser link for missing documents and can submit the related verification after upload. | Write | No |
| `create_proof_upload_link` | **Create a proof upload link.** Creates a one-time browser link for explicitly selected identity or address proof types. | Write | No |
| `check_upload_status` | **Check upload status.** Shows whether a secure upload is pending, completed, or expired and identifies records created on completion. | Read-only | No |
| `delete_proof` | **Delete a proof document.** Permanently removes an eligible stored proof document. | Write, destructive | Yes |
| `create_address_verification` | **Submit an address verification.** Submits eligible phone numbers for registration review when all required documents already exist. | Write | No |
| `list_address_verifications` | **List address verifications.** Lists verification statuses and available rejection information. | Read-only | No |

## Emergency calling

See [Emergency calling](work-with-didww-mcp/emergency-calling.html) for the
currently documented customer workflow.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `list_emergency_requirements` | **List emergency requirements.** Returns identity and address requirements and available pricing for emergency calling. | Read-only | No |
| `list_emergency_calling_services` | **List emergency services.** Lists existing emergency calling services, assigned phone numbers, prices, and verification statuses. | Read-only | No |
| `create_emergency_verification` | **Submit an emergency verification.** Submits a new service for staff review or resubmits an existing service. New-service mode requires a cost preview and confirmation, but billing begins only after staff activates the service. Resubmission adds no charge and is not confirmation-gated. | Write | Conditional |

## Exports

See [Exports](work-with-didww-mcp/data-exports.html) for supported export
types, date limits, and download behavior.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `create_export` | **Create an export.** Starts an asynchronous CSV export for supported call records, SMS logs, DIDs, orders, or payments. | Write | No |
| `get_export` | **Get an export.** Returns the status of one export and its download link after completion. | Read-only | No |
| `list_exports` | **List exports.** Lists recent exports and supports filtering by type or status. | Read-only | No |

## Users and invitations

See [Users and invitations](work-with-didww-mcp/users-and-invitations.html) for permissions, privacy
considerations, and limitations.

| Tool | Purpose | Access | DIDWW confirmation |
| --- | --- | --- | --- |
| `list_user_accesses` | **List account users.** Lists users who can access the active DIDWW account and their assigned roles. | Read-only | No |
| `list_invite_requests` | **List pending invitations.** Lists invitations that have not yet been accepted or canceled. | Read-only | No |
| `create_invite_request` | **Invite a user.** Creates a pending invitation and sends an email after the email address and assigned roles are confirmed. | Write, external action | Yes |
| `cancel_invite_request` | **Cancel a pending invitation.** Invalidates an unanswered invitation so that it can no longer be accepted. | Write | No |

On this page