OKstays

Komisyona göre değil, gerçek konfora göre sıralanmış oteller: 30.000'den fazla oteli sessizlik, yataklar, çalışan klima ve daha fazlasına göre arayın.

Barındırılan MCP Sunucusu

npx add-mcp 'https://okstays.com/api/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Use OKstays inside Claude, ChatGPT and Grok

Connect OKstays to your AI assistant and it can rank hotels by real comfort while you plan trips.

37K+

Places scored

122

Destinations

Free

No sign-up

MCP (Model Context Protocol) is the standard that lets AI assistants use external tools. Add the URL below to Claude, ChatGPT, Grok, Cursor or any MCP client and, when you ask about hotels, it uses real OKstays data: the Comfort Score (0-10, from the 51 of our 67 comfort signals that describe the stay, scored by AI from guest reviews, no paid placements; a high score from only a few reviews is pulled toward the usual score for places like it in the destination until more guests review it), strengths and caveats per hotel, and indicative nightly prices. In Claude, results also show as hotel cards: photo, Comfort Score, price and a link to the hotel's page.

https://okstays.com/api/mcp

How to connect

Claude (web / desktop)

Add to Claude

  1. Open OKstays in Claude's connector directory with the button, then Connect and allow the tools (all read-only, no sign-in)
  2. Ask: “find me a great hotel in Lisbon under US$150”

Or add it yourself: Customise → Add → Add custom connector, name it OKstays and paste the URL above (works on every Claude plan; Free allows one custom connector).

Claude Code

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

ChatGPT

  1. On the web, open Connectors → Add → Add custom MCP server
  2. Name it OKstays, paste the URL above, choose No authentication, create it, then Connect
  3. In a chat, pick OKstays (or type @OKstays). Otherwise ChatGPT may answer with its built-in travel apps.

Works on every ChatGPT plan, including Free.

Grok

  1. On grok.com, click + → Add Connector → Custom
  2. Name it OKstays and paste the URL above. That's it: Grok connects on its own.

Works on every Grok plan, including Free. On Grok Business, an admin adds it in console.x.ai → Grok Business → Connectors → Add Connector → Other.

Cursor / other MCP clients

Add an MCP server with transport http (streamable HTTP) and the URL above. The server is stateless JSON-RPC 2.0.

What your assistant can do

ToolWhat it returns
search_hotelsUp to 10 hotels for a city per page (and more pages on request), ranked by the OKstays Comfort Score, highest first, ties going to the better Comfort & Essentials score, then to the hotel more guests reviewed (a place scoring 6.0 or below on cleanliness, beds, showers or bugs is left out; one whose guests felt unsafe in the area says so in its caveats). Each comes with strengths, caveats, indicative price per night in USD and a link to its page. Options: travel style, required strengths, minimum score, maximum price, neighbourhood, distance from a point of interest, and sorting by comfort, price, value or distance. It also looks up a hotel you name, even one outside our rankings, and tells you why it isn't ranked.
get_city_overviewA snapshot of a destination: places scored, average Comfort Score, median price, what its hotels do best and worst, the best neighbourhoods, which travel styles it suits, the city tax, and when to go (pleasant months, cool nights for sleep, the quietest months and the typical weather of each month). A good first question for any trip.
get_hotelOne hotel in depth: Comfort Score breakdown, what the scores are based on, how it does on cleanliness, beds, showers, bugs and safety, its strengths and complaints with the reason behind each score (every signal on request), price, the city tax, and a link to its OKstays page where you can book.
compare_hotelsTwo to four hotels side by side: score breakdown, price, strengths, caveats, the filters where they differ most, and a verdict (best comfort, cheapest, best value).
find_similar_hotelsHotels in the same city that score most like a given one, with the price difference. Ask for "like this, but cheaper".
plan_tripHotels for a trip with several stops, in order (for example Lisbon 4 nights, Porto 3, Madrid 5): the best match for each stop, alternatives, the dates of each stay and an indicative total. Each hotel link opens its OKstays page with that stop's dates, so Book Now opens the booking site on those nights.
list_citiesThe destinations OKstays covers, with the number of places to stay in each. Can be limited to one country.
get_filtersAll filter ids and descriptions usable in search_hotels, grouped by category, plus the travel styles (personas).

Your dates on every link

Tell your assistant your dates and how many of you are travelling, and every hotel link it gives you opens on that stay: Book Now on the hotel's page then opens the booking site on those nights. Prices in answers are indicative; the booking site shows the live price.

Ready-made prompts

In apps that show MCP prompts (Claude, Claude Desktop, VS Code), OKstays adds four: Find a comfortable hotel, Plan a multi-stop trip, Compare hotels, and Choose where to stay. Fill in the destination and what matters to you, and the assistant takes it from there.

Things to ask

  • “Which are the best romantic hotels in Barcelona?
  • “Find me a hotel in Bangkok for a business trip, under US$300
  • “Hotels in Porto under US$200 with the highest comfort score
  • “What is Barcelona like for hotels? Which areas are best?
  • “Best-value hotels within 2 km of the Sagrada Família
  • “Compare the top three hotels you found and tell me which to book
  • “Is there something like this hotel, but cheaper?
  • “What do guests say about the beds and noise at the top result?
  • “Is the Pestana Palace in Lisbon quiet? We're there from 12 to 15 March, two of us
  • “Which cities does OKstays cover in Spain?
  • “Plan the hotels for 10 days in Italy: Rome 4 nights, Florence 3, Milan 3, from 12 May

For developers

Check the server from a terminal:

curl -s https://okstays.com/api/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Fair use

Free for trip research: 60 requests/minute, 2,000/day and 400 hotel-detail or comparison requests/day per IP address, with a shared daily capacity for everyone. It's deliberately not a bulk-export API, and answers for popular destinations are cached for a few minutes. Prices are indicative; the booking site shows the live price for your dates. Link back to the okstays.com hotel pages when you publish anything based on the data.