Okstays MCP Server

OKstays MCP server

Find hotels you'll actually sleep well in. OKstays scores 30,000+ hotels in 80+ destinations on 67 comfort signals (efficient AC, comfy beds, real soundproofing, quiet nights, spacious rooms, recent renovations, safe and walkable neighbourhoods and more) and combines them into one Comfort Score from 0 to 10. Five must-haves (clean, comfy beds, good shower, bug-free, safe area) weigh 40%, and a hotel that fails one is never ranked. 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): Customize → Add → Add custom connector. Name it OKstays, paste https://okstays.com/api/mcp as the server URL, no sign-in, then connect and allow the tools. Works on every Claude plan, including Free.

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.