# Agent Instructions — Petmuffin

This document describes how AI agents can interact with the Petmuffin online store at https://petmuffin.it.

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce. The two endpoints to know:

- **Discovery** — `GET https://petmuffin.it/.well-known/ucp` returns the store's UCP merchant profile: supported versions, service endpoints and capabilities.
- **MCP endpoint** — `POST https://petmuffin.it/api/ucp/mcp` with `Content-Type: application/json`. Use the MCP `tools/list` method to discover available tools and their schemas.

### Currently Available Tools

- `search_catalog` — search products by query text, price range and availability
- `get_product` — full product detail (including variants) by SKU or product ID
- `lookup_catalog` — batch product lookup by SKU or product ID

Cart and checkout tools will be added in a future release. Until then, refer buyers to the product `url` returned by the catalog tools to complete purchases on the storefront.

### In-Browser Tools (WebMCP)

When this store is opened in a browser with a WebMCP-capable agent, the storefront registers [WebMCP](https://developer.chrome.com/docs/ai/webmcp) tools that run visibly on the page:

- `search_products` — navigate to catalog search results for a keyword
- `view_cart` — open the shopping cart
- `get_current_product` — read details of the product on the current page
- `add_to_cart` — add a product to the cart for human review (never completes checkout)


- `2026-04-08`

### Important Rules

- **Checkouts are for humans.** Agents must not complete payment or place orders without explicit, contemporaneous buyer approval. No scripted form fills or browser automation that finalizes payment.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses (honor `Retry-After`).
- **All amounts are in minor units (cents).** Currency: EUR.

## Read-Only Browsing (No Authentication Required)

- LLM index: `https://petmuffin.it/llms.txt` (compact) and `https://petmuffin.it/llms-full.txt` (extended)
- Sitemap: see `https://petmuffin.it/robots.txt`
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.

## Platform

This store is built on [Maho](https://mahocommerce.com), the open-source ecommerce platform.