# Cabañas Don José | Mazamitla, Jalisco

> Public guest booking site for tenant `don-jose`.
> Prices and availability come from the tenant public REST API (OpenAPI below),
> not from scraping HTML. Booking CTAs are deep-links on this same guest host.

## Prefer REST over MCP for browsing agents

- ChatGPT web and similar browsers do **not** auto-bind MCP when visiting this site.
- `GET /guest-mcp` on the API is not a data endpoint; MCP requires Streamable HTTP **POST** after a manual plugin bind.
- Use OpenAPI + the quote/calendar REST routes below, then send humans to reserve URLs.

## Machine-readable contracts

- [Guest OpenAPI](https://api.xn--cabaasdonjose-lkb.com/openapi/guest.json): public catalog, availability, and stay quotes (no auth)
- [MCP discovery JSON](https://xn--cabaasdonjose-lkb.com/.well-known/mcp.json): optional MCP URL pointer (same as API OpenAPI)
- [This file](https://xn--cabaasdonjose-lkb.com/llms.txt): browsing-agent index
- [Well-known mirror](https://xn--cabaasdonjose-lkb.com/.well-known/llms.txt): same body as /llms.txt

## Public REST (prices / availability)

- Catalog cards: `GET https://api.xn--cabaasdonjose-lkb.com/properties/home-showcase`
- Property by UUID or slug: `GET https://api.xn--cabaasdonjose-lkb.com/properties/{identifier}`
- Property batch: `GET https://api.xn--cabaasdonjose-lkb.com/properties/multiple?propertiesIds[]={uuid}`
- Stay quotes (prices): `GET https://api.xn--cabaasdonjose-lkb.com/availability/booking-options?checkInDate=YYYY-MM-DD&checkOutDate=YYYY-MM-DD&adultsQuantity=N`
  - Optional query: `teenagersQuantity`, `childrenQuantity`, `babiesQuantity`, `petsQuantity`, `propertiesIds[]`
- Property calendar: `GET https://api.xn--cabaasdonjose-lkb.com/availability/property-calendar?propertyId={uuid}&startDate=YYYY-MM-DD&endDate=YYYY-MM-DD`
- Search restrictions: `GET https://api.xn--cabaasdonjose-lkb.com/availability/search-restrictions?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD`

## Booking deep-links (human CTA — this guest host)

After quoting via REST, send the guest to reserve on this site:

```
https://xn--cabaasdonjose-lkb.com/search/options?checkInDate=YYYY-MM-DD&checkOutDate=YYYY-MM-DD&adultsQuantity=N
```

Optional query params (same names as REST): `teenagersQuantity`, `childrenQuantity`, `babiesQuantity`, `petsQuantity`.

Property detail page (browse / calendar on site):

```
https://xn--cabaasdonjose-lkb.com/properties/{slug-or-uuid}
```

Do not invent checkout hold URLs; checkout requires a server-created hold session.

## Optional MCP (manual bind only)

- Streamable HTTP URL: `https://api.xn--cabaasdonjose-lkb.com/guest-mcp` (authentication: none; enable flag on API)
- Tools mirror the same public reads as OpenAPI (catalog, calendar, booking-options).
- Private Ops MCP at `/mcp` is **not** for guests and is not advertised here.

## Examples

1. List showcase → pick a property id/slug from OpenAPI/`home-showcase`.
2. Quote: call `booking-options` with dates + `adultsQuantity`.
3. Reply with price + CTA link to `/search/options?...` on this host.