Developer documentation
Agentic hospitality
AI agents can only act on what a system of record exposes. Rooms and stays live in the PMS. Everything else a hotel sells or runs (spa, activities, kids’ clubs, tours, events, sunbeds, dining, rentals, transfers, retail, vouchers and packages) needs its own catalogue, live availability and booking record. Turneo is that system for services beyond the room, with a REST API and an MCP server that guest-facing and staff-facing agents can call.
Why
Why hotel agents need more than the PMS
Agents turn a guest's or a colleague's request into calls. What they can do is bounded by the systems behind them.
Every service is its own inventory
A massage needs a therapist and a room, a cabana is a spot on a map, a transfer needs a vehicle and a driver, a voucher is redeemed weeks later. A PMS models rooms and stays, not these.
Agents can't guess availability
A model that answers from memory will offer slots that are gone and prices that changed. An agent needs a system that answers live, and that holds a slot while the guest decides.
Bookings don't end at confirmation
Someone accepts, assigns staff, reschedules, charges the room, marks it done and reports on it. The same system that sold the booking has to run it, for people and agents alike.
The stack
Two systems of record, side by side
The PMS and Turneo are peers: each owns its own records. Turneo posts charges to the guest's folio in the PMS and reads the guest's stay from it.
Property management system (PMS)
The system of record for rooms and stays.
- Room inventory, rates and room reservations
- Stays and the guest's stay context
- The room folio (the guest's bill)
Turneo
The system of record for services beyond the room.
- The catalogue of experiences and services, with options and prices
- Live availability and capacity, including the staff and resources a booking needs
- Booking orders and bookings, from request to completion
- Retail stock and gift vouchers, from sale to redemption
- Local partners' experiences, sold with commission
- An activity feed of every booking change
Services
13 service families
Each has its own inventory model and its own limits. Each card says how many of the support matrix's 11 capabilities the public API covers, in full or with limits.
Spa and wellness
Treatments, massages and wellness sessions, each needing a qualified therapist and a treatment room.
Appointment · Public API: 7 in full, 4 with limits
Hotel experiences
The hotel's own activities: cooking classes, tastings, yoga, guided walks, signature dinners.
Session · Public API: 7 in full, 4 with limits
Kids' clubs and academies
Kids' club sessions and sports or arts academies, booked by session with age-based places.
Session · Public API: 6 in full, 5 with limits
Local tours and partner experiences
Tours, excursions and activities run by vetted local partners, sold by the hotel with commission.
Supplier-owned · Public API: 6 in full, 5 with limits
Events and ticketing
In-house dinners, live music and themed nights, plus tickets for local concerts and festivals.
Ticket · Public API: 7 in full, 4 with limits
Sunbeds, beach and cabanas
Sunbeds, double beds, cabanas and VIP loungers on the beach or pool deck, sold from a live map.
Spot or table · Public API: 6 in full, 5 with limits
Dining and F&B
Table reservations across restaurants, bars and patios, chef's tables, tasting menus and private dining.
Spot or table · Public API: 6 in full, 3 with limits
Rentals
Bikes and e-bikes, kayaks and paddleboards, courts, beach gear and vehicles, by the hour or the day.
Rental asset · Public API: 7 in full, 4 with limits
Transfers
Airport pickups, shuttles and point-to-point rides, with a vehicle for the party and an assigned driver or partner.
Ride · Public API: 7 in full, 3 with limits
Retail
Branded merchandise, spa products, wine and in-room enhancements, sold on their own or with a booking.
Product · Public API: 8 in full, 3 with limits
Gift vouchers
Single- and multi-use vouchers for experiences, treatments and dining, bought now and redeemed later.
Voucher · Public API: 10 in full, 1 with limits
Packages and bundles
Several services sold together, such as a spa treatment with dinner, or a retail add-on with a booking.
Package · Public API: 4 in full, 7 with limits
Other hotel services
Extras such as celebration set-ups, in-room amenities and private services, set up by each hotel in Turneo.
Request · Public API: 7 in full, 4 with limits
Agents
What guest and staff agents do with the API
Reading is free; anything marked “Needs a yes” books, charges or changes a booking, so the agent confirms the details with a person first.
Guest-facing agents
A concierge in the hotel's app, website chat, WhatsApp or ChatGPT that recommends and books.
- 01
Find what fits
Search the hotel's catalogue by date, category or free text, or ask for recommendations.
- 02
Check live availability and price
Dates first, then the time slots and prices for the guest's party on the chosen day.
- 03
Hold, then confirmNeeds a yes
A booking order holds the slot for 15 minutes while the guest says yes; confirming turns it into a booking.
- 04
Take paymentNeeds a yes
Email the guest a payment link, or charge the room when the hotel allows it.
- 05
Report the real state
Read the order back and tell the guest what it says: on hold, pending the provider, confirmed, paid.
Staff-facing agents
Assistants for the concierge desk, spa reception and operations, and reporting agents.
- 01
See the day
Bookings by date, service, status or payment status, with the staff and rooms assigned to each.
- 02
Act on bookingsNeeds a yes
Accept, reject, reschedule, reassign a therapist or vehicle, cancel and refund.
- 03
Close the loopNeeds a yes
Mark bookings completed or no-show, and record payments taken at the desk.
- 04
Report
One row per booking, retail sale or voucher sale with price, currency and commission for any date range, plus a feed of every change since your last sync.
Ways in
Connect your agent to Turneo
Turneo API
REST and JSON with an X-API-Key. Wrap the operations above in your own agent's tools, in any framework.
API referenceMCP server
21 ready-made guest tools for ChatGPT and other MCP clients, set up by Turneo for your hotels.
See the toolsGet access
API keys and the MCP server come with a Turneo partner account. Ask your Turneo contact, or email us to sign up.
Request access