Available tools

DIDWW MCP currently exposes 81 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 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 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 supports filters for number, country, DID group, and status.	Read-only	No
get_did	Get a DID. Returns 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 DID renewal or emergency assignment. Continues automatic monthly renewal, limits renewal to a specified number of additional cycles, or stops renewal at the current expiration date. A stopped renewal can be resumed before expiration. The tool can also 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 expiration date and renewal setting.	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 for trunk, group, assignment, and number-list behavior.

Tool	Purpose	Access	DIDWW confirmation
list_trunks	List inbound trunks. Lists SIP, PSTN, phone.systems™, 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™ inbound trunk. Creates an inbound route to the account’s phone.systems™ cloud PBX. The phone.systems™ feature must be enabled for the active account.	Write	No
update_phone_systems_trunk	Update a phone.systems™ inbound trunk. Changes only the supplied settings of an existing phone.systems™ 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™, 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 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 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 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 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 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 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 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