For Agent Builders

Technical quickstart for developers building AI agents that book hospitality.

The agent flow

Understand intent

Parse "romantic weekend away" into actionable criteria: location, dates, vibe, constraints.

Discover venues

Query Curator endpoints to find matching venues, filtered by trust and endorsement.

Compare and recommend

Evaluate options against guest preferences. Explain why each venue fits.

Check and book

Query availability, get pricing, hold inventory, confirm reservation.

Manage the stay

Handle modifications, cancellations, webhooks, and post-stay settlement.

Building Block	Purpose	What you get
Curator	Discovery & trust	Find venues, filter by endorsement, weight by reputation
Venue	Understanding	Profiles, facilities, vibe, pre-composed answers
Bookable	Availability	Query dates/slots, pricing, hold inventory
Connect	Integration	Real-time PMS data, live inventory, instant confirmations
Stay	Lifecycle	State changes, modifications, webhooks
Folio	Money	Charges, payments, refunds

Pattern	What it means	Protocols needed
Read-only	Find and recommend; booking happens elsewhere	Curator, Venue
Full booking	End-to-end from search to checkout	All protocols
Aggregator	Index layer providing discovery for other agents	Curator, Venue

These are agent decisions, not protocol decisions. The specs give you the vocabulary; you decide the behaviour.

Decision	What to consider
Trust policy	How do you weight different Curators? DMO vs blog vs chain?
Caching	Venue profiles change rarely; availability changes constantly
Error handling	What happens when booking fails? How do you communicate?
Payment flow	Handle payment yourself or hand off to venue?

Learn the building blocks

Read the building block overviews to understand concepts and relationships.

Check the specs

Review reference specifications for schema details and examples.

Try the sandbox

Test against sample venues and Curators. (Coming soon)

Join the community

Connect with other builders, share patterns, get help. (Coming soon)