list_bookings

reads

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

What it does

Bookings for one business, pending holds first. Default shows only actionable states (pending, confirmed, checked in); status 'all' includes cancelled, expired and completed. query substring-matches the customer's name, phone or email - use it to find 'the booking under Wijaya' before confirming or cancelling anything. Each row carries the customer, the dates or slot, the money (totalOwed = base + extras), and its id for the transition tools. Times are UTC; capped at 500 rows.

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

Parameters

business_idstringrequired

The id returned by list_businesses.

statusstringoptional

Default 'open' - the actionable states only.

one of: open · all

querystringoptional

Substring of the customer name, phone or email.

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_bookings",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "query": "Wijaya"
      }
    }
  }'