Skip to content

OKstays status

Answered our latest tool-list check 4 hours ago with 8 tools. It will be marked verified after 3 successful checks in 7 days.

Answered (30 days)
2 of 2 checks
Last seen working
17 Nov, 06:16 UTC
Last commit
—
Licence
Not stated

Live checks

We call this hosted server's tools/list endpoint without credentials, from the public internet, every day while it answers and weekly otherwise.

  • Answered
  • Needs sign-in
  • No answer
Checked (UTC)ResultResponse timeTools
17 Nov, 06:16Answered6.0 s8
16 Nov, 06:16Answered2.1 s8

Tools (8)

Read from the server on 17 Nov 2026.

search_hotels
Use this when the user wants hotels in a destination (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 what guests report: Comfort & Essentials 60%, the five must-haves (cleanliness, beds, shower, bugs and safety) 30% and sleep and room 30%; Perks & Facilities 15%; Service & Hosp
get_hotel
Use this when the 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, the five must-haves, its strengths and complaints with the reason behind each score, price, the city tax where we know it and its okstays.com link. Pass focus with what the user asked about; detail='full' adds e
list_cities
Use this when the user asks which destinations OKstays covers, or before planning a trip through a country. Returns every destination we score with its country, slug and number of hotels; pass country to list one country only. Read-only, no sign-in.
get_filters
Use this to look up the comfort signals and travel styles that search_hotels accepts, when the user's wish doesn't map clearly to one. Returns every filter (id, name, description, category, whether it's a must-have) and every travel style. Plain names also work in search_hotels tags ('quiet', 'wifi'). Read-only, no sign-in.
compare_hotels
Use this when the user is choosing between 2-4 specific hotels. Returns each hotel's Comfort Score breakdown, price, strengths and complaints, the signals where they differ most, and a verdict: best comfort, cheapest, best value. Hotel ids come from search_hotels (hotel_name finds a hotel the user names). Read-only, no sign-in.
find_similar_hotels
Use this when the user likes a hotel but wants alternatives, e.g. 'like this one but cheaper' (cheaper_only). Returns hotels in the same destination with the closest comfort profile, none with repeated complaints about cleanliness, beds, showers, bugs or safety, with the price difference. Read-only, no sign-in.
get_city_overview
Use this when the user is still choosing a destination or an 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, which travel styles it suits, the city tax at a 4-star hotel, when to go (pleasant, cool-night and quiet months, typical weather by month) and, where
plan_trip
Use this when the user plans a trip with several stops. Returns hotels for each stay in travel order (e.g. Lisbon 4 nights, Porto 3, Madrid 5): the best match for each stop by the OKstays Comfort Score (or the travel style's score), alternatives, the stay dates and an indicative total. Each hotel link opens its OKstays page with the stop's dates, so its Book Now button books those nights. Agree th