# HotelUse

Hotel search, provider prices, room offers and hotel information for AI agents. Base URL: https://www.hoteluse.dev. HTTP and MCP share one account. Public documentation; live calls require a HotelUse bearer key.

- [HotelUse documentation](https://www.hoteluse.dev/docs/index.md): Hotel search, provider comparisons and room rates for developers and AI agents.
- [Quickstart](https://www.hoteluse.dev/docs/quickstart.md): Sign in, create an API key and make your first HotelUse API call.
- [Authentication & API keys](https://www.hoteluse.dev/docs/authentication.md): Browser sign-in, server-side bearer keys and one-time signup credits.
- [Filters & sorting](https://www.hoteluse.dev/docs/filters.md): Complete hotel, guest-review, facility, budget and rate filters for HTTP and MCP.
- [Search hotels](https://www.hoteluse.dev/docs/api/search-hotels.md): Find hotels by country and either city or latitude/longitude, with optional hotel filters; compare provider stay totals. Coordinates use the supplied center without a place lookup. Default order: nearest 5 km bands first, then greatest Brek price advantage over the cheapest other provider within each band. One search call ($0.04 after signup credits). Coverage reports failures and truncation. More pages of the same 10-minute quote session are free.
- [Get hotel information](https://www.hoteluse.dev/docs/api/get-hotel.md): Get information about one hotel by HotelUse ID: address, photos, facilities, policies and source metadata. No live rates. Each newly read hotel version costs $0.005 after signup credits; repeat reads of the same version are free.
- [Get room rates](https://www.hoteluse.dev/docs/api/get-room-rates.md): Read available supplier-specific room offers, terms, and stay totals for one hotel and itinerary. One room call ($0.06 after signup credits). Room equivalence across providers is not assumed. More pages of the same quote session are free.
- [Pricing, limits & coverage](https://www.hoteluse.dev/docs/pricing-and-limits.md): Search, room pricing and hotel information billing, signup credits and service limits.
- [Errors, retries & idempotency](https://www.hoteluse.dev/docs/errors-and-retries.md): Know when to retry, when a request is charged and how provider failures are reported.
- [MCP connection](https://www.hoteluse.dev/docs/mcp.md): Use the supported HotelUse tools through Streamable HTTP MCP.
- [MCP for Claude](https://www.hoteluse.dev/docs/mcp/claude.md): Search hotels and compare four providers inside Claude, with no HotelUse sign-in.
- [MCP for ChatGPT](https://www.hoteluse.dev/docs/mcp/chatgpt.md): Connect HotelUse to ChatGPT for hotel and room comparisons, without a HotelUse API key.
- [MCP for AI agents](https://www.hoteluse.dev/docs/mcp/ai-agents.md): Choose the public hotel-search connector or supported developer tools with account usage billing.

- [OpenAPI 3.1](https://www.hoteluse.dev/v1/openapi.json)
- [Capabilities](https://www.hoteluse.dev/v1/capabilities)
- [Full Markdown](https://www.hoteluse.dev/llms-full.txt)
- [Agent setup](https://www.hoteluse.dev/agent.md)