list_open_slots

reads

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

What it does

The appointment times still open for one bookable type on one date, already accounting for existing bookings, buffers and the business's own opening hours. Use this before offering a customer a time - never infer availability from a booking list, which cannot see hours or buffers. `configured: false` means the business has not set opening hours for that type: that is 'no hours are set up', NOT 'fully booked', and the two must never be reported as the same thing. Times come back as instants; render them in the business's timezone (get_business.timezone).

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

Parameters

business_idstringrequired

The id returned by list_businesses.

bookable_type_idstringrequired

From list_bookable_types.

datestringrequired

The day to look at, YYYY-MM-DD, in the business timezone.

team_member_idstringoptional

Optional. Only slots for this one team member, when the business books people rather than spaces.

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": "list_open_slots",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "bookable_type_id": "rt_haircut",
        "date": "2026-08-20"
      }
    }
  }'