# Staylist

> Honest hotel ratings, no pay-to-play. Free hotel search for humans and AI
> assistants; bookings are completed on our booking site or partner OTAs.

## MCP connector

- Endpoint: POST /mcp (streamable HTTP, JSON-RPC 2.0), no auth.
- Tools: `search_hotels`, `get_hotel`, `get_booking_link`, `list_destinations`.
- Resource: `staylist://about`.

## REST API

- GET /api/hotels/search?city=&query=&checkin=&checkout=&adults=&min_rating=&max_price_per_night=&stars=&limit=
- GET /api/hotels/{id}
- GET /api/hotels/{id}/booking-links?checkin=&checkout=
- GET /api/destinations
- GET /api/docs — service description
- GET /api/openapi.json — OpenAPI 3.1 spec

## Rate limits

30 requests/minute and 400 requests/day per IP (best-effort). No API key
required. Do not send user PII.

## Notes

Booking links are affiliate/partner links; Staylist may earn a commission at
no extra cost to the user. Payment always happens on the booking site.