connect_phone_number

writes

One of the tools an AI assistant can call on an Avrosh account.

What it does

Point a number the business ALREADY OWNS at this assistant. It does not buy a number and does not talk to a carrier: it records the number here and hands back the webhook URL, which somebody still has to paste into the carrier's own settings before the line rings. Give it in full international form (+12015551234). Refused if that number is already live on another business, because an incoming call must resolve to exactly one.

This is the exact text the model reads before deciding to call.

Parameters

business_idstringrequired

The id returned by list_businesses.

e164stringrequired

Full international form, e.g. +12015551234.

greeting_languagestringoptional

Optional two-letter code the greeting opens in, e.g. 'id'. Defaults to the business language.

Response

The result arrives as an MCP content block; the JSON in the panel is what the text field parses to.

Connecting

Point any MCP client at https://us.avrosh.com/mcp and log in — OAuth 2.1, no key to paste.

The panel here uses the other door: a bearer key made in the dashboard, for a script or a cron job with no browser to sign in with. Both reach the same endpoint. Full notes on the reference overview.

curl -X POST https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "connect_phone_number",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "e164": "+12015551234"
      }
    }
  }'