add_do_not_call

writes

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

What it does

Stop this business calling a number. Takes effect immediately and also parks anything already queued for it, so the person is actually protected rather than merely recorded. Adding a number that is already on the list is fine and re-instates it if it had been lifted - somebody reaching for this is trying to stop a call, and a race must not answer no. Use source 'complaint' when they complained, and then a note is required. You CANNOT record 'refused' here: that one is only born from a call where they said so, and writing it by hand would forge the provenance of the one entry with legal weight. Removing a number from this list is not available to assistants at all.

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

Parameters

business_idstringrequired

The id returned by list_businesses.

phonestringrequired

As the operator has it, any format.

dial_codestringrequired

Country dial code for that number, e.g. '+62'.

sourcestringoptional

Why it went on the list. 'manual' is a plain request not to be called. 'complaint' records that the person objected, and REQUIRES a note - the call refuses without one. There is no third value you can write: a refusal spoken during a call is recorded by the call itself, because writing it by hand would forge the provenance of the one entry here that carries legal weight. Default 'manual'.

one of: manual · complaint

notestringoptional

Required when source is 'complaint'.

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": "add_do_not_call",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "phone": "0812 3456 7890",
        "dial_code": "+62",
        "source": "complaint",
        "note": "asked us to stop calling"
      }
    }
  }'