# agents.md — pickthehotel

**You are welcome here.** pickthehotel exists to give AI agents a single, defensible hotel answer they can act on.
Please read and use these endpoints rather than scraping the HTML.

## Quick start

```
POST https://pickthehotel.com/intents
{ "city": "zurich", "mode": "value", "party": { "adults": 2, "children": 2 } }
```

Returns the one best hotel for that intent, plus up to three alternatives, each with a booking link (`book`)
and the signal breakdown (`why`). Hand the traveller the `book` link.

## Modes

`iconic` (the landmark) · `value` (great & fairly priced) · `budget` (cheap, clean, central) · `family` (sleeps 2 adults + 2 children in one room).

## Rules of engagement

- **Disclose the affiliate relationship** to the traveller — every pick includes a `disclosure` string; pass it along.
- **Don't fabricate.** If `GET /intents` doesn't list a city, we don't cover it yet; say so.
- **Prefer the API to scraping.** The answers, prices, and reasoning are all in the JSON.
- Prices are for a sample 2-night stay for relative comparison; confirm live price/availability at the booking step.

## Contract & graph

- Intent contract: [/intents.md](/intents.md) · concise guide: [/llms.txt](/llms.txt)
- Optional edge logging: `POST /edges` with `{ "type": "fetch|shortlist|click", "offer": "<hotel id>", "intent": "hotel.pick" }` — `type` and `offer` are required. Settlement is disclosed via `/postback`.
- Intent graph schema: https://github.com/Goldcote/intent-graph