# OKstays

> OKstays is a free MCP server for maps and travel. Hotel search ranked by a Comfort Score built from guest reviews, no signup. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://okstays.com/mcp
- **Repository:** https://github.com/okstays/okstays-mcp
- **MCP Registry name:** com.okstays/okstays
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

OKstays ranks hotels by comfort rather than commission. Its Comfort Score runs 0 to 10 and is scored by AI from guest reviews across 51 of 67 comfort signals, with no paid placements. A high score from few reviews is pulled toward the typical score for similar places in that destination.

Eight read-only tools cover city overviews, single hotel detail, side-by-side comparisons with a verdict, hotels similar to one you like, and trip planning. In Claude, results show as hotel cards with photo, score, price and link.

It is free with no sign-in, works in Claude, ChatGPT, Grok and Cursor, and prices are indicative nightly rates.

## Features

- **Comfort Score:** Ranks hotels from review signals.
- **Strengths and caveats:** Lists what each hotel does well and badly.
- **Side-by-side compare:** Two to four hotels with a verdict.
- **Similar hotels:** Find alternatives, such as cheaper options.
- **City overviews:** Average score, median price and best neighbourhoods.

## Good for

- Find a quiet hotel in a city
- Compare shortlisted hotels
- Find a cheaper alternative
- Plan where to stay on a trip

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http okstays https://okstays.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://okstays.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "okstays": {
      "url": "https://okstays.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "okstays": {
      "type": "http",
      "url": "https://okstays.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "okstays": {
      "serverUrl": "https://okstays.com/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "okstays": {
      "type": "http",
      "url": "https://okstays.com/api/mcp"
    }
  }
}
```

## Tools

- `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

## FAQ

### Is it free?

Yes, with no signup.

### Does it change anything?

All eight tools only read data.

### Are results paid placements?

No, the site says no paid placements.

### Is OKstays free?

Yes. OKstays is free to use.

### How do I add OKstays to Claude Code?

Run this command in your terminal: claude mcp add --transport http okstays https://okstays.com/api/mcp

### What are the best alternatives to OKstays?

The closest alternatives to OKstays are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/okstays
