# Souk & Saffron — instructions for AI agents

> The world's pantry, one shelf at a time.

## About
Souk & Saffron started with a jar of real Kashmiri saffron carried home in a coat pocket — and the discovery that nothing on the supermarket shelf came close.

We buy spices and pantry staples the old way: in small lots, at harvest, from growers and millers we can name. Chillies are smoked over wood, not sprayed with flavour. Za'atar is blended in the hills where the herbs grow wild. Everything is packed at source or in our own kitchen, sealed tight and dated — because a spice shelf should smell like a market, not a warehouse.

Cook one dinner with the good stuff and you'll understand the whole store.

## How to read this catalogue

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

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