OKstays

HotelsUse inthis when the sameuser citylikes witha thehotel comfortbut profilewants closestalternatives, toe.g. a'like giventhis hotelone but cheaper' (similarcheaper_only). scoresReturns acrosshotels in the same destination with the closest comfort filters).profile, Useall cheaper_onlypassing forthe 'likefive thismust-haves, onewith butthe cheaper'.price difference. Read-only, no sign-in.

{"properties":{"adults":{"description":"Guests per room (1-8), if given.","maximum":8,"minimum" ⟨14 unchanged words⟩ ":{"description":"User's check-in date, YYYY-MM-DD (e.g. 2027-03-12), if given: links then open on this ⟨3 unchanged words⟩ ,"checkout":{"description":"Check-out date, YYYY-MM-DD.YYYY-MM-DD (e.g. 2027-03-15).","type":"string"},"hotel_id":{ ⟨40 unchanged words⟩ 

SnapshotUse ofthis when the user is still choosing a destination: hotelor countsan area to stay in. Returns how many hotels we score, the average Comfort Score, median price, where its hotels beat and trail the average hotel, the best neighbourhoods with their top hotel, and which travel styles it suits. Use it when the user is choosing a destination or an area; for aA request for hotels (e.g. 'quiet hotels in Bangkok'), callis search_hotelssearch_hotels' directly.job. Read-only, no sign-in.

{"properties":{"adults":{"description":"Guests per room (1-8), if given.","maximum":8,"minimum" ⟨4 unchanged words⟩ ":{"description":"User's check-in date, YYYY-MM-DD (e.g. 2027-03-12), if given: links then open on this ⟨3 unchanged words⟩ ,"checkout":{"description":"Check-out date, YYYY-MM-DD.YYYY-MM-DD (e.g. 2027-03-15).","type":"string"},"location":{ ⟨11 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"Get cityDestination overview"}

AllUse this to look up the comfort filterssignals and travel styles that search_hotels accepts, when the user's wish doesn't map clearly to one. Returns every filter (idsid, namesname, descriptionsdescription, categories)category, usablewhether init's search_hotels,a plusmust-have) theand every travel stylesstyle. Plain names also work in search_hotels tags (personas'quiet', 'wifi'). Read-only, no sign-in.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetFilters filtersand travel styles"}

OneUse hotelthis inwhen depththe user asks about one hotel: why it scores as it does, or whether it's quiet, clean or good for sleep or work. Returns the Comfort Score breakdown, what the scores rest on ⟨8 unchanged words⟩  the reason behind each score, price and links.its okstays.com link. Pass focus with what the user asked about; detail='full' adds every scored signal (about four times longer). Read-only, no sign-in.

{"properties":{"adults":{"description":"Guests per room (1-8), if given.","maximum":8,"minimum" ⟨4 unchanged words⟩ ":{"description":"User's check-in date, YYYY-MM-DD (e.g. 2027-03-12), if given: links then open on this ⟨3 unchanged words⟩ ,"checkout":{"description":"Check-out date, YYYY-MM-DD.YYYY-MM-DD (e.g. 2027-03-15).","type":"string"},"detail":{ ⟨61 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetHotel hoteldetails"}

DestinationsUse coveredthis when the user asks which destinations OKstays covers, or before planning a trip through a country. Returns every destination we score with hotelits counts.country, Optionallyslug onlyand thosenumber inof hotels; pass country to list one country.country only. Read-only, no sign-in.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"ListCovered citiesdestinations"}

HotelsUse forthis awhen multi-stopthe user plans a trip, onewith stayseveral perstops. destinationReturns hotels for each stay in travel order (e.g. Lisbon 4 nights,  ⟨57 unchanged words⟩  shows which destinations of a country we cover. Read-only, no sign-in.

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"Plan a multi-stop trip"}

RankUse this when the user wants hotels in a citydestination (e.g. 'quiet hotels in Bangkok under $150'), or asks about a hotel by name (hotel_name). Returns up to 10 hotels per page, ranked by the OKstays Comfort Score (0-10 from comfort signals; the five must-haves, cleanliness, beds, shower, bugs and safety, count 40%). Onlyand only hotels that pass all five must-havesthem are returned. Optionallyranked) rankor forby a travel style (persona) and/or requirestyle's specificscore, strengths.each Returnswith upstrengths, tocomplaints, 10indicative hotelsprice perand pageits (limit,okstays.com page)link. withFilters: strengths,travel caveatsstyle, pricesignals andthe links.hotel Tomust checkscore a8+ hotelon, theprice, userminimum alreadyscore, hasneighbourhood, indistance mind,from passa hotel_name.point. Pass the user's dates and guests (checkin,when checkoutknown. Hotels only, adults)not whenflights known.or car hire. Read-only, no sign-in.

{"properties":{"adults":{"description":"Guests per room (1-8), if given.","maximum":8,"minimum" ⟨4 unchanged words⟩ ":{"description":"User's check-in date, YYYY-MM-DD (e.g. 2027-03-12), if given: links then open on this ⟨3 unchanged words⟩ ,"checkout":{"description":"Check-out date, YYYY-MM-DD.YYYY-MM-DD (e.g. 2027-03-15).","type":"string"},"district":{ ⟨257 unchanged words⟩ 

{"properties":{"adults":{"description":"Guests per room, if given.","maximum":8,"minimum":1,"type":"integer"},"checkin":{"description":"User's check-in date, YYYY-MM-DD, if given: links then open on this stay.","type":"string"},"checkout":{"description":"Check-out date, YYYY-MM-DD.","type":"string"},"location":{"description":"City name or slug. ⟨6 unchanged words⟩ 

Full detailsOne forhotel onein hoteldepth: Comfort Score breakdown, everywhat filterthe scorescores withrest itson, explanationthe five must-haves, caveatsits strengths and complaints with the reason behind each score, price and links. Pass focus with what the user asked about; detail='full' adds every scored signal (about four times longer).

{"properties":{"adults":{"description":"Guests per room, if given.","maximum":8,"minimum":1,"type":"integer"},"checkin":{"description":"User's check-in date, YYYY-MM-DD, if given: links then open on this stay.","type":"string"},"checkout":{"description":"Check-out date, YYYY-MM-DD.","type":"string"},"detail":{"description":"summary (default) or full: every scored signal with its explanation, about four times longer.","enum":["summary","full"],"type":"string"},"focus":{"description":"Signals the user asked about, as filter ids or names (e.g. ['quiet', 'bed', 'wifi']); always included with their reasons.","items":{"type":"string"},"type":"array"},"hotel_id":{"description":"Hotel id (numeric  ⟨9 unchanged words⟩ 

Rank hotels in a city by the OKstays Comfort Score (AI scores on0-10 thefrom comfort filters;signals; cleanliness, beds, shower, bugs and safety  ⟨20 unchanged words⟩ require specific strengths. Returns up to 10 hotels per page (limit, page) with strengths, caveats, price and links. To check a hotel the user already has in mind, pass hotel_name. Pass the user's dates and guests (checkin, checkout, adults) when known.

{"properties":{"adults":{"description":"Guests per room, if given.","maximum":8,"minimum":1,"type":"integer"},"checkin":{"description":"User's check-in date, YYYY-MM-DD, if given: links then open on this stay.","type":"string"},"checkout":{"description":"Check-out date, YYYY-MM-DD.","type":"string"},"district":{"description":"Neighbourhood to restrict to ⟨13 unchanged words⟩  hotel addresses.","type":"string"},"hotel_name":{"description":"Find a hotel by name in this city (part of the name works, e.g. 'Pestana'), including hotels outside our rankings; the other filters are then ignored.","type":"string"},"limit":{"description":"Hotels per page (default 10).","maximum":10,"minimum":1,"type":"integer"},"location":{"description":"City name or slug ⟨70 unchanged words⟩  the point of interest.","type":"number"},"page":{"description":"Page of results (default 1; up to 5) for 'show me more'.","maximum":5,"minimum":1,"type":"integer"},"persona":{"description":"Travel style ⟨85 unchanged words⟩