MCP App Store
by KeenEthics
LuxHotel System icon

LuxHotel System MCP Server for ChatGPT

By Bluesquare AI

Overview

Connect ChatGPT to LuxHotel System to manage your hotel in plain language. Read arrivals, departures, in-house guests, bookings, availability, rates, guest profiles, occupancy, revenue, transaction reports, guest conversations, housekeeping and room services. Prepare direct bookings individually or in batches, guest messages individually or in batches, booking updates, check-in and check-out, room assignments, housekeeping actions, rate changes, stop-sell and availability changes. Every write returns an expiring preview. Changes run only after you explicitly approve that preview and the connector confirms it. Confirmations expire after 10 minutes and execute at most once. Guest profiles are limited to guests with at least one booking at the connected property. Staff lookup returns business-wide active staff names, roles and work email addresses to identify payment collectors. An active paid LuxHotel System account is required. Only a business owner can authorize an OAuth connection. The owner chooses one property and read-only, actions, or actions plus inventory permissions. Disconnect at any time in Settings → AI Integrations (MCP). Payment links open external POK checkout and are not sent to guests automatically. Recording a payment only records money already received; it does not charge a card. Recorded payments await manager approval but already count toward the booking’s paid amount. No payments are collected inside ChatGPT. Use your preferred language in chat.

How to connect

  1. ChatGPT: Open the LuxHotel System listing in the ChatGPT app directory and choose Connect. ChatGPT listing LuxHotel System exposes 36 tools here.

Tools

add_booking_note

ChatGPT
Add (append, default) or replace the staff-only internal note of a booking. Works for every booking, including OTA ones (the note stays in LuxHotel and is never sent to the channel or the guest). Staff are notified like when a note is saved in the app. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

assign_room

ChatGPT
Put a booking (or one room of a multi-room booking) into a specific physical room, e.g. room "204". The room must be active, of the same room type as the booked room, and free for the whole stay. The room type is never changed. Works for direct and OTA bookings, also during the stay (room move). The assignment is marked manual, so automatic room assignment won't move it afterwards. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

block_room

ChatGPT
Take one physical room out of order for a period (repair, deep cleaning…). The room must be free for those dates. One room of its type is removed from availability on all channels for every blocked night. date_to is the first day the room is usable again. Call once per room. Remove a block with unblock_room. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

cancel_booking

ChatGPT
Cancel a DIRECT booking (walk-in, phone, website widget) that is new, confirmed or modified. Frees the room nights; availability is updated on all channels automatically. OTA bookings (Booking.com, Expedia… via the channel manager) are refused — they must be cancelled at the OTA. Payments are not refunded automatically and transactions are not changed. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

check_availability

ChatGPT
Check whether a property can host a party for specific dates and what it costs. Use it when staff ask "do we have a room for 2 adults from X to Y?" or "how much is a double for 3 nights?". Returns, per room type that fits the party: free units (minimum over the nights) and every active rate plan with total price, nightly prices and currency — or the reasons it can't be booked (stop_sell, closed_to_arrival, closed_to_departure, min_stay_arrival, min_stay_through, max_stay, insufficient_availability, no_price). Room types too small for the party are listed separately. Prices are the hotel's own rates (same calculation as the booking widget) without widget promotional offers. adults/children are per room. Max 30 nights. Cannot create bookings or change rates, restrictions or availability.

check_in

ChatGPT
Check in a guest whose booking is new, confirmed or modified and whose arrival date is today or earlier (property time zone). Works for direct and OTA bookings. Does not record a payment: if the guest checks in without paying, pass no_payment=true (flags the booking as "checked in without payment", like the app's skip-payment option); to take a payment use record_payment. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

check_out

ChatGPT
Check out a checked-in guest. Before the departure date this is an early checkout: today (property time zone) is stored as the actual checkout date, the booked departure date stays unchanged and the remaining nights are released on all channels. Works for direct and OTA bookings. Does not record payments — the preview warns about any unpaid balance. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

complete_room_service

ChatGPT
Mark a pending room service request as done, like ticking it on the Housekeeping page. Get the request ID from list_room_services. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

confirm_action

ChatGPT
Execute a change previewed by a write tool (create_booking, check_in, record_payment…). Call it ONLY after the user explicitly approved the summary returned with that confirmation_id. Confirmations expire after 10 minutes and run at most once; calling again with the same ID returns the original result.

create_booking

ChatGPT
Create a direct (walk-in / phone / email) booking at a property — the same as 'New booking' in the LuxHotel app. The price is calculated by the server from the hotel's rates (same as check_availability); pass agreed_total only when the guest agreed a different total. Availability and rate restrictions are checked. Inventory and channel (OTA) availability update automatically and a physical room is auto-assigned. Use check_availability first to pick room_type_id / rate_plan_id. adults/children are per room. Max 30 nights, 10 rooms. Cannot create OTA bookings or out-of-order blocks. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

create_bookings

ChatGPT
Create several direct bookings at once (2–10), with ONE confirmation — e.g. a group of separate guests, or the same guest on different dates. Each item has the same fields as create_booking. Bookings are created one after another and each re-checks availability, so if rooms run out the later ones fail and are reported. For one booking with several rooms, use create_booking with several rooms instead. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

create_room_service

ChatGPT
Create a room service request for a booking's room — cleaning, towels, amenities or other — like 'Shërbim' in the app (it appears on the Housekeeping page and in the booking). Scheduled for today by default, or up to 2 days ahead. Only for upcoming or in-house bookings. For multi-room bookings pass room_number; otherwise the first room is used. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

create_transaction

ChatGPT
Record a standalone INCOME or EXPENSE that is not a booking payment, like 'New transaction' on the Transactions page — e.g. a supplier invoice, electricity bill, salary, bar or restaurant sale, minibar, laundry. For money a guest paid towards a booking use record_payment instead (so the booking shows as paid). category must be one of the property's financial categories and payment_method one of its accounts; an unknown value returns the list. Amounts are in EUR; pass currency 'ALL' for lekë (converted with the property's rate). Saved as 'pending' for a manager to approve; set approve=true to save it approved (only if the user's role may approve transactions). Set paid=false for a bill that is not paid yet. Does NOT fiscalize (BlueBill). Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

get_booking

ChatGPT
Get the full detail of one booking: guest contact, dates, nights, arrival time, status, channel and OTA references, each room (room type and rate plan names, occupancy, guest names, assigned room number, amount), totals (total, paid, balance due, payment status, currency, OTA commission), services, notes, created/updated times and the latest 20 activity-log entries (who changed what). Accepts the booking ID or an OTA reservation code / ota_unique_id / Channex ID. Never returns card data beyond brand and last 4 digits. Cannot modify, check in/out or cancel bookings.

get_calendar

ChatGPT
Get the day-by-day inventory and rate grid (like the dashboard's Inventory page) for a date range of up to 62 days. Use it to see occupancy over a period, find open/closed dates or read restrictions. Returns per room type per date: total units, booked, available (plus manually_overridden / no_data flags); and per active rate plan per date: the base (primary occupancy) nightly rate and restrictions — stop_sell (including inherited from a parent plan), min_stay_arrival, min_stay_through, max_stay, closed_to_arrival, closed_to_departure. Default/false restriction fields are omitted. For the price of a specific stay and party use check_availability. Cannot change rates, restrictions or availability.

get_cash_summary

ChatGPT
The cash register ('Arka') view for one day or a date range: money in and out per payment method/account (approved vs. awaiting approval, plus transfers between accounts), income vs. expense totals and net, income actually collected, and ALL transactions currently awaiting approval (any date, grouped by the staff member who recorded them, like the Arka page shift close). Unpaid POK payment links are listed separately — they are not collected money. Amounts in EUR. Defaults to today. Does not return all-time account balances. Cannot record, approve, close a shift or refund payments.

get_customer

ChatGPT
Get one guest profile (contact details, company, category, notes — never ID-document or tax numbers) plus their bookings at this property (summaries, newest first) and totals: stays, nights and revenue (cancelled, no-show, spam and blocks excluded), cancellations, no-shows, first/last stay and upcoming bookings. Use search_customers to find the customer ID. Cannot edit customers or bookings.

get_housekeeping_status

ChatGPT
Room-by-room housekeeping board for TODAY (property timezone): every physical room with number, floor, room type, cleaning status (clean / dirty / out_of_service / inspected, from the room record), whether it is out of service, who is in the room today (guest, departure date, checked-in flag), who departs today and who arrives today. For rooms with a departure today it also returns the checkout-cleaning status from the Housekeeping page (clean/dirty, who cleaned it, staff comments). Use it for questions like 'which rooms are dirty', 'what is ready for arrivals'. Only today is supported. It cannot change room status or assign rooms.

get_message_thread

ChatGPT
Get one guest conversation with its messages, newest first (paginate with cursor for older ones; up to the 300 most recent), each with sender (guest / property / system), text, time, delivery status (sent / sending / failed) and attachment URLs, plus the linked booking. Long messages are truncated to 2000 characters and card numbers are removed. Reflects the last sync into the PMS — it does not fetch from the channel manager. To reply, use send_guest_message.

get_occupancy_stats

ChatGPT
Hotel performance KPIs for a stay period (nights from date_from up to but excluding date_to, max 366 nights), computed from bookings with the same rules as the app's Reports page: occupancy %, room nights sold, ADR, RevPAR, room revenue (booking amounts prorated to the nights inside the period), number of bookings staying, arrivals, cancellations and no-shows (by arrival date), average length of stay, average lead time and channel mix by OTA. Cancelled, no-show, spam and out-of-order blocks are not counted as sold. Includes a daily occupancy series for periods up to 62 nights. Use get_revenue_report for payments/transactions. Cannot change bookings, rates or availability.

get_property

ChatGPT
Get a property's setup: contact details, check-in/check-out times, room types (with room counts and max occupancy), rate plans (with the room type they belong to and base price) and physical rooms (number, floor, type, cleaning status). Use it to translate room-type or rate-plan IDs into names before answering the user.

get_revenue_report

ChatGPT
Financial report from transactions for a period (max 366 days, date_to inclusive), using the same rules as the app's Reports page: income and expenses split into approved and pending, rejected/void and unpaid entries excluded (unpaid shown separately), transfers between accounts reported separately and never counted as income/expense. Breaks down by category, payment method and day (daily series = approved only, as in the Reports charts). Amounts in EUR. For booking-based room revenue, ADR or occupancy use get_occupancy_stats. Cannot record, approve or refund payments.

get_review

ChatGPT
One guest review with its full text, all category scores, Airbnb tags, the reply (if any) and the reply deadline.

get_today

ChatGPT
Front-desk overview for one date (default: today in the property's timezone), computed like the PMS dashboard: arrivals (expected check-ins, including ones already checked in), departures (pending check-outs) and departed (already checked out that day, including early check-outs), in-house guests (staying over that date, departure day included), no-show candidates (past arrival date but never checked in), no-shows already marked and not yet reported to the OTA, and occupancy (rooms booked / total rooms). Out-of-order blocks and spam are excluded. Best for today or nearby dates: statuses are current, not historical. Cannot check guests in/out or change bookings.

list_message_threads

ChatGPT
List guest conversations (OTA messages from Booking.com, Airbnb, etc. via the channel manager), most recent first, with title, channel, open/closed, unread and needs-reply flags, a preview of the last message and the linked booking (guest, arrival, departure). Use it to find conversations waiting for an answer; then call get_message_thread for the full text. Data reflects the last sync into the PMS (new guest messages arrive in real time via webhook; older history depends on when the Messages page last synced). WhatsApp AI-reception chats and reviews are not included. To reply, use send_guest_message. Cannot close conversations.

list_properties

ChatGPT
List the properties (hotels) this API key can access, with their IDs. Call this first: every other tool takes a property_id. A property key returns exactly one property; a platform key returns all properties (use search to filter by name or city).

list_room_services

ChatGPT
List room service requests (cleaning, towels, amenities, other) scheduled for a day or a date range of up to 31 days, with room, guest, booking, note, staff comments and status (pending / done). Defaults to today. Use it for 'what service requests are open today' or 'did room 12 get towels'. It cannot create, complete or delete requests.

list_staff

ChatGPT
List the active staff accounts of the property's business (name, role, email). Use it to find who collected a payment (record_payment needs collected_by) or to answer who works at the hotel. Cannot add, remove or change staff.

mark_no_show

ChatGPT
Mark a DIRECT booking as no-show (guest did not arrive) on or after its arrival date. Frees the room nights on all channels. OTA bookings are refused: a no-show must be reported to the OTA from the LuxHotel app so the OTA releases the reservation. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

record_payment

ChatGPT
Record money the guest paid at the hotel (cash, bank transfer, card terminal…) as an INCOME transaction on a booking, exactly like 'Add payment' in the booking folio. The transaction is saved with status 'pending' so a manager approves it in the app, as usual — but note: a pending payment ALREADY counts toward the booking's paid amount and payment status. payment_method must be one of the property's payment accounts (default Cash, Bank, Other, plus the property's own accounts; an unknown method returns the list). Amounts are in EUR; pass currency 'ALL' to enter lekë, converted with the property's EUR→ALL rate. The preview shows the balance before/after and warns about overpayment. It does NOT fiscalize (BlueBill) and does not create a POK link (use create_payment_link for online payment). Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

reply_to_review

ChatGPT
Publish the property's public reply to a guest review on its channel (Booking.com, Airbnb…). The reply is PUBLIC and can't be edited or deleted afterwards, and each review takes only one reply. Write it in the review's language, thank the guest, address concrete points calmly, never share private data. Draft it with the user first. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

search_bookings

ChatGPT
Find bookings (reservations) at a property. Use query to look a guest up by name/surname, email, phone, OTA reservation code / ota_unique_id / Channex ID / booking ID; and/or filter by arrival range, departure range, or stay range (bookings in house at any point between stay_from and stay_to), status, channel, source and payment status. Date ranges are inclusive, at most 366 days. Without query or dates it searches the 500 most recently created bookings. Returns compact summaries (guest, dates, nights, status, channel, room type and room number, total/paid/balance) — call get_booking for full detail. Out-of-order blocks and spam are hidden unless requested. Cannot modify or cancel bookings.

search_customers

ChatGPT
Find guest profiles (customers) of this property by name (prefix of the full name, then a 'contains' fallback), email, phone or company. Returns contact details (name, email, phone, country, city, company, category) and IDs for get_customer. Never returns ID-document or tax numbers. Only guests with at least one booking at this property are returned. Cannot create, edit or merge customers.

search_reviews

ChatGPT
Guest reviews from the OTAs (Booking.com, Airbnb, Expedia…) for the property, newest first, with a summary (count, average score out of 10, awaiting reply, per channel, per score category). Filter by channel, score, reply status, date or text. Content is shortened to 500 characters — use get_review for the full text. To answer a review use reply_to_review; for Airbnb guests use submit_guest_review.

search_transactions

ChatGPT
Search the property's financial transactions (payments received, expenses, transfers between accounts) by date range, type, category, payment method, status, booking or text in the description/guest name. Returns each transaction's amount in EUR (the app's base currency; the originally entered ALL amount is included when relevant), status, linked booking ID, whether income was actually collected, and who recorded it (name/email). Newest first, paginated. date_from/date_to are required (max 366 days, date_to inclusive) unless booking_id is given. Use get_revenue_report or get_cash_summary for totals. Cannot record, approve, edit or refund payments.

send_guest_message

ChatGPT
Send a text message to a guest in their OTA conversation (Booking.com, Airbnb, Expedia — through the channel manager), exactly like replying from the Messages page. Identify the conversation with thread_id (from list_message_threads) or with booking_id (an OTA booking). Write the message in the guest's language (check get_message_thread for how they wrote), polite and short, signed as the property — never include card numbers or internal notes. Works only for conversations already synced into the PMS; bookings created in the PMS (walk-in, phone) have no channel conversation. No attachments; cannot close conversations. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

send_guest_messages

ChatGPT
Send messages to several guests at once (2–20), with ONE confirmation — e.g. a reminder to everyone arriving tomorrow. Each item is one guest conversation (thread_id or booking_id) with its own message; personalise each one (guest name, their dates) and write it in that guest's language. Messages go out in parallel; the result lists which were sent and which failed. For a single guest use send_guest_message. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

set_availability

ChatGPT
Set how many rooms of a room type are available to sell for a range of nights, like editing availability in the app's calendar. The number is pushed to all channels and stays as a manual override (new bookings still reduce it). Use it only when the user explicitly asks to change availability / inventory; to stop selling, prefer set_stop_sell. Today and future dates only, up to 366 nights. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

set_housekeeping_status

ChatGPT
Mark a room as cleaned (clean) or back to dirty for TODAY on the Housekeeping page — the checkout-cleaning board, exactly like tapping the room there (records who cleaned it and when). Optionally adds a staff comment. The Housekeeping page lists only rooms with a departure today; other rooms can be marked too but won't appear there. It does NOT change the room's out-of-service state or availability, and only today is supported. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

set_stop_sell

ChatGPT
Close sales (stop sell) or reopen them for a range of nights, like the stop-sell switch in the app's calendar — the channels stop or resume selling those nights. Target one rate plan (rate_plan_id) or every rate plan of a room type (room_type_id). It does NOT change the number of rooms available or any price; existing bookings are not affected. Today and future dates only, up to 366 nights. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

submit_guest_review

ChatGPT
Airbnb only: the host's review of the guest (stars for cleanliness, communication and respect for house rules, a public review, a private note to the guest, and whether you'd host them again). Submitting it also reveals the guest's review if it was hidden. Can be done once per stay and can't be changed. Optional tags: Airbnb codes like host_review_guest_positive_neat_and_tidy. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

unblock_room

ChatGPT
Remove an out-of-order room block (a booking flagged as block, is_block: true in search_bookings / get_booking). The whole block is cancelled and its nights become available again on all channels. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

update_booking

ChatGPT
Change a DIRECT booking (not from an OTA): dates, rooms (add, remove, change room type, rate plan or occupancy), guest contact details, arrival time or the agreed total. Only new/confirmed/modified/checked-in bookings; a checked-in guest can only change the departure date. Only added nights/rooms are checked against availability. When dates or rooms change the price is recalculated from the hotel's rates for the changed rooms unless you pass agreed_total. A room whose type changes loses its assigned physical room and gets auto-assigned. OTA bookings are refused (change them at the channel); use add_booking_note for notes and the status tools for check-in/out or cancellation. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

update_rates

ChatGPT
Set the nightly price of one rate plan for a range of nights (optionally only some weekdays), exactly like the price calendar or bulk update in the app — the new price is pushed to Booking.com, Airbnb and the other channels. Get rate_plan_id and current prices from get_property / get_calendar. Prices are in the property currency, per night, for the plan's standard occupancy. Derived (child) plans follow their parent's price and can't be set directly — change the parent. Restrictions (stop sell, closed to arrival/departure, minimum stay) are kept as they are. Today and future dates only, up to 366 nights. Two-step: this call only PREVIEWS the change and returns a confirmation_id. Show the summary to the user, get their explicit approval, then call confirm_action. Nothing is changed until then.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/luxhotel-system"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/luxhotel-system)