OKstays

Working · 1.6 s

com.okstays/okstaysv2.2.0 Domain verified

Hotels ranked by real comfort, not commission: search 30,000+ hotels by quiet, beds, WiFi and more

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://okstays.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

compare_hotels Read-only

Compare 2-4 hotels side by side: Comfort Score breakdown, price, strengths, caveats, the filters where they differ most, and a verdict (best comfort, cheapest, best value).

hotel_idsarray, required

2-4 hotel ids from search_hotels.

Tools (7)

compare_hotels

Compare 2-4 hotels side by side: Comfort Score breakdown, price, strengths, caveats, the filters where they differ most, and a verdict (best comfort, cheapest, best value).

read-only

Argument	Type	Description
hotel_ids*	array	2-4 hotel ids from search_hotels.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "hotel_ids"
  ],
  "properties": {
    "hotel_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 4,
      "minItems": 2,
      "description": "2-4 hotel ids from search_hotels."
    }
  }
}

find_similar_hotels

Hotels in the same city with the comfort profile closest to a given hotel (similar scores across the comfort filters). Use cheaper_only for 'like this one but cheaper'.

read-only

Argument	Type	Description
limit	integer	How many to return (default 5).
hotel_id*	string	Hotel id to find alternatives for.
max_price	number	Maximum price per night in USD.
cheaper_only	boolean	Only hotels priced below this one.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "hotel_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "How many to return (default 5)."
    },
    "hotel_id": {
      "type": "string",
      "description": "Hotel id to find alternatives for."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum price per night in USD."
    },
    "cheaper_only": {
      "type": "boolean",
      "description": "Only hotels priced below this one."
    }
  }
}

get_city_overview

Snapshot of a destination: hotel counts, average Comfort Score, median price, where its hotels beat and trail the average hotel, the best neighbourhoods, and which travel styles it suits. Use it when the user is choosing a destination or an area; for a request for hotels (e.g. 'quiet hotels in Bangkok'), call search_hotels directly.

read-only

Argument	Type	Description
location*	string	City name or slug.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "location"
  ],
  "properties": {
    "location": {
      "type": "string",
      "description": "City name or slug."
    }
  }
}

get_filters

All comfort filters (ids, names, descriptions, categories) usable in search_hotels, plus the travel styles (personas).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_hotel

Full details for one hotel: Comfort Score breakdown, every filter score with its explanation, caveats, price and links.

read-only

Argument	Type	Description
hotel_id*	string	Hotel id (numeric string) from search_hotels.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "hotel_id"
  ],
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel id (numeric string) from search_hotels."
    }
  }
}

list_cities

Destinations covered, with hotel counts. Optionally only those in one country.

read-only

Argument	Type	Description
country	string	Country name to filter by, e.g. 'Spain'.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country name to filter by, e.g. 'Spain'."
    }
  }
}

search_hotels

Rank hotels in a city by the OKstays Comfort Score (AI scores on the comfort filters; cleanliness, beds, shower, bugs and safety count 40%). Only hotels that pass all five must-haves are returned. Optionally rank for a travel style (persona) and/or require specific strengths. Returns up to 10 hotels with strengths, caveats, price and links.

read-only

Argument	Type	Description
tags	array	Filter ids the hotel must score 8+ on, e.g. ['soundproofing', 'reliable_wifi']. See get_filters.
persona	string	Travel style to rank for: digital-nomad, deep-sleep, avoid-crowds, romantic, family, business, solo-safe, luxury, budget-comfort.
sort_by	string	best = Comfort Score (default); value = Comfort Score per $100; nearest needs near_lat/near_lng.
district	string	Neighbourhood to restrict to, e.g. 'Gothic Quarter'. get_city_overview lists the districts.
location*	string	City name or slug, e.g. 'Barcelona' or 'new-york'. Use list_cities for coverage.
near_lat	number	Latitude of a landmark or address the user names (not the user's own location); with near_lng restricts results to hotels within radius_km and reports distance_km.
near_lng