# Pobytovka
> Agent-first rezervační platforma pro chaty/chalupy/apartmány v ČR. Připraveno pro AI asistenty.

Vyhledávání a rezervace pro AI agenty přes MCP (streamable HTTP) a REST. Ceny finální, quote s garantovanou platností, idempotentní hold, deterministické error kódy. Platby probíhají přímo mezi hostem a vlastníkem — Pobytovka nedrží cizí peníze.

## Rozhraní
- MCP: https://www.pobytovka.cz/mcp (POST, streamable HTTP; tools: search_properties, get_availability, get_quote, create_hold, get_booking_status, cancel_booking)
- REST/OpenAPI: https://www.pobytovka.cz/api/openapi.json
- Property pages: https://www.pobytovka.cz/p/<slug>

## Jednotky (multi-unit nemovitosti)
- Některé nemovitosti mají více samostatně rezervovatelných jednotek (pokoj/apartmán). search_properties u nich vrací u objektu pole `units`: [{unit_id, slug, name, capacity}]. Objekt bez tohoto pole se rezervuje jen jako celek.
- get_availability i get_quote přijímají volitelný parametr `unit` (public_id NEBO slug jednotky z `units`). Vynecháno nebo `null` = celá nemovitost (celek); s hodnotou = konkrétní jednotka. Dostupnost i cena se počítají ve scope jednotky (rezervace celku a jednotek se navzájem koordinují).
- Rezervace konkrétní jednotky: zavolej get_quote s `unit` → quote si jednotku zapamatuje → create_hold ji převezme (žádný `unit` parametr na create_hold — scope je dán quote). Odpovědi create_hold, get_booking_status i cancel_booking pak nesou `unit`: {unit_id, name}; rezervace celého objektu `unit` vynechává. Identita jednotky se drží i po potvrzení/zamítnutí vlastníkem a po stornu.
- Chybové kódy jednotek: `UNIT_NOT_FOUND` (404, get_quote/get_availability na neexistující/nepublikovanou/nebookovatelnou jednotku nebo na objekt bez samostatných jednotek), `BOOKING_MODE_CONFLICT` (409, vlastník mezi get_quote a create_hold vrátil objekt na režim „celý objekt" — vyžádej si nový quote), `UNIT_REQUIRED` (422, objekt se rezervuje jen po jednotkách — zvol jednotku a vyžádej si nový quote), `DATES_UNAVAILABLE` (409, termín ve scope jednotky/celku byl mezitím obsazen).

## Zásady
- Karta ani citlivé údaje hosta nejdou přes agenta; člověk dokončí na checkout_url.
- Žádné placené pořadí ve výsledcích.