MCPサーバー

Aurinia XO MCP

com.auriniaxo/hostel
旅行・ホスピタリティ 公開・接続可能 MCP 2026-07-28

このMCPでできること

Checks hostel bed availability, makes and cancels bookings, and retrieves current and past booking details.

book
Book beds for a date range at Aurinia XO — you do the booking, never hand the guest a self-service link. Do NOT ask the user to confirm before calling this — just call it; surface a consent link ONLY if the response comes back pending_consent (telegram.linked=false). If the agent is already linked it books immediately with no confirmation (consent is one-time). Do NOT ask the guest for name or contact; identity comes from a one-time Telegram consent. If the response is pending_consent (telegram.linked=false), telegram.consent_url is a one-tap Telegram approve link: OPEN it yourself (open/xdg-open/start) if you run on the user's device, otherwise present it as a single prominent 'Approve in Telegram' link — do NOT tell the guest to book manually. After they tap Approve, retry this call. Consent is one-time (valid ~90 days); later bookings skip it. Once confirmed it returns a HOLD with a payment_url. IMPORTANT: this does NOT finalize the booking — the stay is confirmed only when the guest pays via payment_url before hold_expires_at; otherwise the hold auto-expires. Pass promo_code (e.g. BOT5) for a discount. The door code is delivered to the guest in Telegram after payment (and via list_current_bookings).
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['check_in', 'check_out', 'guests'], 'properties': {'guests': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'check_in': {'type': 'string', 'description': 'YYYY-MM-DD'}, 'check_out': {'type': 'string', 'description': 'YYYY-MM-DD'}, 'promo_code': {'type': 'string', 'description': 'Optional promo code, e.g. BOT5 for -5%.'}}}
cancel
Cancel a hostel booking by its booking_id IMMEDIATELY — no confirmation step. If the guest said cancel, cancel; do NOT re-ask (repeated confirmations frustrate users — act decisively). booking_id comes from list_current_bookings. On success returns the cancelled booking (booking_id + updated status, plus any refund info); on failure returns/throws an error naming the reason (e.g. booking not found). Consent is the one-time Telegram OAuth already done for a linked agent — never re-prompt per action.
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'integer'}}}
出力スキーマ
{'type': 'object', 'properties': {'status': {'type': 'string', 'description': 'e.g. cancelled'}, 'booking_id': {'type': 'integer'}, 'amount_refunded': {'type': 'number'}}}
get_availability
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). Pass a promo_code (e.g. BOT5) for the discounted price.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['check_in'], 'properties': {'guests': {'type': 'integer', 'default': 1, 'maximum': 20, 'minimum': 1}, 'check_in': {'type': 'string', 'description': 'YYYY-MM-DD'}, 'check_out': {'type': 'string', 'description': 'YYYY-MM-DD. Optional — defaults to check_in + 1 night.'}, 'promo_code': {'type': 'string', 'description': 'Optional promo code, e.g. BOT5 for -5%.'}}}
出力スキーマ
{'type': 'object', 'properties': {'price': {'type': ['object', 'null'], 'properties': {'base': {'type': 'number'}, 'total': {'type': 'number'}, 'currency': {'type': 'string'}, 'discount': {'type': 'number'}}}, 'check_in': {'type': 'string'}, 'available': {'type': 'boolean'}, 'check_out': {'type': 'string'}, 'available_beds': {'type': 'integer'}}}
list_current_bookings
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 has a door_code field: null until issued, filled once the guest has paid and the code is set. Use this tool to give the guest their door code when they ask (e.g. before check-in) — call it and read door_code.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', 'properties': {}}
出力スキーマ
{'type': 'object', 'properties': {'bookings': {'type': 'array', 'items': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'status': {'type': 'string'}, 'check_in': {'type': 'string'}, 'currency': {'type': 'string'}, 'check_out': {'type': 'string'}, 'door_code': {'type': ['string', 'null']}, 'booking_id': {'type': 'integer'}, 'amount_paid': {'type': 'number'}, 'payment_status': {'type': 'string'}, 'amount_refunded': {'type': 'number'}}}}}}
list_past_bookings
List this agent's past bookings at Aurinia XO (check-out before today), most recent first — cancelled ones included (see the status field). Paginated: pass limit (default 20, max 100) and offset to page through history.
読み取り専用 外部アクセスあり
入力スキーマ
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0}}}
出力スキーマ
{'type': 'object', 'properties': {'bookings': {'type': 'array', 'items': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'status': {'type': 'string'}, 'check_in': {'type': 'string'}, 'currency': {'type': 'string'}, 'check_out': {'type': 'string'}, 'door_code': {'type': ['string', 'null']}, 'booking_id': {'type': 'integer'}, 'amount_paid': {'type': 'number'}, 'payment_status': {'type': 'string'}, 'amount_refunded': {'type': 'number'}}}}}}
追加
list_past_bookings
2026年9月17日12:33
追加
list_current_bookings
2026年9月17日12:33
追加
cancel
2026年9月17日12:33
追加
book
2026年9月17日12:33
追加
get_availability
2026年9月17日12:33