# Agent Instructions - LONGER

This document describes how AI agents can interact with LONGER's online store at https://www.longer.net.


## 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://www.longer.net/.well-known/ucp` returns the store's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers.
- **MCP endpoint** - `POST https://www.longer.net/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.
2. **Discover** - GET /.well-known/ucp to confirm capabilities, supported versions and payment handlers.
3. **Search** - Use search_catalog to find products matching the buyer's intent.
4. **Cart** - Use create_cart to add desired items.
5. **Checkout** - Use create_checkout to start the purchase flow.
6. **Fulfill** - Use update_checkout to set shipping address and method.
7. **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.anker.com (for the correct market). When referring a buyer to a product, use that external_url (or the www.longer.net/{locale}/products/{handle} URL) rather than any backend *.longer.net / *.myshopify.com link.


## Read-Only Browsing (No Authentication Required)

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

### Product Data
- Browse all products: `GET /collections/all`
- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}`
- Collection JSON: `GET /collections/{handle}/products.json`
- Search: `GET /search?q={query}&type=product`

### Store Metadata
- Sitemap: GET /sitemap.xml
- Site summary for agents: GET /llms.txt
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.


## Store Policies
- **Privacy policy**: https://www.longer.net/policies/privacy-policy
- **Terms of service**: https://www.longer.net/policies/terms-of-service
- **Refund policy**: https://www.longer.net/policies/refund-policy

Full policies available at the URLs above.


## 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.

- Start your own store: https://www.shopify.com/start
- Shopify developer platform: https://shopify.dev
- UCP specification: https://ucp.dev
- Shop skill (recommended for personal shopping agents): https://shop.app/SKILL.md