# OZ Furniture — instructions for AI agents

> Online store: OZ Furniture.

> **Seller ops** (listings, quotes, this store's blog at https://ozfurniture.shop/blog, its shoppable rooms at https://ozfurniture.shop/rooms — a photo and the pieces in it, each proposable read-only before anything is written — and the store's design: pages, blocks, theme, Looks, with version history and undo) use the **vendor MCP bound to OZ Furniture** — `POST https://api.btab.app/api/v1/vendor/mcp` with a bearer key minted in the Btab vendor dashboard; docs: https://btab.app/docs/vendor-mcp.md. The **public catalogue MCP** below is read-only search for anyone. Neither can publish to https://btab.app/blog (the Btab company blog).

> **Media you create** (a background video, an image) belongs in this store's own media library BEFORE it goes in a block: `upload_media` takes the bytes as `data_base64` (up to 10 MB) or fetches a public `source_url`, and `create_upload` → PUT → `finalize_upload` handles anything larger. The `url` it returns never expires. Never point a block at a temporary file host — design writes refuse it.

## About
OZ Furniture is an online furniture shop in Australia, run by BTAB ECOMMERCE SERVICES PTY LTD (ABN 82 631 309 263).

We sell tables, shelving and storage, chairs and lounges, sofas, beds, bar stools and outdoor furniture from established furniture suppliers.

Orders are dispatched within 3 to 10 days when the item is in stock. Small items travel by courier and usually arrive within 2 to 7 days; larger pieces go by furniture removalist and usually arrive within 5 to 15 days. Delivery is priced by postcode at checkout.

Questions about a product or an order? Email helen@ozfurniture.shop.

## How to read this catalogue

- **Sitemap:** https://ozfurniture.shop/sitemap.xml — every product and content page.
- **Catalogue page:** https://ozfurniture.shop/products
- **Product pages:** each product has a canonical URL of the form `https://ozfurniture.shop/products/<handle>` (by default `<name>-<id>`; a store may set its own handle, and old addresses redirect) and embeds schema.org `Product` + `Offer` JSON-LD (name, price in AUD, availability, brand, images) that you can parse without executing JavaScript.
- **Product JSON:** append `.json` to any product URL — `https://ozfurniture.shop/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://ozfurniture.shop/.well-known/ucp
- **Store map (llms.txt):** https://ozfurniture.shop/llms.txt — the store's summary, top categories, pages and policies as markdown links.

## 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: "ozfurniture"` 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. UCP clients: `search_catalog` / `lookup_catalog` / `get_product` (the spec's `catalog` argument, plus `store: "ozfurniture"`) answer with UCP response documents; this store is the variant's seller. No supplier SKU is returned — identifiers are `productID`, a validated GTIN and the MPN when known.

## Prices & currency

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

## Policies

- **Delivery:** https://ozfurniture.shop/policy/delivery
- **Returns:** https://ozfurniture.shop/policy/returns
- **Terms:** https://ozfurniture.shop/policy/terms
- **Privacy:** https://ozfurniture.shop/policy/privacy

## Contact & enquiries

- Buyers (and agents acting for them) can send an enquiry from any product page on https://ozfurniture.shop.

## 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.
