buy_number
Purchase a new phone number and charge your account balance. Specify country/area code, optionally attach an agent, and set confirm=true to complete.
Instructions
Purchase a new phone number. This is a paid purchase that charges the account's balance. area_code requests a specific region (e.g. '415' for San Francisco); agent_id attaches it on purchase. Requires confirm=true to proceed.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "buy_number"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Must be true to complete the purchase. When false, no number is bought. | |
| country | No | 2-letter ISO country code (e.g. US, CA, GB) | US |
| agent_id | No | Agent ID to attach this number to immediately | |
| area_code | No | 3-digit area code for a specific region (e.g. '415', '212', '310') |