OKstays

OKstays MCP server

Find hotels you'll actually sleep well in. OKstays scores 30,000+ hotels in 80+ destinations on 67 comfort signals from what guests report (efficient AC, comfy beds, real soundproofing, quiet nights, spacious rooms, recent renovations, safe and walkable neighbourhoods and more). The Comfort Score, from 0 to 10, combines the 51 that make a stay comfortable: Comfort & Essentials 60% (five must-haves, clean, comfy beds, good shower, bug-free and safe area, 30%, and sleep and room 30%), Perks & Facilities 15%, Service & Hospitality 15% and Location & Access 10%. A high score from few reviews leans toward the destination's typical score until more guests review the place. A hotel whose guests keep reporting problems with cleanliness, beds, showers or bugs is never ranked, hotels, apartments and hostels are ranked apart, and hotels can't pay to be ranked.

This is a hosted, read-only MCP server. There is nothing to install and no account or API key.

• Endpoint: https://okstays.com/api/mcp (streamable HTTP)
• Authentication: none
• Documentation: https://okstays.com/mcp
• Website: https://okstays.com

Connect

Claude (web and desktop): OKstays is in Claude's connector directory: open claude.ai/directory/connectors/okstays, click Connect and allow the tools (no sign-in). Or add it yourself: Customize → Add → Add custom connector, name it OKstays and paste https://okstays.com/api/mcp as the server URL. Works on every Claude plan; Free allows one custom connector.

Claude Code:

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

ChatGPT (web): Connectors → Add → Add custom MCP server. Name it OKstays, paste https://okstays.com/api/mcp, choose No authentication, create it and connect. In a chat, pick OKstays (or type @OKstays).

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

{

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

VS Code (.vscode/mcp.json):

{

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

Cline (MCP settings):

{

"mcpServers": { "okstays": { "type": "streamableHttp", "url": "https://okstays.com/api/mcp" } } }

Any client, by hand:

curl -X POST https://okstays.com/api/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \

-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

All eight tools only read data. Inputs, outputs and access level for each: TOOLS.md.

Give your assistant your dates and the number of guests, and every hotel link it shows opens on that stay: Book Now on the hotel's page then books those nights. Clients that show MCP prompts (Claude, Claude Desktop, VS Code) also get four ready-made ones: Find a comfortable hotel, Plan a multi-stop trip, Compare hotels, Choose where to stay.

Example prompts

• Which neighbourhoods in Lisbon have the most comfortable hotels?
• Find a quiet hotel in Porto under $200 a night
• Hotels in Bangkok with efficient AC and soundproof rooms
• Compare the top two and tell me which is better value
• Find something like the first one, but cheaper
• Plan hotels for Lisbon 4 nights, Porto 3 and Madrid 5 from 10 May
• Is the Pestana Palace in Lisbon quiet? We're there 12 to 15 March, two of us

Data, privacy and limits

• Results link to each hotel's page on okstays.com, with photos, a map and prices. Prices are indicative rates for two adults on a sample date. OKstays earns a commission when people book through the booking links on its website; this never affects the rankings, and tool results contain no affiliate links.
• Fair use: 60 requests a minute and 2,000 a day per caller. Each tool call and prompt is logged (tool or prompt, search parameters, client name, a hashed caller id) for 30 days for limits and abuse prevention: https://okstays.com/privacy
• Terms: https://okstays.com/terms
• Support: hello@okstays.com

About this repository

The server runs on OKstays' own infrastructure; its code isn't public. This repository holds what MCP directories and clients need:

• this README and llms-install.md, for people and agents that set servers up;
• server.json, published to the official MCP Registry as com.okstays/okstays;
• gemini-extension.json (Gemini CLI) and .cursor-plugin/plugin.json with mcp.json (Cursor), which only point those clients at the endpoint;
• the logo (logo-400.png);
• .github/workflows/health.yml, a daily check that the live server answers (the badge above).

The configuration files and documentation are MIT-licensed (LICENSE); the OKstays name and logo are not.