AiR by Lexvor

Connect any AI tool to your AiR

AiR speaks MCP, the standard protocol Claude, ChatGPT, Claude Code, Codex, Gemini, Cursor and other AI tools use to connect to outside services. Connect your tool and it can look up your contacts, check your schedule and set reminders, and, once you allow it, send texts and have AiR place calls for you.

Using Claude or ChatGPT and not a developer? Read the step-by-step guide.

  1. 1. Add AiR to your tool

    In Claude or ChatGPT, add a connector with the address below and sign in to AiR when asked. You approve access in your browser; there is no key to copy.

    https://useair.net/api/v1/mcp

    Command-line tools can sign in the same way, or use a key. To use a key, sign in to AiR and create one with the Tools (MCP) scope (you see the secret once), then run the command for your tool with your key in place of YOUR_KEY.

    Create a key

    Claude Code

    claude mcp add --transport http air https://useair.net/api/v1/mcp \
  --header "Authorization: Bearer YOUR_KEY"

    Codex

    export AIR_MCP_TOKEN="YOUR_KEY"
codex mcp add air --url https://useair.net/api/v1/mcp \
  --bearer-token-env-var AIR_MCP_TOKEN

    Gemini CLI

    gemini mcp add air https://useair.net/api/v1/mcp \
  --transport http --header "Authorization: Bearer YOUR_KEY"

    Cursor or any other MCP client

    {
  "mcpServers": {
    "air": {
      "type": "http",
      "url": "https://useair.net/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

  2. 2. Choose what it may do

    Each group of tools below follows one switch under Agents settings for apps and outside agents. A tool whose switch is off is not offered at all.

    Look up & save shared details

    • find_contact: find a saved contact by name, relationship, number or email.
    • add_contact: save a new contact.

    Check your availability

    • check_schedule: your events, reminders and deadlines on a date.

    Set reminders & to-dos

    • create_reminder: a reminder that texts or calls you at a time you choose.
    • list_reminders: your upcoming reminders and scheduled calls.
    • cancel_reminder: stop a reminder or scheduled call.

    Read & send texts through AiR

    Off until you turn it on. Sends real texts.

    • send_sms: send a text from AiR's number.
    • read_messages: recent texts and call notes AiR exchanged with one number.
    • get_my_line_usage: your AiR lines, their status, data used and left, reset day and next renewal date.
    • get_trip_readiness: will my phone work on my trip? Line status, travel data left, your last phone check and steps.
    • check_number: is this call or text a scam? Line type, caller ID, what AiR has seen and warning signs.
    • notify_me: text or call your own phone: "call me when the build finishes".
    • ask_me: text you a question (yes or no, or your own choices) and wait for your reply.
    • get_reply: check whether you have answered a question ask_me sent.

    Place calls & see your call history

    Off until you turn it on. Places real calls.

    • make_call: AiR calls a saved contact or a verified business and works toward your goal.
    • hold_and_connect: AiR waits on hold with a company and rings you when a person answers.
    • schedule_call: AiR calls a saved contact at a later time.
    • find_business_number: a business's listed number from Google Maps, checked so AiR can call it.
    • list_recent_calls: calls AiR placed for you and calls its screening answered.
    • get_call_result: the outcome and summary of a call AiR placed.

  3. 3. Use it

    Ask in your own words, for example "who called my AiR line today?" or "remind me at 7:30 tomorrow to leave for the airport". Your tool asks you to approve every call and text before it goes out.

For Claude Code and Codex

Your phone as your coding agent's pager

With texts on, your agent can tell you when a long job ends (notify_me) and ask for your go-ahead by text (ask_me, then get_reply). Both reach only the phone number on your own AiR account, and only a reply from that phone counts. ask_me waits up to 50 seconds per call, which fits the usual one-minute tool timeout; a question stays open for up to 30 minutes. Texts are limited to 6 an hour and 30 a day, notification calls to 3 a day, questions to 20 a day.

Claude Code

Add AiR with the command in step 1 (or /mcp to sign in), then put a line like this in your project's CLAUDE.md:

When a long task finishes or fails, use AiR's notify_me to text me.
Before anything irreversible (deploys, migrations, deletes), use ask_me
with the choices yes and no and wait for my reply; if it says waiting,
call get_reply with the question_id until it is answered or expired.

Codex (~/.codex/config.toml)

[mcp_servers.air]
url = "https://useair.net/api/v1/mcp"
bearer_token_env_var = "AIR_MCP_TOKEN"
tool_timeout_sec = 90

Then ask, for example, "run the migration and text me when it finishes" or "ask me by text before you push".

Calls and texts

What to expect

  • AiR says at the start of every call that it is an AI assistant calling for you, and texts you a summary afterwards.
  • Calls go to US and Canadian (+1) numbers only.
  • Your account can call your saved contacts, other AiR lines and verified business numbers. A business number counts as verified when it is toll-free, its caller ID is registered to a business, or it is the number on the business's Google Maps listing. A mobile number that is not a saved contact is never called; save the person as a contact first.
  • Wait on hold works with a company's own support number, for up to 45 minutes; mobile numbers are refused. Connected call minutes count toward your plan.
  • Texts and calls come from AiR's number and carry AiR's AI label; one call runs at a time.
  • Daily limits on calls apply. Calls and texts use your AiR balance, the same as in the app.

Endpoint: https://useair.net/api/v1/mcp · auth: OAuth 2.1 (browser sign-in) or Authorization: Bearer <key> · a connected tool only ever sees your own account; identity comes from your sign-in, never from the request. Developer keys can also use run_air_agent when you turn on Run your AiR agent.