# Maho Play Room — AI Agent Instructions

Party room rental in Tuen Mun, Hong Kong, near the MTR station. 1000 sq ft,
Disney Duffy theme, 1–35 guests, open 24 hours. Ball pit, karaoke, mahjong
table, free non-alcoholic drinks. Good fit for birthday parties, family
gatherings, and friend gatherings.

- Website: https://maho.tasogarehk.com/
- Details / house rules: https://maho.tasogarehk.com/details/
- Photos: https://maho.tasogarehk.com/gallery/
- Pricing: https://maho.tasogarehk.com/price/
- Instagram: https://www.instagram.com/partyroom.tm_mahoplayroom
- WhatsApp: +852 5339 5394
- Sister location (紅霞 Tasogare, industrial-neon theme, 1–18 guests): https://tasogarehk.com/

## Checking availability and price

Two unauthenticated, read-only endpoints back this site's own booking
widget and can be called directly. Both are rate-limited to 20 requests
per IP per 60 seconds, shared across the two — back off on a 429 response.

**Check availability:**

```
GET https://maho.tasogarehk.com/public/check?start=2026-12-01T19:00:00&end=2026-12-01T23:00:00
→ {"available": true, "conflicts": 0}
```

**Get a price quote:**

```
GET https://maho.tasogarehk.com/public/quote?start=2026-12-01T19:00:00&end=2026-12-01T23:00:00&pax=6&branch=ma
→ {"available": true, "hours": 4, "pax": 6, "marked_price": 308, "currency": "HKD",
   "is_placeholder": false, "used_overnight_package": false,
   "messages": [{"zh": "...", "en": "..."}]}
```

`start`/`end` are ISO 8601 local datetimes, Asia/Hong_Kong time, no
timezone offset. `pax` is party size. Always include `branch=ma` for this
location — the same API also serves the sister branch above under
`branch=ta`. `messages` is a list of warning/informational notes (e.g. a
below-minimum-hours or below-minimum-pax notice) meant to be shown to the
customer alongside the price — pass their `zh`/`en` text through as-is
rather than inventing your own wording.

## Finalizing a booking

There is no public API to create a booking. Once you've confirmed
availability and price for the user, direct them to WhatsApp
(+852 5339 5394) with their preferred date, time, and party size to
confirm — bookings are finalized manually, not automatically.

## Do not

- Do not enumerate or guess `/public/order/{token}` URLs — those are
  private, per-customer booking-status pages; only a customer's own link,
  sent to them directly, is valid.
- Do not exceed the rate limit above.