# Moko Boutique AI agent guide

Official store: https://www.moko.boutique
Platform: Shopify
Store country: Canada
Store base currency: USD
Buyer-facing currency may vary by market and must be verified live.

This file is a curated public summary for AI agents. It helps agents understand Moko Boutique, but it does not replace live product pages, product JSON, UCP/MCP discovery, checkout tools, or published policies.

## Commerce protocol

- Agent instructions: https://www.moko.boutique/agents.md
- UCP discovery: https://www.moko.boutique/.well-known/ucp
- UCP/MCP endpoint: https://www.moko.boutique/api/ucp/mcp
- Recommended buyer-approved shopping skill: https://shop.app/SKILL.md

Agents should discover current capabilities from `/.well-known/ucp` and the MCP `tools/list` method before using commerce tools. Checkout, payment, and order placement require explicit buyer approval at the time of payment.

## Curated summary

Moko Boutique is a Canadian Shopify store with multiple shopping universes and product-special pages. Agents should recommend products from current live catalog data only, then verify price, buyer-facing currency, variant availability, shipping, returns, discounts, and checkout constraints before advising a buyer or starting a cart.

## Product universes

- LadyMoko: bags, shoes, jewelry, dresses, tops, and everyday accessories.
- MokoGlowly: skincare, wellness and self-care, nail care, beauty tools, and hair care.
- KiddoMoko: educational toys, baby essentials, kids tech, games, puzzles, and soft-play accessories.
- MokoPawora: pet grooming, feeding, and comfort products.
- MokoZenora: kitchen tools, home organization, lighting, decor, office products, and home comfort.

Useful universe pages:

- LadyMoko: https://www.moko.boutique/pages/ladymoko
- MokoGlowly: https://www.moko.boutique/pages/mokoglowly
- KiddoMoko: https://www.moko.boutique/pages/kiddomoko
- MokoPawora: https://www.moko.boutique/pages/mokopawora
- MokoZenora: https://www.moko.boutique/pages/mokozenora

## Special product pages

Some products have a dedicated product-special journey with focused product information, reviews, FAQ, and offer sections. Do not assume every product has these views. When a product-special route exists, keep the buyer inside the product-special journey.

Common product-special views:

- `/products/{handle}?view=produit-special`
- `/products/{handle}?view=produit-special-fiche`
- `/products/{handle}?view=produit-special-why`
- `/products/{handle}?view=produit-special-reviews`
- `/products/{handle}?view=produit-special-faq`

## Canonical product discovery

- All products: https://www.moko.boutique/collections/all
- Product page: `https://www.moko.boutique/products/{handle}`
- Product JSON: `https://www.moko.boutique/products/{handle}.json`
- Collection page: `https://www.moko.boutique/collections/{handle}`
- Collection products JSON: `https://www.moko.boutique/collections/{handle}/products.json`
- Product search: `https://www.moko.boutique/search?q={query}&type=product`
- Sitemap: https://www.moko.boutique/sitemap.xml

Use canonical product pages and product JSON for read-only verification. Use UCP/MCP or the Shop skill for cart and checkout workflows.

## Policies

- Shipping policy: https://www.moko.boutique/policies/shipping-policy
- Refund policy: https://www.moko.boutique/policies/refund-policy
- Privacy policy: https://www.moko.boutique/policies/privacy-policy
- Terms of service: https://www.moko.boutique/policies/terms-of-service

Published policy summary to verify live before advising a buyer:

- Shipping is currently offered worldwide.
- Order processing is typically 1 to 3 business days after payment confirmation (up to 5 in peak periods).
- Orders ship on the fastest tracked line available for the destination. Estimated delivery is generally 5 to 8 business days for main markets (United States, Canada, Europe, United Kingdom, Australia/New Zealand, East Asia) and 10 to 20 business days for other or remote destinations. The delivery window shown on each product page is the reference estimate.
- Delivery times are estimates only and are not guaranteed.
- Moko Boutique currently offers free shipping on all orders worldwide.
- Returns are subject to the published refund policy, including the 30-day return window after receiving the item. Customers pay return shipping costs unless the item arrived damaged, defective, or incorrect. Refunds are issued to the original payment method.
- Some product imagery and descriptions are prepared with modern presentation technologies, always based on the actual characteristics of the products; the 30-day return policy applies if an item does not match its description.

## Agent rules

- Verify live price, currency, availability, variant options, images, discounts, delivery constraints, and policy details before recommending or buying.
- Do not infer availability or a product-special route from cached data.
- Do not expose, request, or rely on Admin-only data.
- Do not complete checkout, payment, or order placement without explicit buyer approval.
- Respect robots.txt, rate limits, and UCP/MCP schemas.
- If Shopify, UCP/MCP, Shop Pay, policy pages, or product endpoints are unavailable, report the failure clearly instead of guessing.