quote_numbers

io.github.hail-hq/hail-mcp · Verify this server

Compare live phone-number offers from the carriers. Read-only: it buys nothing and charges nothing. ``country_code`` is an ISO alpha-2 code such as ``"US"``. ``capabilities`` is ``["voice"]``, ``["sms"]`` or both (default). ``number_type`` is ``local``, ``mobile``, ``national`` or ``toll_free``; omit it to compare all types. ``provider`` is ``auto`` (compare all carriers), ``twilio``, ``telnyx`` or ``didww``. ``area_code`` is an area code or the first digits of the number, as dialed in the country: ``"020"`` (London), ``"480"`` (Arizona). ``city`` is a city name such as ``"London"``. Each offer has ``locality`` and ``region`` (such as ``"Phoenix"``, ``"AZ"``): check them, since city names repeat across states. ``region`` (optional, with ``city``) is a US/CA state code; list_number_regions lists them. Omit all three to search the whole country. Returns ``{"offers": [...], "recommended_quote_id", "unavailable_providers", "expires_at"}``. Each offer has ``e164``, ``provider``, ``number_type``, ``capabilities``, ``monthly_cents``, ``setup_cents``, ``readiness``, ``requirements`` and ``quote_id``. Money fields are cents (USD). Quotes expire in 10 minutes (``expires_at``); quote again after that. An offer with ``readiness == "verification_required"`` cannot be bought until the organization is verified. Call get_verification_requirements, ask the user for the details, then submit_verification and poll get_verification (review takes business days). ``requirements`` lists what the carrier needs. Prefer an offer whose ``readiness`` is ``"ready"``; ``recommended_quote_id`` points at the best one, or is null if none is ready. Errors come back as ``{"error": "<message>"}``.