set_bookable_type_schedule

writes

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

What it does

Configure how one type is booked: kind ('day' per-night or 'time' appointment slots), slot length, service duration, turnaround buffer, minimum lead time, and weekly open hours. Hours use day keys mon..sun, each {open:'09:00', close:'18:00'}; a day absent from open_hours is CLOSED, and an empty open_hours means no slots are offered at all. Changing kind changes how availability is computed - confirm with the human first.

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

Parameters

business_idstringrequired

The id returned by list_businesses.

type_idstringrequired

From list_bookable_types.

kindstringoptional

'day' books whole days or nights, e.g. a hotel room or a rental car. 'time' books a slot inside opening hours, e.g. a haircut or a treatment. This decides which of the other fields apply. Omit to leave it unchanged.

one of: day · time

slot_minutesintegeroptional

Gap between offered start times, 5-1440.

duration_minutesintegeroptional

How long one booking takes, 5-1440.

buffer_minutesintegeroptional

Turnaround after each booking, 0-1440.

lead_minutesintegeroptional

Earliest a caller may book from now, minutes.

open_hoursobjectoptional

Weekly hours: { mon: {open:'09:00', close:'18:00'}, ... }. Absent day = closed.

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": "set_bookable_type_schedule",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "type_id": "f81b…",
        "slot_minutes": 30,
        "duration_minutes": 45,
        "open_hours": {
          "tue": {
            "open": "10:00",
            "close": "19:00"
          },
          "sat": {
            "open": "09:00",
            "close": "15:00"
          }
        }
      }
    }
  }'