Phone numbers with DIDWW MCP#

Use DIDWW MCP to find and purchase phone numbers and manage numbers already available in your account through a connected MCP client.

Note

The available actions, prices, permissions, and service requirements depend on the active DIDWW account and the selected phone numbers.

What you can do#

Describe the action or result you want in plain language. When possible, identify the relevant DIDWW account and phone numbers in your request.

Find and purchase phone numbers#

Action	What you can request
Find available numbers	Search DIDWW coverage by country, area, prefix, number type, and other supported criteria.
Review pricing	Compare available purchase options, setup charges, recurring charges, and included capacity before ordering.
Purchase phone numbers	Purchase one or multiple phone numbers after reviewing and confirming the order and its charges.
Order available and delayed numbers	Allow an order to proceed when some requested numbers are not immediately available and the selected offer supports back-ordering. The preview distinguishes numbers allocated immediately from numbers to be supplied later.
Order immediately available numbers only	Require the complete quantity to be available immediately. The order does not proceed when the requested quantity is not currently available.

Important

Availability and pricing can change between the search and the purchase. Review the purchase preview for the current charges and service conditions before confirming the order.

Immediate and delayed number allocation#

When back-ordering is supported, a purchase can proceed even when the complete quantity is not immediately available. The purchase preview or result shows:

the quantity allocated immediately
the quantity that will be supplied later

Review both quantities before confirming. To prevent delayed fulfillment, ask the MCP client to purchase only when the complete quantity is available immediately and not to place a back-order. If insufficient inventory is available, the purchase does not proceed.

Manage phone numbers#

Action	What you can request
Review phone numbers	List the phone numbers in your account and review a specific number’s status, billing cycle, capacity, routing, and supported services.
Update number settings	Change supported number settings and service assignments. Only settings permitted for the account and selected number can be changed.
Continue automatic renewal	Renew a phone number every monthly billing cycle without setting an end date.
Limit the remaining renewals	Renew a phone number for a specified number of additional monthly billing cycles, then allow it to expire.
Stop number renewal	Keep a phone number active until its current expiration date, then allow it to expire. Renewal can be resumed before the number expires.
Remove a number from emergency calling	Detach a phone number from its emergency calling service. Its emergency calling charge stops from the next renewal. If no numbers remain, DIDWW automatically cancels the service within a few hours and notifies the customer.
Review number history	Review recent purchases, renewals, cancellations, and restorations for a phone number.
Terminate a phone number	Terminate a number immediately after reviewing and confirming the effect. Incoming calls and SMS stop immediately, and the number is released from the account.
Restore a phone number	Restore a recently terminated number when it is still eligible for restoration and the account has sufficient balance.
Review active routing	Check whether a phone number is assigned to an inbound trunk or trunk group.

After a renewal change, the MCP client returns the resulting expiration date and renewal setting.

Only removal from an emergency calling service is supported through the phone number update. To assign a number, follow the emergency verification flow described in Emergency calling with DIDWW MCP.

Stop renewal or terminate immediately#

If the objective is only to stop future renewal charges, stop renewal instead of terminating the phone number. The number remains fully usable until its current expiration date, and renewal can be resumed before it expires.

Terminate a phone number only when it must be removed immediately. Termination stops inbound calls and SMS and removes the number from the account. A terminated number can generally be restored for approximately 35 days while it remains in the terminated state. After that period, it can return to public availability and may be permanently lost.

A phone number on a still-pending order is canceled with a refund instead. A phone number purchased through a Bulk Order cannot be terminated through this action.

Phone numbers and inbound routing#

Purchasing a phone number does not automatically configure it to receive calls. Assign the number to a supported inbound trunk or trunk group after the purchase.

Some phone numbers also require additional capacity before they can receive incoming calls.

See Inbound routing with DIDWW MCP to learn which routing actions can be completed through a connected MCP client.

Permissions and confirmations#

The MCP client uses the permissions of the DIDWW user who authorized the connection. It cannot access phone numbers that the user is not permitted to access.

Requests that only find or review information do not change your account. DIDWW requires confirmation before:

purchasing phone numbers, including accepting delayed fulfillment
terminating a phone number immediately

Changing renewal settings or removing a number from emergency calling does not use DIDWW’s two-step confirmation flow. Removing a number from emergency calling requires emergency calling management permission.

Review the active DIDWW account, selected location, quantity, one-time charges, recurring charges, service conditions, affected routing, effect on incoming calls and SMS, and restoration conditions before confirming.

Your MCP client may display its own approval request before calling a DIDWW tool. This application approval is separate from a DIDWW purchase or destructive-action confirmation.

Product requirements#

A phone-number request may be unavailable because of:

the permissions assigned to the DIDWW user
phone-number availability
insufficient account balance
country or number-type restrictions
end-user verification requirements
a required service that is not enabled for the account

When DIDWW cannot complete a request, the response identifies the applicable requirement or restriction when available.

If the prepaid balance is insufficient, add funds through Payment Methods in the DIDWW User Panel , then request a new purchase preview. DIDWW MCP cannot charge a payment card or add funds to the account.

Use the DIDWW User Panel or contact DIDWW Customer Support when another requested action cannot be completed through MCP.

Current limitations#

DIDWW MCP does not currently support:

creating or managing number porting requests
submitting CNAM OUT requests
creating, applying, or managing configuration profiles
selecting a specific premium or golden phone number

Use the DIDWW User Panel for actions that are not currently available through MCP.