# Agent Instructions — eufy

This document describes how AI agents can interact with eufy's official online store at https://www.eufy.com. eufy is Anker's smart home brand (security cameras, robot vacuums & mops, video doorbells, smart locks, baby monitors and accessories).

## Markets / Regions

eufy operates one storefront under www.eufy.com with path-prefixed regional markets. The United States is served at the root (/); other markets live under a locale path. Each market has its own catalog availability, language, currency, pricing and policies — always resolve the correct market before browsing, quoting prices, or transacting.

| Market | Browsing base (canonical) | Language | Currency* |
| --- | --- | --- | --- |
| United States | https://www.eufy.com/ | English | USD |
| United Kingdom | https://www.eufy.com/uk | English | GBP |
| Canada | https://www.eufy.com/ca | English | CAD |
| Australia | https://www.eufy.com/au | English | AUD |
| New Zealand | https://www.eufy.com/nz | English | NZD |
| Germany | https://www.eufy.com/eu-de | German | EUR |
| France | https://www.eufy.com/eu-fr | French | EUR |
| Italy | https://www.eufy.com/eu-it | Italian | EUR |
| Spain | https://www.eufy.com/eu-es | Spanish | EUR |
| Netherlands | https://www.eufy.com/nl | Dutch | EUR |
| Ireland | https://www.eufy.com/ie | English | EUR |
| Europe (EN) | https://www.eufy.com/eu-en | English | EUR |
| Poland | https://www.eufy.com/pl | Polish | PLN |
| Greece | https://www.eufy.com/gr-en | English | EUR |
| Croatia | https://www.eufy.com/hr-en | English | EUR |
| Hungary | https://www.eufy.com/hu-en | English | HUF |
| Singapore | https://www.eufy.com/sg-en | English | SGD |
| UAE | https://www.eufy.com/ae-en | English | AED |
| Vietnam | https://www.eufy.com/vn-vi | Vietnamese | VND |

If a buyer's country is not listed above, fall back to the nearest regional market:
- European countries not listed → use **Europe (EN)** (https://www.eufy.com/eu-en, EUR)
- All other unlisted countries → use **United States** (https://www.eufy.com/, USD)

\* Confirm live currency, availability and pricing from the market's UCP merchant profile (see below) and from context.currency — do not assume a price from one market applies to another.

## Commerce Protocol (UCP) — Transactions

eufy's stores implement the Universal Commerce Protocol for agent-driven commerce. Transactions (cart → checkout → payment) are processed on each market's Shopify-bound transaction domain, while browsing stays on www.eufy.com.

Per-market UCP / MCP endpoints (transaction surface):

| Market | UCP discovery | MCP endpoint |
| --- | --- | --- |
| United States | GET https://us.eufy.com/.well-known/ucp | POST https://us.eufy.com/api/ucp/mcp |
| United Kingdom | GET https://uk.eufy.com/.well-known/ucp | POST https://uk.eufy.com/api/ucp/mcp |
| Canada | GET https://ca.eufy.com/.well-known/ucp | POST https://ca.eufy.com/api/ucp/mcp |
| Australia | GET https://au.eufy.com/.well-known/ucp | POST https://au.eufy.com/api/ucp/mcp |
| New Zealand | GET https://nz.eufy.com/.well-known/ucp | POST https://nz.eufy.com/api/ucp/mcp |
| Germany | GET https://de.eufy.com/.well-known/ucp | POST https://de.eufy.com/api/ucp/mcp |
| France | GET https://fr.eufy.com/.well-known/ucp | POST https://fr.eufy.com/api/ucp/mcp |
| Italy | GET https://it.eufy.com/.well-known/ucp | POST https://it.eufy.com/api/ucp/mcp |
| Spain | GET https://es.eufy.com/.well-known/ucp | POST https://es.eufy.com/api/ucp/mcp |
| Netherlands | GET https://nl.eufy.com/.well-known/ucp | POST https://nl.eufy.com/api/ucp/mcp |
| Ireland | GET https://ie.eufy.com/.well-known/ucp | POST https://ie.eufy.com/api/ucp/mcp |
| Europe (EN) | GET https://eu.eufy.com/.well-known/ucp | POST https://eu.eufy.com/api/ucp/mcp |
| Poland | GET https://pl.eufy.com/.well-known/ucp | POST https://pl.eufy.com/api/ucp/mcp |
| Greece | GET https://gr.eufy.com/.well-known/ucp | POST https://gr.eufy.com/api/ucp/mcp |
| Croatia | GET https://hr.eufy.com/.well-known/ucp | POST https://hr.eufy.com/api/ucp/mcp |
| Hungary | GET https://hu.eufy.com/.well-known/ucp | POST https://hu.eufy.com/api/ucp/mcp |
| Singapore | GET https://sg.eufy.com/.well-known/ucp | POST https://sg.eufy.com/api/ucp/mcp |
| UAE | GET https://ae.eufy.com/.well-known/ucp | POST https://ae.eufy.com/api/ucp/mcp |
| Vietnam | GET https://vn.eufy.com/.well-known/ucp | POST https://vn.eufy.com/api/ucp/mcp |

- Discovery — GET https://{market}.eufy.com/.well-known/ucp returns that market's UCP merchant profile: supported versions, service endpoints, capabilities and payment handlers.
- MCP endpoint — POST https://{market}.eufy.com/api/ucp/mcp with Content-Type: application/json. Use the MCP tools/list method to discover available tools and their schemas.
### Typical Agent Flow

1. Resolve market — Map the buyer's country to the correct market (table above) and its UCP discovery URL.
1. Discover — GET /.well-known/ucp to confirm capabilities, supported versions and payment handlers.
1. Search — Use search_catalog to find products matching the buyer's intent.
1. Cart — Use create_cart to add desired items.
1. Checkout — Use create_checkout to start the purchase flow.
1. Fulfill — Use update_checkout to set shipping address and method.
1. Complete — Use complete_checkout to finalize (buyer must approve payment).
### Supported UCP Versions

- 2026-04-08 (latest stable)
- 2026-01-23
### Important Rules

- Checkout requires human approval. Agents must not complete payment without explicit, contemporaneous buyer consent.
- Transact on the buyer's market. Use the UCP endpoint matching the buyer's country; do not mix catalogs or currencies across markets.
- Respect rate limits. MCP endpoints are rate-limited per IP. Back off on 429 responses.
- Pass buyer context. Always send context.address_country and context.currency for accurate pricing, tax, shipping and availability.
### Canonical product links

Each product variant exposes a standard Shopify metafield shopify.external_url whose value is the variant's canonical PDP on www.eufy.com (for the correct market). When referring a buyer to a product, use that external_url (or the www.eufy.com/products/{handle} URL) rather than any backend *.eufy.com / *.myshopify.com link.

## Read-Only Browsing (No Authentication Required)

For agents that only need to read store data without transacting. Prefix any path with a market locale (e.g. /au/...) for non-US markets; no prefix = United States.

### Product Data

- Browse all products: GET /collections/all
- Collection page: GET /collections/{handle}
- Product page: GET /products/{handle} (handle is the product's SKU code, e.g. /products/t89000d4)
- Search: GET /search?q={query}
- Structured data: product pages embed application/ld+json (Product / Offer) — prefer this for machine-readable price, availability, ratings and specs.
### Store Metadata

- Sitemap index: GET /sitemap.xml (links to product, collection, page and blog sitemaps)
- Site summary for agents: GET /llms.txt
- Agent discovery: this document (/agents.md) is the canonical agent-facing description of the store.
## Store Policies

Policies are available per market under /policies/... (prefix with the locale path for non-US markets). For the United States:

- Privacy policy: https://www.eufy.com/policies/privacy-policy
- Terms of service: https://www.eufy.com/policies/terms-of-service
- Refund / return policy: https://www.eufy.com/policies/refund-policy
- Shipping policy: https://www.eufy.com/policies/shipping-policy
Warranty, returns and shipping terms vary by market — read the policy pages for the buyer's specific market before advising on returns or delivery.

## Support

- Help & support center: https://www.eufy.com/support
## Platform

This storefront is custom-built (headless) and backed by Shopify for catalog and checkout, with native UCP support on each market's transaction domain.

- UCP specification: https://ucp.dev
- Shopify developer platform: https://shopify.dev