Provision Dedicated Telecom & Voice AI Numbers
telecom_numbersSearch available E.164 phone numbers, provision dedicated telecom numbers ($1.50/mo vs $59/mo legacy bundles), list active numbers, or bind a number to a SIP/WebRTC Voice AI Agent trunk. Use this tool when an AI agent needs a dedicated SMS, WhatsApp Business Cloud, or inbound/outbound voice phone number in the US, Spain, UAE, UK, or EU. Returns available or provisioned TelecomNumber records with capabilities (sms, voice, whatsapp) and SIP trunk URIs.
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": {
"action": "<action>"
},
"name": "telecom_numbers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Telecom number operation: 'search_available' lists purchasable E.164 numbers by country, 'provision' activates a dedicated number ($1.50/mo), 'configure_sip_voice_agent' attaches a SIP URI and voice prompt, and 'list' returns active workspace numbers. | |
| numberId | No | Internal telecom number identifier (`num_...`) when configuring SIP routing via `configure_sip_voice_agent`. | |
| profileId | No | Brand profile identifier (`prof_...`) that owns the telecom number. | prof_allometrik |
| countryCode | No | Two-letter ISO-3166 alpha-2 country code for number search or provisioning (e.g. 'ES' for Spain +34, 'US' for United States +1, 'AE' for UAE +971, 'GB' for UK +44). | ES |
| phoneNumber | No | Specific E.164 phone number (e.g. '+34919021101' or '+14158904321') to provision when `action` is 'provision'. | |
| sipTrunkUri | No | Destination SIP or WebRTC trunk URI (e.g. 'sip:voice-agent@sip.nuntior.com') for routing live inbound/outbound AI voice calls. | |
| voiceAgentPrompt | No | System instructions and persona prompt for the realtime AI Voice Agent answering or placing calls on this number. |