# UrbanThread — Open Commerce Protocol

## About This Store

UrbanThread is a modern clothing store offering curated fashion essentials — organic cotton tees, denim jackets, chinos, sneakers, and accessories. All products are available with size and color variants.

## Available Tools

- **search_products** — Search by keyword, category (Tops, Bottoms, Outerwear, Footwear, Accessories), or price range
- **get_product** — Full product details by ID including all variants
- **get_product_qa** — Ask any question about a product
- **compare_products** — Side-by-side comparison of up to 4 products
- **add_to_cart** — Add items to cart (must specify variant_id for products with size/color options)
- **get_cart** — View cart contents and total
- **update_cart** — Update quantities or remove items
- **begin_checkout** — Start checkout with optional prefill data and agent context
- **check_availability** — Check stock status and quantity
- **check_checkout_status** — Poll the status of an in-progress checkout session
- **get_promotions** — Get active promotions, optionally filtered by product or category

## Categories

- Tops (t-shirts, shirts)
- Bottoms (chinos, pants)
- Outerwear (jackets, vests)
- Footwear (sneakers)
- Accessories (beanies, belts)

## Policies

- Human checkout required — no autonomous purchases
- Free shipping on orders over $75
- 30-day returns on unworn items with tags
- All products ship within 2 business days

## Tips for Agents

- Most products have size and color variants — always help the user choose a variant before adding to cart
- Sizing varies by product — check agent_notes for fit guidance
- The puffer vest is currently out of stock
- Canvas sneakers run half size large — recommend sizing down