# Capacity with DIDWW MCP

Use DIDWW MCP to review capacity, purchase flat-rate channels, assign
purchased channels, and manage supported capacity groups.

Capacity determines how many simultaneous incoming calls DIDWW can deliver.
For complete explanations of included, dedicated, shared, metered, and hybrid
capacity, capacity modes, and capacity priority, see [How capacity
works](../../phone-numbers/capacity/how-capacity-works.html).

## What you can do

Describe the required result in plain language. When possible, identify the
active DIDWW account, relevant DID numbers, and expected number of simultaneous
incoming calls.

### Review capacity

| Action | Available information |
| --- | --- |
| Review capacity pools | Review supported countries, flat-rate channel prices, metered rates, purchased and unassigned channels, allocations, and renewal information. |
| Review capacity groups | Review each group's capacity pool, shared channels, metered channel limit, and assigned DID numbers. |
| Review a DID number | Review its current capacity mode, included channels, dedicated channels, and capacity-group assignment. |
| Check an assignment | Check whether a compatible pool has enough unassigned flat-rate channels for a proposed dedicated or shared assignment. |

### Purchase flat-rate channels

Flat-rate channels are purchased from a compatible capacity pool using funds
already available in the active account's prepaid balance.

Before completing a purchase, DIDWW shows a preview that includes the active
account, capacity pool, channel quantity, price, renewal information, and
whether the purchase is refundable. The purchase is completed only after the
preview is confirmed.

If the prepaid balance is insufficient, add funds through [Payment Methods in
the DIDWW User Panel](https://my.didww.com/#/payment_methods), then request a
new purchase preview. DIDWW MCP cannot charge a payment card or add funds to the
account.

### Assign capacity

| Action | What changes |
| --- | --- |
| Assign dedicated channels | Reserves purchased flat-rate channels from a compatible pool for one DID number. |
| Change a dedicated assignment | Increases, decreases, or removes a DID number's dedicated-channel assignment. Released channels remain purchased and become unassigned in the pool. |
| Assign a DID number to a capacity group | Allows the DID number to use the group's shared or metered channels. |
| Unassign a DID number from a capacity group | Stops the DID number from using that group's capacity. |

Assigning channels that are already purchased does not buy additional
capacity. These assignments are reversible.

### Manage capacity groups

| Action | What you can request |
| --- | --- |
| Create a capacity group | Create a group in a selected capacity pool with shared channels, metered channels, or both. |
| Update a capacity group | Change its name, shared-channel allocation, or metered-channel limit. |
| Assign or unassign DID numbers | Add eligible DID numbers to a compatible group or remove them after reviewing the effect on incoming-call capacity. |
| Delete a capacity group | Delete an empty group and return its shared channels to the pool as unassigned purchased capacity. |

## Before making changes

Check that:

- the expected DIDWW account is active
- the selected capacity pool supports the countries of the DID numbers
- enough unassigned flat-rate channels are available for an assignment
- the prepaid balance is sufficient for a channel purchase
- the DIDWW user has permission to manage the relevant DID numbers and capacity

A request can also be rejected when a product validation applies. The MCP
client returns the available reason when the request cannot be completed.

## Confirmations and approvals

DIDWW confirmation and MCP client tool approval are separate controls.

| Action | DIDWW confirmation | MCP client approval |
| --- | --- | --- |
| Review capacity | No | May be displayed by the client. |
| Purchase flat-rate channels | Yes. DIDWW returns a purchase preview before changing the account. | May also be displayed by the client. |
| Create a capacity group | Yes. DIDWW returns a preview before creating the group. | May also be displayed by the client. |
| Update a capacity group | Required when the change increases metered capacity. Other supported updates do not use DIDWW confirmation. | May be displayed by the client. |
| Delete a capacity group | Yes. DIDWW returns a deletion preview before removing the group. | May also be displayed by the client. |
| Assign or unassign purchased channels or DID numbers | No | May be displayed by the client. |

An MCP client's approval prompt authorizes it to call a DIDWW tool. When DIDWW
confirmation is required, the first call returns a preview and makes no change.
The action is completed only after that DIDWW preview is confirmed.

## Current limitations

DIDWW MCP does not currently support:

- viewing detailed capacity usage or exceeded-capacity events
- changing a DID number's current or next capacity mode
- reducing the total number of purchased flat-rate channels

Use the DIDWW User Panel for these actions. DIDWW MCP can release dedicated or
shared assignments, but the released flat-rate channels remain purchased in the
capacity pool.

## Example requests

Review a DID number's capacity

```
Show the current capacity for +370XXXXXXXX.
Include its capacity mode, included and dedicated channels,
and capacity-group assignment. Do not make any changes.
```

Review compatible capacity pools

```
Show the capacity pools that support my Lithuanian DID numbers.
Include flat-rate prices, metered rates, purchased channels,
unassigned channels, and renewal information.
Do not purchase or assign anything.
```

Review a channel purchase

```
Show the purchase preview for five flat-rate channels in a compatible
capacity pool. Include the price, renewal information, and balance.
Do not complete the purchase until I confirm it.
```

Assign dedicated channels

```
Check whether three unassigned flat-rate channels can be assigned to
+370XXXXXXXX as dedicated capacity.
Show the current and proposed assignments before making the change.
```

Create a shared capacity group

```
Prepare a capacity group named Lithuania Support with five shared
flat-rate channels for +370XXXXXXXX and +370YYYYYYYY.
Show the pool, available channels, and proposed assignments.
Do not create the group until I confirm it.
```

Configure metered overflow

```
Show a proposed capacity group for my Sales DID numbers.
Use five shared flat-rate channels and allow up to 20 simultaneous
metered calls for overflow. Include the applicable rates.
Do not create or change anything until I confirm it.
```

Change an existing assignment

```
Show the current capacity configuration for +370XXXXXXXX.
Assign it to the capacity group named Lithuania Support and explain
which capacity it can use after the change.
```

Delete a capacity group

```
Review the capacity group named Old Overflow.
Show its assigned DID numbers and allocated channels.
Explain the effect of deleting it.
Do not delete the group until I confirm it.
```

On this page