create_bookable_type

writes

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

What it does

Add one bookable type. Only write what the human told you - name and price come from them. kind: 'day' for per-night/per-day (hotel room, rental car), 'time' for appointment slots (haircut, treatment); omit it and the business's own default applies. price is the base rate, price_max the top of the range when rates vary; both whole numbers in the business's own currency. A same-name twin is refused with the existing id. Appointment hours and slot lengths are set afterwards with set_bookable_type_schedule. THEN CALL create_units, always: availability is counted from units, not from this type, so a type with no units is never offered to a customer and every booking attempt finds nothing free. One unit means one booking at a time. Photos are dashboard-only.

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

Parameters

business_idstringrequired

The id returned by list_businesses.

namestringrequired

The type name as customers know it. Max 160 chars.

priceintegeroptional

Base rate, whole number in the business's own currency.

price_maxintegeroptional

Top of the rate range when it varies by date.

sleepsintegeroptional

Maximum people it fits. Omit when unknown - never guess.

descriptionstringoptional

What it is, as read to customers. Max 2000 chars.

bed_configstringoptional

E.g. '1 king' or '2 twin'. Rooms only.

viewstringoptional

E.g. 'garden', 'sea'. Max 120 chars.

amenitiesarrayoptional

Free-form tags. Max 40.

kindstringoptional

'day' = per-night, 'time' = appointment slots.

one of: day · time

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": "create_bookable_type",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "name": "Haircut - classic",
        "price": 75000,
        "kind": "time"
      }
    }
  }'