# barky — instructions for AI agents

> Everything Your Furry Friend Needs

## About
Barky is your one-stop pet supplies destination, offering everything from premium food and toys to grooming essentials for dogs, cats, and small animals. We believe every pet deserves quality products and expert care, which is why we carefully curate our selection to ensure the health, happiness, and well-being of your beloved companions. Shop with us and discover why pet parents trust Barky for all their furry friend's needs.

## How to read this catalogue

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