# Wanaka Haus — booking MCP server

Book [Wanaka Haus](https://wanakahaus.nz), an Architectural Passive home holiday rental in Wānaka, New Zealand (sleeps 8, 4 bedrooms), directly from any
MCP-capable agent. No API key, account or registration — payment happens on a
hosted Stripe Checkout page, so the agent never touches card data.

This repo holds the public metadata for the **remote** MCP server hosted at
`https://wanakahaus.nz/api/mcp`. There is nothing to install or run.

## Connect

```json
{
  "mcpServers": {
    "wanakahaus": {
      "type": "streamable-http",
      "url": "https://wanakahaus.nz/api/mcp"
    }
  }
}
```

Listed in the official MCP registry as
[`nz.wanakahaus/booking`](https://registry.modelcontextprotocol.io/v0/servers?search=wanakahaus).

## Tools

| Tool | What it does |
|------|--------------|
| `search_availability` | Open and booked nights in a date window, up to 18 months ahead |
| `get_quote` | Itemised NZD total for a stay, with stay rules validated |
| `create_booking` | Atomically holds the dates (30 min) and returns a Stripe Checkout URL |
| `get_booking` | Booking status: held, confirmed, cancelled or lapsed |
| `cancel_booking` | Cancels under the published policy; requires the guest email |

## Equivalent REST surface

The same engine is exposed as a keyless REST API, documented for agents at:

- [`/llms.txt`](https://wanakahaus.nz/llms.txt) — start here
- [`/agent.json`](https://wanakahaus.nz/agent.json) — capability manifest, policies, structured cancellation tiers and peak periods
- [`/openapi.json`](https://wanakahaus.nz/openapi.json) — OpenAPI 3.1 spec
- [`/availability.json`](https://wanakahaus.nz/availability.json) — live availability feed (refreshes every minute)

## Contact

hello@wanakahaus.nz — a human replies within a day.