# Agent Commerce Manifest — BestSelf Co.

BestSelf Co. sells analog productivity, relationship, conversation, and kids reflection tools. Store: https://bestself.co

## Structured Data (PDP)

All product pages include JSON-LD with:
- `Product` — name, brand, description, image, URL, category
- `AggregateOffer` — price, currency, availability, condition, seller
- `AggregateRating` — ratingValue and reviewCount when review metafields are present
- `FAQPage` — 3–7 real customer questions with concise answers; included only on the three key PDPs listed below (not all product pages)

FAQPage schema is live and validates in Google Rich Results Test on:
- https://bestself.co/products/self-journal
- https://bestself.co/products/intimacy-deck
- https://bestself.co/products/weekly-action-pad

## UCP Endpoints

- Discovery: `GET https://bestself.co/.well-known/ucp` — merchant profile, supported versions, capabilities
- MCP endpoint: `POST https://bestself.co/api/ucp/mcp` — use `tools/list` with a valid profile URI after discovering the merchant profile at `https://bestself.co/.well-known/ucp`

Supported UCP versions: `2026-04-08` (latest), `2026-01-23`

### Typical Agent Flow
1. `GET /.well-known/ucp` — discover capabilities
2. `search_catalog` — find products matching buyer intent
3. `create_cart` — add items
4. `create_checkout` — start purchase flow
5. `update_checkout` — set shipping address and method
6. `complete_checkout` — **buyer must approve payment**

### Important Rules
- Checkout requires human/buyer approval. Do not complete payment without explicit consent.
- Rate limits apply to the MCP endpoint. Back off on 429.
- Pass `context.address_country` and `context.currency` for accurate pricing and availability.

## Product Data (Read-Only, No Auth Required)

- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json` — includes variants, pricing, images, availability
- Collection JSON: `GET /collections/{handle}/products.json`
- Search: `GET /search?q={query}&type=product`
- Sitemap: `GET /sitemap.xml`

## Shipping & Returns

- Shipping policy: https://bestself.co/policies/shipping-policy
- Refund policy: https://bestself.co/policies/refund-policy

## Shop Skill (Recommended for Buy-For-Me Agents)

Install `https://shop.app/SKILL.md` for:
- Cross-store catalog search and price/discount discovery
- Buyer-approved checkout via Shop Pay
- Order tracking
- Reuse of saved buyer identity, address, and payment

## AI Buying Map

See https://bestself.co/llms.txt for intent-based product recommendations and buying guide.

## Platform

This store runs on Shopify. Shopify stores support UCP natively.
