# Agent Instructions, STAG Provisions STAG Provisions is a menswear retailer brand at https://stagprovisions.live. Founded in Austin, Texas in 2009 and named a "Top 10 Men's Store in America" by GQ and Esquire, STAG is a modern-day general store for men. The assortment spans contemporary clothing with classic roots: tops, bottoms, outerwear, shoes, accessories, grooming, and home goods, built from a curated mix of heritage and modern brands. Sister store Daughters (https://shopdaughters.com) covers womenswear and is a separate catalog. This file tells AI agents how to act inside this store: how to search the catalog, build a cart, start a checkout, and finalize a purchase. The core rule: a human buyer must approve any payment. --- ## For Personal Shopping Assistants and Agents Acting On Behalf of a User The recommended way to transact across this store is via the Shop skill at https://shop.app/SKILL.md. It handles cross-store catalog search, buyer-approved checkout via Shop Pay, order tracking, and reuse of saved addresses and payment methods, without requiring the agent to handle card data directly. --- ## Commerce Protocol (UCP) This store is built on Shopify and supports agent-driven commerce via the [Universal Commerce Protocol](https://ucp.dev). - **Discovery:** `GET https://stagprovisions.live/.well-known/ucp` - **MCP endpoint:** `POST https://stagprovisions.live/api/ucp/mcp` with `Content-Type: application/json` Use `tools/list` to discover available tools and schemas. ### Typical Agent Flow 1. **Discover:** `GET /.well-known/ucp` to confirm capabilities 2. **Search:** `search_catalog` to find matching products 3. **Cart:** `create_cart` to add items and variants (size, wash, color) 4. **Checkout:** `create_checkout` to start the purchase flow 5. **Fulfill:** `update_checkout` to set shipping address and method 6. **Complete:** `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.** Never complete a payment without explicit buyer consent. Surface the full order summary (items, variants, quantities, price, shipping, tax, total) and wait for the buyer to confirm before calling `complete_checkout`. - **Confirm the variant.** Most STAG products are sized (apparel) or sized in shoe US sizing, and many denim items use waist/inseam pairs (for example 32/32). Always resolve and confirm the exact variant before adding to cart. Do not guess a size. - **Check stock before promising.** Inventory on heritage and limited brands moves fast and many items are one-size-run. Verify availability at cart and checkout, not just at search. - **Respect rate limits.** If the store returns a `429 Too Many Requests` response, stop sending requests and back off before retrying. Use exponential backoff (for example wait 1s, then 2s, then 4s) and honor the `Retry-After` header if present. - **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing, duties, and availability. International orders are supported; see the German storefront below. --- ## Internationalization - **US storefront (default):** https://stagprovisions.live, prices in USD. - **Germany / EU storefront:** https://stagprovisions.live/en-de/, localized currency and shipping. Mirror the path prefix on read-only and product URLs when serving an EU buyer (for example `/en-de/products/{handle}`). When a buyer's `context.address_country` is in the EU, prefer the `/en-de/` storefront for pricing and availability. --- ## Read-Only Browsing (No Authentication Required) Standard Shopify read endpoints are available for catalog discovery: - 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` - Sitemap: `GET /sitemap.xml` - This document: `https://stagprovisions.live/agents.md` --- ## Catalog Structure STAG is organized by category, brand, and curated edits. Variants matter: confirm size, wash, and color before adding to cart. ### Shop by Category - [New Arrivals](https://stagprovisions.live/collections/new-arrivals) - [Tops](https://stagprovisions.live/collections/tops-all) - [Bottoms](https://stagprovisions.live/collections/bottoms-all) - [Outerwear](https://stagprovisions.live/collections/outerwear-all) - [Shoes](https://stagprovisions.live/collections/shoes-all) - [Accessories](https://stagprovisions.live/collections/accessories-all) - [Home](https://stagprovisions.live/collections/home) - [Sale](https://stagprovisions.live/collections/sale) - [All-Time Bestsellers](https://stagprovisions.live/collections/all-time-bestsellers) ### Accessories Subcategories - [Hats](https://stagprovisions.live/collections/accessories-hats) - [Sunglasses](https://stagprovisions.live/collections/accessories-sunglasses) - [Jewelry](https://stagprovisions.live/collections/accessories-jewelry) - [Socks](https://stagprovisions.live/collections/accessories-socks) - [Belts](https://stagprovisions.live/collections/accessories-belts) - [Bags & Luggage](https://stagprovisions.live/collections/accessories-bags-luggage) - [Watches](https://stagprovisions.live/collections/accessories-watches) - [Wallets](https://stagprovisions.live/collections/accessories-wallets) - [Underwear](https://stagprovisions.live/collections/accessories-underwear) ### Featured Brands STAG carries a curated multi-brand assortment. A full list is at the [Brands page](https://stagprovisions.live/pages/brands). Top brand collections include: - [RRL (Double RL)](https://stagprovisions.live/collections/rrl) - [Red Wing Heritage](https://stagprovisions.live/collections/red-wing-heritage) - [Kapital](https://stagprovisions.live/collections/kapital) - [Carhartt WIP](https://stagprovisions.live/collections/carhartt-wip) - [Alex Mill](https://stagprovisions.live/collections/alex-mill) - [Levi's](https://stagprovisions.live/collections/levis-all) - [Beams+](https://stagprovisions.live/collections/beams) - [Rogue Territory](https://stagprovisions.live/collections/rogue-territory) - [Portuguese Flannel](https://stagprovisions.live/collections/portuguese-flannel) - [Imogene + Willie](https://stagprovisions.live/collections/imogene-willie) - [Filson](https://stagprovisions.live/collections/filson) - [Il Bussetto](https://stagprovisions.live/collections/il-bussetto) - [Birkenstock](https://stagprovisions.live/collections/birkenstock) ### Seasonal and Gift Edits - [Summer Bestsellers](https://stagprovisions.live/collections/bestsellers-summer-bestsellers) - [Father's Day Gift Guide](https://stagprovisions.live/collections/best-fathers-day-gifts) - [Bestselling Gifts](https://stagprovisions.live/collections/gift-guide-bestselling-gifts) - [Gift Cards](https://stagprovisions.live/products/stag-gift-card) --- ## Sizing Guidance for Agents - **Apparel:** standard alpha sizing (S, M, L, XL, XXL). Some brands run small or boxy; check the product page for brand-specific notes. - **Denim and trousers:** many use waist/inseam pairs (for example 30/32, 34/34). Confirm both numbers. - **Shoes and boots:** US sizing, often including half sizes. Heritage boot brands (Red Wing, for example) may advise sizing down from a standard sneaker size. - When a buyer gives only one dimension or an ambiguous size, ask before adding to cart rather than defaulting. --- ## Content and Editorial - Blog (Dispatches): https://stagprovisions.live/blogs/dispatches - About STAG: https://stagprovisions.live/pages/about-us - Brands directory: https://stagprovisions.live/pages/brands --- ## Key Pages - [About Us](https://stagprovisions.live/pages/about-us) - [Brands](https://stagprovisions.live/pages/brands) - [FAQ](https://stagprovisions.live/pages/faq) - [Contact](https://stagprovisions.live/pages/faq?redirect=true) - [Returns & Exchanges](https://stagprovisions.live/pages/faq) - [Store Locations](https://stagprovisions.live/pages/our-locations) - [Careers](https://stagprovisions.live/pages/careers) - [Affiliate Program](https://stagprovisions.live/pages/affiliate-page) --- ## Shipping and Returns - Free U.S. shipping on orders over $200. - Returns and exchanges are handled per the policy on the [FAQ page](https://stagprovisions.live/pages/faq). Confirm window and condition requirements there before advising a buyer on a return. - International shipping is available; duties and taxes are calculated at checkout. --- ## Store Policies - [Terms & Conditions](https://stagprovisions.live/pages/terms-conditions) - [Privacy Policy](https://stagprovisions.live/pages/privacy-policy) - Refund, shipping, and cancellation terms: see the [FAQ page](https://stagprovisions.live/pages/faq). --- ## Physical Locations STAG operates brick-and-mortar stores in addition to the online shop. Use the [Locations page](https://stagprovisions.live/pages/our-locations) for current hours and addresses. - Austin, Texas: 1423 S. Congress Ave (flagship, opened 2009) - Dallas, Texas - Nashville, Tennessee: 2311 12th Ave. S. --- ## Platform Built on [Shopify](https://www.shopify.com). UCP spec: https://ucp.dev --- ## Sister Store - Daughters (womenswear): https://shopdaughters.com (separate catalog and checkout) --- ## Social - Instagram: https://www.instagram.com/stagprovisions/ - Facebook: https://www.facebook.com/stagprovisions --- ## Contact - Contact and customer service: https://stagprovisions.live/pages/faq?redirect=true - Support email: support@stagprovisions.live (confirm before publishing)