# The Cloud Caller - Agent Bookings

> Book Australian small businesses (car servicing, trades, clinics, golf) directly, agent to agent.
> No login, no captcha, no screen-scraping. Run by The Cloud Caller (Ammacatize Pty Ltd, Sunshine Coast QLD).

## Endpoints
- MCP (Streamable HTTP): https://bookings.thecloudcaller.com/mcp  (all businesses; per business: https://bookings.thecloudcaller.com/b/<id>/mcp)
- A2A agent card: https://bookings.thecloudcaller.com/.well-known/agent-card.json
- REST + OpenAPI 3.1: https://bookings.thecloudcaller.com/openapi.json

## How to book
1. search_businesses(query)  e.g. "car service sunshine coast"
2. get_business(business_id) - read required_details
3. check_availability(business_id, date, party_size)
4. hold_slot(business_id, start, party_size, agent_name, on_behalf_of) - holds for 10 minutes
5. Confirm time, price and details with your human.
6. confirm_booking(business_id, hold_id, name, phone, details?) - returns booking_ref + cancel_token
7. cancel_booking(business_id, booking_ref, cancel_token) if plans change

Rules (Trust Charter, https://bookings.thecloudcaller.com/charter): book only for a real person who asked you to; never invent names, numbers or vehicle details;
confirm time and price with them before confirm_booking; give them the booking_ref; if a business is paused, tell them to phone.

## FASTEST (any assistant that can open a web address): one read, one booking
Open https://bookings.thecloudcaller.com/b/<business_id>/agent/next?name=<their name>&phone=<their mobile>&email=<their email>&<detail_key>=<value>&via=<your name>
It lists the next free times, each with a ready "book" address. If your user already asked for that exact time, open it: booked in one step, reference returned.
Otherwise show them the times, then open the one they pick.

## Step by step (hold first, then confirm):
1. Free times: GET https://bookings.thecloudcaller.com/api/v1/businesses/<business_id>/availability?date=YYYY-MM-DD
2. Hold: GET https://bookings.thecloudcaller.com/b/<business_id>/agent/hold?time=<slot start, URL-encoded>&name=<their name>&phone=<their mobile>&email=<their email>&<detail_key>=<value>&via=<your name>
   The answer tells you what is missing or gives you a private confirm address. The slot is held for 10 minutes.
3. Read the time and details back to your user. When they say yes, open the confirm address. You get the booking reference; give it to them.
Only use details your user gave you. Never confirm without their yes.

## Or give your user a booking link to confirm themselves
1. Read free times: GET https://bookings.thecloudcaller.com/api/v1/businesses/<business_id>/availability?date=YYYY-MM-DD  (or open https://bookings.thecloudcaller.com/b/<business_id>)
2. Build: https://bookings.thecloudcaller.com/b/<business_id>/book?time=<slot start, URL-encoded>&name=<their name>&phone=<their mobile>&email=<their email>&<detail_key>=<value>&via=<your name, e.g. ChatGPT>
   Detail keys are in get_business -> required_details.
3. Give the link to your user. They see everything filled in and tap Confirm. Nothing is booked until they do.
   Leave out anything they haven't told you; the page asks them for it. Never guess.

## Businesses
- ammacatize-com: Ammacatize (professional, Sippy Downs, Sunshine Coast QLD (video call))
- ammacatize-ai: Ammacatize AI (professional, Sippy Downs, Sunshine Coast QLD (video call))
- coast-car-service: Coast Car Service Centre (demo) (automotive, Sunshine Coast QLD (demo venue))
- coast-thai-takeaway: Coast Thai Takeaway (demo) (takeaway, Sunshine Coast QLD)
- coastal-links-golf: Coastal Links Golf Club (demo) (golf, Sunshine Coast QLD (demo venue))
- coastal-physio: Coastal Physio Clinic (demo) (clinic, Sunshine Coast QLD (demo venue))
- daves-plumbing: Dave's Plumbing (demo) (trades, Sunshine Coast QLD (demo venue))