get_available_numbers
Retrieve purchasable phone numbers by filtering country code, type, and location for VoiceAI integrations.
Instructions
Get available phone numbers for purchase
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country_code | No | Country code | US |
| number_type | No | Number type | local |
| search_pattern | No | Search for numbers containing this pattern | |
| locality | No | Locality/city for local numbers |
Implementation Reference
- index.js:623-630 (handler)Handler logic for the 'get_available_numbers' tool. Constructs URL query parameters based on input arguments (country_code, number_type, search_pattern, locality) and sets the API endpoint to fetch available Twilio phone numbers.
case 'get_available_numbers': const params = new URLSearchParams(); if (args.country_code) params.append('code', args.country_code); if (args.number_type) params.append('type', args.number_type); if (args.search_pattern) params.append('search', args.search_pattern); if (args.locality) params.append('locality', args.locality); url = `${this.baseUrl}/twilio/numbers/available?${params.toString()}`; break; - index.js:343-357 (registration)Tool registration including name, description, and input schema definition for 'get_available_numbers' in the list of available tools returned by ListToolsRequestSchema.
{ name: 'get_available_numbers', description: 'Get available phone numbers for purchase', inputSchema: { type: 'object', properties: { country_code: { type: 'string', description: 'Country code', default: 'US' }, number_type: { type: 'string', enum: ['local', 'tollfree', 'mobile'], description: 'Number type', default: 'local' }, search_pattern: { type: 'string', description: 'Search for numbers containing this pattern' }, locality: { type: 'string', description: 'Locality/city for local numbers' } }, required: [] } }, { - index.js:346-356 (schema)Input schema definition for the 'get_available_numbers' tool, specifying properties for country_code, number_type, search_pattern, and locality.
inputSchema: { type: 'object', properties: { country_code: { type: 'string', description: 'Country code', default: 'US' }, number_type: { type: 'string', enum: ['local', 'tollfree', 'mobile'], description: 'Number type', default: 'local' }, search_pattern: { type: 'string', description: 'Search for numbers containing this pattern' }, locality: { type: 'string', description: 'Locality/city for local numbers' } }, required: [] } },