update_voice_settings

writes

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

What it does

Change how the business sounds on the phone. Send ONLY what the human asked to change; omitted fields are left alone, and an empty string CLEARS a field back to its default rather than storing a blank. ⚠️ agent_greeting is spoken WORD FOR WORD on inbound calls and replaces the shipped opener entirely - so a greeting written as 'Good morning' will still say good morning at midnight, while leaving it unset gets the time of day right in the caller's language automatically. Only set one if the operator dictated the sentence. Write {name} where the business name should go. voice_id must be an id from list_voice_options, or null to go back to routing the voice by the caller's language.

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

Parameters

business_idstringrequired

The id returned by list_businesses.

agent_namestringoptional

What the AI calls itself, e.g. 'Rina'. '' clears it.

agent_rolestringoptional

How it describes its job, e.g. 'front desk'. Short - it is a role, not a script. '' clears it.

agent_greetingstringoptional

Inbound opening line, spoken verbatim. '' clears it back to the shipped time-of-day greeting.

voice_idstring | nulloptional

An id from list_voice_options, or null for language routing.

voice_cuesstringoptional

Little spoken acknowledgements while the caller talks. 'backchannel' is the usual setting.

one of: off · backchannel · all

voice_interrupt_msnumber | nulloptional

How long the caller must speak before the AI stops talking, 0-2000. LOWER interrupts sooner. Raise it if a noisy line keeps cutting the AI off; lower it if callers complain it talks over them. Null uses the tested default.

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": "update_voice_settings",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "agent_name": "Rina",
        "agent_role": "front desk"
      }
    }
  }'