# Agent Instructions - Fitchs Pharmacy

This document describes how AI agents can interact with Fitchs Pharmacy's
online store at https://fitchs.com.au/.

Fitchs Pharmacy is an Australian online pharmacy and health store. Prices are
listed in Australian dollars (AUD) and are inclusive of GST (10%). We welcome
orders placed on behalf of customers by AI shopping agents and assistants.

## Commerce Protocols

Two agent-commerce protocols are supported. The endpoints to know:

- **UCP (Universal Commerce Protocol) discovery** - `GET https://fitchs.com.au/.well-known/ucp`
  returns the store's UCP merchant profile: supported version, service
  endpoints, capabilities, and payment handlers.
- **UCP MCP endpoint** - `POST https://fitchs.com.au/api/ucp/mcp` with
  `Content-Type: application/json`. Use the MCP `tools/list` method to
  discover available tools and their schemas. (Advertised in the UCP profile
  services array when enabled.)
- **ACP (Agentic Commerce Protocol) discovery** - `GET https://fitchs.com.au/rest/V1/acp/discovery`
  returns supported API versions, service endpoints and capabilities.

### Typical Agent Flow (UCP)

1. **Discover** - `GET https://fitchs.com.au/.well-known/ucp` to confirm capabilities
2. **Search** - `POST https://fitchs.com.au/rest/V1/ucp/catalog/search` to find products matching the buyer's intent
3. **Cart** - `POST https://fitchs.com.au/rest/V1/ucp/carts` to add desired items
4. **Checkout** - `POST https://fitchs.com.au/rest/V1/ucp/checkout-sessions` to start the purchase flow
5. **Fulfil** - `PUT https://fitchs.com.au/rest/V1/ucp/checkout-sessions/{id}` to set the shipping address and method
6. **Complete** - `POST https://fitchs.com.au/rest/V1/ucp/checkout-sessions/{id}/complete` to finalize (the buyer must approve payment)

UCP API endpoints require platform onboarding (API key + HTTP message
signatures per RFC 9421); the discovery profile itself is public.

### Typical Agent Flow (ACP)

1. **Discover** - `GET https://fitchs.com.au/rest/V1/acp/discovery`
2. **Create session** - `POST https://fitchs.com.au/rest/V1/acp/checkout_sessions`
3. **Update session** - `POST https://fitchs.com.au/rest/V1/acp/checkout_sessions/{id}` (items, address, fulfillment)
4. **Complete** - `POST https://fitchs.com.au/rest/V1/acp/checkout_sessions/{id}/complete` with the delegated payment token (the buyer must approve payment)
5. **Cancel** - `POST https://fitchs.com.au/rest/V1/acp/checkout_sessions/{id}/cancel` if the purchase is abandoned; sessions also expire automatically.

### Supported Protocol Versions

- UCP: 2026-04-08
- ACP: 2026-04-17

### Important Rules

- **Checkout requires human approval.** Agents must not complete payment
  without explicit, contemporaneous buyer consent.
- **Respect rate limits.** Back off on `429` responses.
- **Use buyer context.** Pricing and availability assume Australian buyers:
  currency `AUD`, country `AU`.
- **Prescription medicines are excluded.** Prescription-only medicines are
  **not** available for purchase through agentic/AI-assisted checkout (ACP or
  UCP). These items require pharmacist review and, where required, a valid
  prescription, and must be purchased directly by the customer through the
  storefront or in-store. Agents attempting to add a prescription-only item
  to an agentic checkout session should expect it to be rejected with a
  `messages[]` error rather than completed.

## Read-Only Browsing (No Authentication Required)

For agents that only need to read catalog data without transacting:

- Product search: `GET https://fitchs.com.au/rest/V1/agentic/products?search={query}&page={n}&pageSize={n}` (pageSize max 50)
- Browse all products: `GET https://fitchs.com.au/rest/V1/agentic/products` (stable SKU order, paginated)
- Product by SKU: `GET https://fitchs.com.au/rest/V1/agentic/products/{sku}` (returns the full variant family)
- Storefront search (HTML): https://fitchs.com.au/catalogsearch/result/?q={query}

Prices are ISO 4217 minor units (cents), AUD, GST-inclusive - identical to
the checkout protocols, which serve from the same catalog projection.

## Store Metadata

- Sitemap: https://fitchs.com.au/sitemap.xml
- Agentic discovery sitemap: https://fitchs.com.au/sitemap_agentic_discovery.xml
- LLM summary: https://fitchs.com.au/llms.txt
- This document (`/agents.md`) is the canonical agent-facing description of the store.

## Store Policies

- Shipping policy: https://fitchs.com.au/shipping-policy
- Returns policy: https://fitchs.com.au/refunds-and-returns
- Privacy policy: https://fitchs.com.au/privacy-policy-cookie-restriction-mode
- Terms of use: https://fitchs.com.au/customer-service

## Platform

Built on Adobe Commerce (Magento Open Source 2.4). The agentic surfaces (ACP
and UCP) are implemented by Fitchs' first-party modules.

## Contact

For questions about agentic ordering, contact Fitchs Pharmacy via the
storefront contact page: https://fitchs.com.au/contact