Quote phone numbers
quote_numbersCompare available phone numbers and their prices without buying or charging.
Returns ``offers``, ``recommended_quote_id`` and ``expires_at``.
Each offer includes ``e164``, ``number_type``, ``capabilities``, ``quote_id``,
``monthly_cents``, ``setup_cents``, ``readiness``, ``requirements``,
``subject_types``, ``verifications``, ``locality`` and ``region``.
Prices are USD cents. ``locality`` and ``region`` tell apart cities with the same name.
Quotes expire after ten minutes. Expired quotes cannot authorize a purchase.
``recommended_quote_id`` identifies a ready offer or is null when none is ready.
``subject_types`` identifies eligible personal or business registrations.
``verifications`` contains accepted registrations, with approved entries first.
Entries include ``id``, ``state``, ``subject_type`` and ``subject_name``.
``readiness="verification_required"`` means registration approval is still needed.
Registration requirements are specific to the quote and applicant type.
An offer with ``by_request=true`` has no assigned number and requires a manual support order.
Such offers remain valid for registration but are unavailable for automatic purchase.
An upstream failure returns an error.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_code": "<country_code>"
},
"name": "quote_numbers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name as carriers list it, such as ``Austin``. Omitted: any city. | |
| region | No | US state or Canadian province code from ``list_number_regions``, to tell apart cities with the same name. Omitted: any region. | |
| area_code | No | First digits of the number as dialed inside the country, such as ``415``. Omitted: any digits. | |
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| number_type | No | Offer only this kind of number, for example ``toll_free`` for a number callers reach for free. Omitted: every kind. | |
| capabilities | No | What every offered number must do: calls (``voice``), texts (``sms``) or both. Omitted: both. | |
| country_code | Yes | ISO 3166-1 alpha-2 country code, such as ``US``. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||