order_virtual_number
Rent a virtual number from the balance. type "unlimited" receives SMS from every service; type "service" is dedicated to one service (pass its id from get_number_pricing). pool picks MAIN or EXTRA for an unlimited number where get_number_pricing lists pools (when omitted, the pool it names in unlimitedPool); tell the user first when the chosen term is not cancellable, and which pool's numbers are.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country": "<country>",
"term": "<term>"
},
"name": "order_virtual_number"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pool | No | Unlimited only: the pool to buy from, from pools in get_number_pricing (default: its unlimitedPool) | |
| term | Yes | Rental term | |
| type | No | Number type (default unlimited) | |
| country | Yes | ISO country code | |
| service | No | Service id for a dedicated number | |
| nickname | No | Unlimited only: a label | |
| autoRenew | No | Unlimited only: renew from the balance before expiry |