{"id":"io.github.hail-hq/hail-mcp","slug":"io-github-hail-hq-hail-mcp","title":"Hail","description":"Run your AI assistant with real phone numbers and email inboxes. Handle calls, texts, and email.","version":"0.2.0","publisher":{"kind":"github","id":"hail-hq","label":"@hail-hq on GitHub","url":"https://github.com/hail-hq"},"website":"https://hail.so/mcp","repository":"https://github.com/hail-hq/hail","remotes":[{"type":"streamable-http","url":"https://mcp.hail.so"}],"packages":[],"published":"2026-11-19","updated":"2026-11-19","status":"online","auth":"","latency_ms":1225,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"place_call","title":"Place a phone call","description":"Start an outbound AI phone call.\n\n        At least one of ``system_prompt``, ``llm`` or ``agent_id`` is required.\n        US artificial-voice calls (47 CFR 64.1200(b)(1)) require the AI disclosure.\n        Hail does not verify the lawful basis or the recipient's consent.\n        A 4xx response returns no ``idempotency_key``.\n\n        Returns the call ID, status, phone numbers and ``idempotency_key","read_only":false},{"name":"send_email","title":"Send an email","description":"Send an email from a verified workspace sender.\n\n        Plain-text emails still have sending, delivery and bounce events.\n\n        Without ``from_``, one verified custom domain takes priority over the Hail mail address.\n        Several verified custom domains require an explicit ``from_`` address.\n        A custom domain blocked from sending (``sends_enabled`` false, PATCH ``/v1/email-domains/{id","read_only":false},{"name":"upload_email_attachment","title":"Upload an email attachment","description":"Upload a small attachment for outbound email, as base64 text.\n\n        Meant for small files (under about 50 KB): every base64 character goes\n        through the tool call itself. Larger files go through ``create_file_upload``\n        with ``purpose=\"email_attachment\"``: its ``curl`` line sends the bytes, and its\n        ``id`` works in ``send_email``'s ``attachment_ids``.\n        Returns ``id``, ","read_only":false},{"name":"create_file_upload","title":"Create a file upload link","description":"Create a one-time link that uploads one file from a shell with curl.\n\n        The bytes go from the local disk to Hail directly, not through the tool call,\n        so any file that is not tiny goes this way.\n        An email attachment can be up to 25 MB. A verification document must be\n        JPG, PNG or PDF, up to 10 MB, and is usable for 1 hour after the upload.\n        Returns ``id``, ``uploa","read_only":false},{"name":"get_call","title":"Get a call","description":"Read a call's current status, timing and transcript by ID.\n\n        Returns the call record with its transcript (spoken turns, in the\n        order they were said), or an error when the call is unavailable.","read_only":true},{"name":"list_calls","title":"List calls","description":"List recent workspace calls, newest first.\n\n        Returns ``items`` and ``next_cursor``.","read_only":true},{"name":"send_sms","title":"Send a text message","description":"Send an outbound text message.\n\n        Without ``from_``, supported destinations use the workspace's alphanumeric sender ID.\n        Other destinations use an eligible workspace SMS-capable number.\n        A missing required number returns 422. SMS does not use the shared voice-call pool.\n        US long-code texting to US recipients requires ready A2P 10DLC registration and an attached number.\n ","read_only":false},{"name":"get_sms","title":"Get a text message","description":"Read a text message's current state by ID.\n\n        Returns the message record, including delivery status, or an error.","read_only":true},{"name":"list_sms","title":"List text messages","description":"List recent workspace text messages.\n\n        Returns ``items`` and ``next_cursor``.","read_only":true},{"name":"get_email","title":"Get an email","description":"Read a complete workspace email by ID.\n\n        Returns ``body_text``, ``body_html`` and other email fields.\n        Inbound records include reply headers and spam, virus, SPF, DKIM and DMARC verdicts.\n        Attachments include IDs and file metadata.\n        An unknown or inaccessible email returns an error.","read_only":true},{"name":"list_emails","title":"List emails","description":"List workspace email summaries, newest first.\n\n        Summaries contain IDs and metadata, without message bodies.\n        Returns ``items`` and ``next_cursor``, or an error.","read_only":true},{"name":"get_email_raw","title":"Get raw email","description":"Return a temporary download URL for an inbound email's original MIME source.\n\n        The URL expires after approximately five minutes and requires no authorization header.\n        Raw source is available only for inbound emails.\n        Returns ``url``, or an error for an unavailable email.","read_only":true},{"name":"get_email_attachment","title":"Get an email attachment","description":"Return a temporary download URL for an inbound email attachment.\n\n        The URL expires after approximately five minutes and requires no authorization header.\n        Returns ``url``, or an error for an unavailable attachment.","read_only":true},{"name":"get_email_events","title":"Get email events","description":"Read one email's delivery and engagement timeline.\n\n        Events include sent, delivered, delivery_delayed, bounced, complained,\n        rejected, opened and clicked, with ``payload`` and ``occurred_at``.\n        Open and click events require an HTML email body.\n        Returns ``items`` and ``next_cursor``, or an error.","read_only":true},{"name":"get_email_stats","title":"Get email stats","description":"Read workspace email delivery counts, rates and time series.\n\n        Without ``from_`` and ``to``, the range is the last seven days.\n        Hourly ranges are limited to eight days; all ranges to 92 days.\n        Returns ``from``, ``to``, ``bucket``, ``totals``, ``rates`` and ``series``.\n        Rates are null when the sent count is zero.\n        Open and click counts cover HTML emails only; plai","read_only":true},{"name":"get_events","title":"Get events","description":"Read a page of workspace events or events for one resource.\n\n        A call-specific response includes the current ``call_status``.\n        Terminal call states are completed, failed, busy, no_answer and canceled.\n        The response is a snapshot, not a streaming subscription.\n        Returns ``items``, ``next_cursor`` and optional ``call_status``, or an error.","read_only":true},{"name":"list_agents","title":"List agents","description":"List the workspace's saved agents and their settings.\n\n        Agent records contain IDs, names, instructions, greetings, disclosure settings,\n        voice settings, enabled channels, status, duration limits and handover contacts.\n        Returns ``items`` or an error.","read_only":true},{"name":"create_agent","title":"Create an agent","description":"Save an agent for calls, texts, and email replies.\n\n        A handover contact's phone number is hidden from the call agent.\n        Saving an agent does not change any phone number's routing.\n        Returns the saved agent record or an error.","read_only":false},{"name":"route_number","title":"Route a number to an agent","description":"Set the saved agents that answer a number's calls and texts.\n\n        Omitted settings retain their current values.\n        Returns the updated number record or an error.","read_only":false},{"name":"route_email_domain","title":"Route an email address to an agent","description":"Choose which agent answers mail to an address, and who it answers.\n\n        Setting ``email_agent_id`` together with ``clear_agent=True`` is an error.\n        With ``email_agent_scope=\"anyone\"``, a stranger can make the agent use its\n        allowed tools. Mail without a passing DMARC result gets no reply.\n        A custom domain must be verified with inbound and sending on.\n        A field left o","read_only":false},{"name":"quote_numbers","title":"Quote phone numbers","description":"Compare available phone numbers and their prices without buying or charging.\n\n        Returns ``offers``, ``recommended_quote_id`` and ``expires_at``.\n        Each offer includes ``e164``, ``number_type``, ``capabilities``, ``quote_id``,\n        ``monthly_cents``, ``setup_cents``, ``readiness``, ``requirements``,\n        ``subject_types``, ``verifications``, ``locality`` and ``region``.\n        Pr","read_only":true},{"name":"acquire_number","title":"Buy a phone number","description":"Buy a quoted phone number with explicit price confirmation.\n\n        This charges the setup fee and first month immediately, then renews monthly.\n        The purchase requires the user's authorization for that number and cost.\n        Expired or changed offers return 409 without authorizing a different price.\n        Each quote can buy at most one number.\n\n        A retry with the same quote and `","read_only":false},{"name":"list_numbers","title":"List phone numbers","description":"List dedicated workspace phone numbers, newest first.\n\n        Items include ID, E.164 number, country, type, capabilities, provisioning state and assigned agents.\n        Returns ``items`` and ``next_cursor``, or an error.","read_only":true},{"name":"list_number_regions","title":"List number search regions","description":"List US state and Canadian province codes supported by number searches.\n\n        Returns ``regions`` containing ``country_code``, ``code`` and ``name``.\n        These codes identify the optional region filter for a city search.\n        An upstream failure returns an error.","read_only":true},{"name":"get_number","title":"Get a number","description":"Read a workspace number's state, capabilities and assigned agents.\n\n        Returns the number record or an error.","read_only":true},{"name":"release_number","title":"Release a number","description":"Permanently release a phone number after explicit user authorization.\n\n        A mismatched ``confirm_e164`` returns an error without releasing anything.\n        Calls and texts to a released number stop. Recovery is not guaranteed.\n        Current and previous monthly fees remain due, without a refund.\n        Pending orders cannot be released and return 409.\n        A failed order was not purcha","read_only":false},{"name":"get_verification_requirements","title":"Get verification requirements","description":"Read a carrier's current registration fields, documents, address rules and fees.\n\n        The response's ``subject_types`` lists the applicant types the carrier accepts.\n        US local SMS registration uses ``purpose=\"sms\"``, country ``US`` and type ``local``.\n        Toll-free verification uses ``purpose=\"sms\"``, the number's country ``US`` or ``CA``,\n        type ``toll_free`` and its owned ``","read_only":true},{"name":"check_verification","title":"Check a verification","description":"Check a carrier registration form without filing anything.\n\n        Takes the same arguments as ``submit_verification`` except ``attest_authorized``.\n        Runs every check Hail can run before filing: purpose rules, credit (402),\n        the carrier's current form, duplicates (409), field lengths, each file\n        (type, size, and for ``upload_id`` that it is this workspace's verification\n     ","read_only":true},{"name":"check_verification_documents","title":"Read verification documents","description":"Read the files of a number verification form, before the form is filled or submitted.\n\n        Takes the arguments of ``check_verification``. ``fields`` and ``address``\n        may be empty or partial. An AI model reads each file.\n        Returns ``fields``, ``address`` and ``documents.<slot>.fields``: the values the\n        files show, by the form's own keys, to fill the form after the user confi","read_only":false},{"name":"submit_verification","title":"Submit a verification","description":"Submit authorized applicant details and documents for carrier registration.\n\n        Submission is irreversible once sent for review. Carriers retain submitted documents.\n        ``fields``, ``address``, ``documents`` and ``files`` follow the carrier's current requirements.\n        SMS campaign text requires user review and approval before submission.\n\n        ``purpose=\"number\"``: the balance mus","read_only":false},{"name":"resubmit_verification","title":"Fix and resubmit a verification","description":"File a rejected number registration again, with fixes, from what Hail kept.\n\n        Hail keeps a number registration's answers and files for 30 days after\n        submit (``kept_until``); ``get_sms_application`` returns the kept answers\n        and file names. Each argument given replaces its kept value; the rest\n        are reused. Country, number type and subject type stay as filed.\n\n        Ir","read_only":false},{"name":"list_verifications","title":"List verifications","description":"List workspace carrier registrations, newest first.\n\n        Items include IDs, applicant names and types, country, number type, purpose,\n        state, rejection details, timestamps, confirmation method and SMS progress fields.\n        States are awaiting_review, submitting, submitted, approved, rejected or cancelled.\n        SMS steps include confirm_identity, filing, carrier_review, needs_infor","read_only":true},{"name":"get_verification","title":"Get a verification","description":"Read one carrier registration's current state and reported next step.\n\n        The carrier state refreshes at most once per minute. Review can take business days.\n        ``step=\"needs_information\"`` means the existing SMS application needs corrections;\n        its saved applicant details and paid identity remain attached to the same registration.\n        An approved registration can make matching","read_only":true},{"name":"get_sms_application","title":"Read saved SMS application","description":"Read saved answers for an existing workspace registration.\n\n        Returns private applicant fields, address and available sender information.\n        An older application without saved answers returns 404.\n        A number registration (``purpose=\"number\"``) returns its kept answers,\n        ``documents`` and the kept ``files`` by name (without their bytes) until\n        ``kept_until``; ``resubm","read_only":true},{"name":"preview_sms_application","title":"Preview a US texting registration","description":"Preview local or toll-free SMS registration text without filing or charging.\n\n        The response contains the description, consent flow and samples for user review before submission.\n        Answers require actual applicant information and consent evidence.\n        Field or length errors appear in ``problems``.\n        Limits are 100 fields and 64 KiB of combined fields and address.\n        A su","read_only":true},{"name":"amend_sms_application","title":"Correct an existing SMS application","description":"Correct an existing SMS registration at the needs_information step.\n\n        The address must be accurate; saved details can be reused when still correct.\n        Identity changes are rejected. This operation does not create a replacement brand.\n        Actual consent evidence is required.\n        Limits are 100 fields and 64 KiB of combined fields and address. No documents are uploaded.\n        A","read_only":false},{"name":"cancel_verification","title":"Cancel a verification","description":"Cancel an eligible carrier registration after explicit user authorization.\n\n        Awaiting-review drafts are discarded; rejected registrations are dismissed.\n        A rejected registration must be dismissed before a new one is submitted\n        for the same country and number type.\n        An approved US SMS registration can be cancelled: attached numbers lose US texting eligibility\n        and","read_only":false},{"name":"confirm_verification","title":"Confirm a verification with a code","description":"Confirm a registration using the code the carrier sent to the applicant.\n\n        Incorrect or expired codes return a field error; the carrier can send a replacement after a day.\n        Success advances the registration but does not guarantee immediate approval.\n        A ``confirmation=\"reply\"`` registration requires a direct reply to the carrier's text instead.\n        Returns the updated regis","read_only":false},{"name":"get_agent","title":"Get an agent","description":"Read one saved workspace agent by ID.\n\n        Returns its name, instructions, greeting, disclosure, voice settings, enabled channels,\n        status, limits and other saved settings, or an error.","read_only":true},{"name":"update_agent","title":"Update an agent","description":"Update selected fields on a saved workspace agent.\n\n        Omitted fields retain their values. Repeating the same update gives the same result.\n        Changing only language or voice preserves the other value.\n        A field cannot be both set and cleared in the same request.\n        Removing a greeting makes an inbound agent wait for the caller.\n        Other resets restore workspace defaults;","read_only":false},{"name":"delete_agent","title":"Delete an agent","description":"Permanently delete a saved agent after explicit user authorization.\n\n        A mismatched ``confirm_name`` returns an error without deleting anything.\n        Numbers assigned to the deleted agent stop answering calls with it;\n        texts are delivered to webhooks only.\n        Pausing an agent is a separate non-deleting status change.\n        Returns ``deleted``, ``agent_id`` and ``name``, or a","read_only":false},{"name":"list_contacts","title":"List contacts","description":"List workspace members and manually saved contacts.\n\n        Returns ``items`` with ID, kind, name, phone_e164, email and role.\n        Members have ``kind=\"member\"``, an ID of ``member:<user_id>`` and a role.\n        Manual entries have ``kind=\"manual\"``, a UUID and no role.","read_only":true},{"name":"lookup_contact","title":"Look up a contact","description":"Find workspace contacts by name, email or phone fragment.\n\n        Returns up to ten matches containing names, phone numbers, email addresses and IDs.\n        Several matches can refer to different people.","read_only":true},{"name":"list_email_domains","title":"List email domains","description":"List the workspace's sending identities and default sender address.\n\n        Returns ``items``, ``next_cursor`` and ``default_from``.\n        Only identities with ``verification_status=\"verified\"`` can send.\n        For ``kind=\"custom\"``, ``domain`` is a domain supporting any local part.\n        For ``kind=\"hail_mail\"``, it is already a complete email address.\n        One verified custom domain ta","read_only":true},{"name":"whoami","title":"Who am I","description":"Identify the account and organization authorized by the current credentials.\n\n        Returns ``auth_kind``, ``organization_id``, ``user_id``, ``email`` and ``name``.\n        Shared operator credentials have ``auth_kind=\"shared\"`` with null user details.\n        The response identifies the current actor, not a message recipient.","read_only":true},{"name":"create_contact","title":"Create a contact","description":"Save a workspace contact with a name and a phone number or email address.\n\n        A duplicate phone or email returns 409.\n        Returns the new contact record or an error.","read_only":false}],"server_info":{"description":"Phone numbers, voice calls, text messages and email for AI agents. Place and answer calls, send and receive texts and mail, and buy numbers.","icons":[{"src":"https://mcp.hail.so/favicon.ico"},{"mimeType":"image/svg+xml","sizes":["any"],"src":"https://mcp.hail.so/icon.svg"}],"name":"hail","title":"Hail","version":"0.2.0","websiteUrl":"https://hail.so/mcp"},"category":"communication","tags":["agents","productivity","travel"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-07","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-hail-hq-hail-mcp/"}