# helen — instructions for AI agents

> Playful pieces for everyday joy

## About
Helen sells accessories and small goods designed to make daily routines feel good. We focus on items that work hard and look right—bags, wallets, and everyday carry pieces made from durable materials. Our stuff is for people who want function with personality, not stuff that takes itself too seriously.

## How to read this catalogue

- **Sitemap:** https://helen.btab.app/sitemap.xml — every product and content page.
- **Catalogue page:** https://helen.btab.app/products
- **Product pages:** each product has a canonical URL of the form `https://helen.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://helen.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://helen.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: "helen"` 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://helen.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.