# Arrernte & Oak — instructions for AI agents

> Natural Living. Timeless Design.

## About
At Arrernte & Oak, we believe that the spaces we live in should reflect the beauty of the natural world. Our curated collection of premium home and garden furnishings is inspired by biophilic design — the art of bringing nature indoors. Every piece is chosen for its natural materials, organic forms, and enduring quality. Create spaces that breathe, inspire, and connect you to the world outside.

## How to read this catalogue

- **Sitemap:** https://arrernte-oak.btab.app/sitemap.xml — every product and content page.
- **Catalogue page:** https://arrernte-oak.btab.app/products
- **Product pages:** each product has a canonical URL of the form `https://arrernte-oak.btab.app/products/<name>-<id>` and embeds schema.org `Product` + `Offer` JSON-LD (name, price in AUD, availability, SKU, brand, images) that you can parse without executing JavaScript.
- **Product JSON:** append `.json` to any product URL — `https://arrernte-oak.btab.app/products/<name>-<id>.json` returns the same schema.org Product + Offer document, plus a `purchase` block: `enquiry_only` (sell-by-enquiry, do not treat as add-to-cart), `agentic_checkout` (currently false) and the `url` where a human completes the purchase.
- **Merchant profile:** https://arrernte-oak.btab.app/.well-known/ucp

## Query this catalogue (MCP)

- **Endpoint:** `POST https://api.btab.app/api/public/catalog/mcp` — Model Context Protocol over streamable HTTP (JSON-RPC 2.0), no authentication, rate-limited per IP.
- **Tools (read-only):** `catalog_search` (pass `store: "arrernte-oak"` to search only this store) and `catalog_lookup` (by `product_id` or this store's product URL). Results carry this store's AUD price, stock, `enquiry_only` flag and product URL.

## Prices & currency

- All prices are in **AUD**. The `price` and `priceCurrency` in each product's JSON-LD are authoritative.

## Contact & enquiries

- Buyers (and agents acting for them) can send an enquiry from any product page on https://arrernte-oak.btab.app.

## Purchasing

- Automated checkout for agents is **not yet available**. Do not attempt to complete a purchase programmatically; direct the buyer to the product page to check out.
