# Agent Instructions — AnycoStore

You can browse products and shop at AnycoStore (https://anycostore.com) on your user's behalf. Anyco is an Australian-founded online store and distribution partner selling home and living essentials, kitchenware, jewellery and fashion accessories, tech gear, pet supplies and gifts to customers in Australia, New Zealand and worldwide.

## Read the store (no tools needed)

- **Index for language models:** https://anycostore.com/llms.txt (full text: https://anycostore.com/llms-full.txt)
- **Markdown of any page:** append `.md` to the URL, e.g. `https://anycostore.com/products/{handle}.md`, `https://anycostore.com/collections/{handle}.md`, home page `https://anycostore.com/index.md`. Each file starts with YAML front matter (price, currency, availability, brand, SKU, canonical URL).
- **Whole catalogue (1058 products):** https://anycostore.com/catalog.md or JSON at https://anycostore.com/feeds/products.json
- **Public URLs:** https://anycostore.com/sitemap.xml. HTML pages: `/products/{handle}`, `/collections/{handle}`, `/collections/all`, `/brands/{brand}`.
- **Company facts:** https://anycostore.com/facts.md (fact sheet + FAQ) or JSON at https://anycostore.com/facts.json.
- **Businesses:** partnership programs at https://anycostore.com/pages/explore-partnership.md; resellers and marketplace sellers see https://anycostore.com/wholesale.md; brands and suppliers entering Australia, New Zealand or global markets see https://anycostore.com/suppliers.md. Enquiries: https://anycostore.com/pages/contact-us (web form).

## Shop on the user's behalf (Shopify UCP)

Carts and checkout run on Shopify, which implements the [Universal Commerce Protocol](https://ucp.dev).

1. **Discover the store:** `GET https://anycostore.com/.well-known/ucp` returns the UCP profile (capabilities, service endpoints, payment handlers).
2. **Discover tools:** connect to the MCP endpoint advertised in that profile (`https://anycostore.com/api/ucp/mcp`) and call `tools/list`.
3. **Shop:** use those tools to find products, manage carts, prepare checkout and complete buyer-authorised purchases.

Alternatively use the [Shop skill](https://shop.app/SKILL.md), or the WebMCP tools exposed on the storefront and checkout pages when working in a browser. Details: [Shopify agent documentation](https://shopify.dev/docs/agents).

## Interaction guidelines

- **Buyer authorisation:** place orders and submit payment only with the buyer's explicit approval; follow every review step the checkout requests.
- **Identify agent traffic:** server-to-server requests and hosted browsers should use [Web Bot Auth](https://shopify.dev/docs/api/storefront#identifying-bots-with-web-bot-auth).
- **Do not script checkout forms.** If tools are unavailable, hand over to the buyer in the browser.
- **Rate limits:** back off on `429` and respect `Retry-After`.
- **Currency:** prices are in AUD.

## Contact

Anyco Pty Ltd · support@anycostore.com · 9:00am–5:00pm AEST, Monday–Friday