okstays

endpoint

https://okstays.com/api/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is okstays live?

Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.

Is okstays free to use?

Yes — the hub reached it with no key and no payment.

What tools does okstays have?

7 tools: find_similar_hotels, search_hotels, get_hotel, get_city_overview, compare_hotels, list_cities, get_filters.

Is okstays safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• list_cities open 2h ago

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

  mcp-tool

  123456789

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

  arguments 9 lines copy
• get_filters open 2h ago

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

  mcp-tool

  1234

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

  arguments 4 lines copy
• find_similar_hotels unknown never probed

  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'.

  mcp-tool

  123456789101112131415161718192021222324252627

  {
    "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."
      }
    }
  }

  arguments 27 lines copy
• search_hotels unknown never probed

  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.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162

  {
    "type": "object",
    "required": [
      "location"
    ],
    "properties": {
      "tags": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Filter ids the hotel must score 8+ on, e.g. ['soundproofing', 'reliable_wifi']. See get_filters."
      },
      "persona": {
        "type": "string",
        "description": "Travel style to rank for: digital-nomad, deep-sleep, avoid-crowds, romantic, family, business, solo-safe, luxury, budget-comfort."
      },
      "sort_by": {
        "enum": [
          "best",
          "cheapest",
          "priciest",
          "value",
          "nearest"
        ],
        "type": "string",
        "description": "best = Comfort Score (default); value = Comfort Score per $100; nearest needs near_lat/near_lng."
      },
      "district": {
        "type": "string",
        "description": "Neighbourhood to restrict to, e.g. 'Gothic Quarter'. get_city_overview lists the districts."
      },
      "location": {
        "type": "string",
        "description": "City name or slug, e.g. 'Barcelona' or 'new-york'. Use list_cities for coverage."
      },
      "near_lat": {
        "type": "number",
        "description": "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": {
        "type": "number",
        "description": "Longitude of the point of interest."
      },
      "max_price": {
        "type": "number",
        "minimum": 0,
        "description": "Maximum indicative price per night in USD."
      },
      "min_score": {
        "type": "number",
        "maximum": 10,
        "minimum": 0,
        "description": "Minimum Comfort Score (0-10)."
      },
      "radius_km": {
        "type": "number",
        "minimum": 0.1,
        "description": "Search radius around near_lat/near_lng in km (default 3)."
      }
    }
  }

  arguments 62 lines copy
• get_hotel unknown never probed

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

  mcp-tool

  123456789101112

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

  arguments 12 lines copy
• get_city_overview unknown never probed

  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.

  mcp-tool

  123456789101112

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

  arguments 12 lines copy
• compare_hotels unknown 2h ago

  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).

  mcp-tool

  1234567891011121314151617

  {
    "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."
      }
    }
  }

  arguments 17 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.