agents.md
Agent Commerce Manifest — BestSelf Co.
BestSelf Co. sells analog productivity, relationship, conversation, and kids reflection tools.
Structured Data (PDP)
All product pages include JSON-LD with:
Product— name, brand, description, image, URL, categoryAggregateOffer— price, currency, availability, condition, sellerAggregateRating— ratingValue and reviewCount when review metafields are presentFAQPage— 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 /.well-known/ucp— merchant profile, supported versions, capabilities - MCP endpoint:
POST /api/ucp/mcp— usetools/listwith a valid profile URI after discovering the merchant profile at/.well-known/ucp
Supported UCP versions: 2026-04-08 (latest), 2026-01-23
Typical Agent Flow
GET /.well-known/ucp— discover capabilitiessearch_catalog— find products matching buyer intentcreate_cart— add itemscreate_checkout— start purchase flowupdate_checkout— set shipping address and methodcomplete_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_countryandcontext.currencyfor 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/suggest.json?q={query}&resources[type]=product— structured JSON endpoint; do not use the HTML/searchpage - 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 /llms.txt for intent-based product recommendations and buying guide.
Platform
This store runs on Shopify. Shopify stores support UCP natively.