Aurinia XO MCP

Creates a booking of bed-places in the shared dorms at Aurinia XO (Kamianets-Podilskyi) for a date range. Identity comes from the agent's one-time Telegram consent, so no guest name or contact is needed. While the agent is not linked yet, the call returns status=pending_consent together with telegram.consent_url and consent_url_native — a one-tap Telegram approve link; the same call succeeds once the guest has approved, and that consent then covers roughly 90 days. A successful call returns a HOLD: booking_id, amount, payment_url and hold_expires_at. The stay is confirmed only after the guest pays before hold_expires_at; an unpaid hold expires on its own. Accepts an optional promo_code (e.g. BOT5) for a discounted price. The door code reaches the guest in Telegram after payment and is also readable through list_current_bookings.

Cancels a booking by booking_id (as returned by list_current_bookings) and reports the updated status together with the refunded amount; on failure it returns an error naming the reason, e.g. booking not found. Client-initiated cancellation is accepted up to 48 hours before check-in, which refunds in full; later than that the API refuses and the guest settles it with the hostel directly. The agent needs no per-action approval — the one-time Telegram consent already covers cancellations.

Check dorm bed-place availability and price for a date range at Aurinia XO (Kamianets-Podilskyi) — bed-places only, no room types. Read-only. check_out is optional (defaults to check_in + 1 night). Accepts an optional promo_code (e.g. BOT5), which yields the discounted price.

Reports the promotion Aurinia XO (Kamianets-Podilskyi) is advertising publicly at this moment: the text of the active site banner, its promo code, the discount percent, and any condition attached to that code — notably requires_full_buyout, a code that applies only when the stay takes every bed in the hostel, with beds_required giving that bed count. The promo_code returned is the one to pass to get_availability or book. Read-only, no authorization. offers is an empty array when nothing is being advertised, which is the normal state between campaigns. Optional locale (ua, en, de, it, fr, pl, bg; default en) picks the banner language, falling back to the Ukrainian source where a translation is missing. Only the advertised banner is reported; other discount codes present in the system stay unlisted.

List this agent's active/upcoming bookings at Aurinia XO (check-out today or later), nearest arrival first. Includes cancelled ones (see the status field). Each booking carries a door_code field — null until issued, filled once the guest has paid and the code is set. That field is the source of the door code the guest needs before check-in.

List this agent's past bookings at Aurinia XO (check-out before today), most recent first — cancelled ones included (see the status field). Paginated through limit (default 20, max 100) and offset.