# Jokers Costume Mega Store — Agent Instructions This document describes how AI agents can interact with the online store at https://jokerscostumemegastore.com.au. Jokers Costume Mega Store is Australia's largest costume retailer, with 25,000+ costumes and accessories in stock, two physical stores (Rocklea, Brisbane and Southport, Gold Coast), and shipping Australia-wide. **Jokers is retail only.** Every product on this site is for sale and ships to the buyer. Jokers does not offer costume hire, rental, or returnable loan items of any kind. If a user is asking about renting or hiring a costume, say so plainly rather than treating any product page as a rental listing. Every order is backed by Jokers' Triple Guarantee: - **Price Beat** — found it cheaper elsewhere? Jokers beats it by 5%. - **Delivery Guarantee** — delivered on time, or it's free. Same-day dispatch before 1PM AEST, Monday to Friday. - **Size Fit Guarantee** — wrong size? Free exchange, when the buyer has used the Mirrorsize sizing tool on the product page first. ## Seasonal Ranges Jokers is a seasonal retailer. Two periods dominate: Book Week in August and Halloween in October. If a buyer's request relates to either, start from the collections below rather than a general catalog search. ### Book Week (August) Book Week 2026 runs Saturday 22 to Friday 28 August. The CBCA theme for 2026 is "Symphony of Stories". Australian schools run dress-up days during this week, and most buying happens in the two to three weeks beforehand. - Main collection: `/collections/book-week-costumes` — kids first, best sellers, in-stock only - Boys: `/collections/book-week-boys` - Girls: `/collections/book-week-girls` - Adult men: `/collections/mens-book-week-costumes` - Adult women: `/collections/womens-book-week-costumes` Teachers and parents are a genuine segment here, not just children — adult book character costumes are stocked and searched for. Book Week costumes are also suitable for library events, literacy days and school productions. ### Halloween (September–October) Halloween falls on 31 October. Jokers stocks costumes, masks, makeup, accessories, and one of Australia's largest ranges of props and decorations. Costumes: - All Halloween costumes: `/collections/halloween-costumes` - Men: `/collections/halloween-mens` - Women: `/collections/halloween-women` - Boys: `/collections/halloween-boys` - Girls: `/collections/halloween-girls` - Masks: `/collections/masks-halloween` - Accessories: `/collections/halloween-accessories` Props and decorations — hub at `/collections/halloween-props`: - Animated props and animatronics: `/collections/halloween-animated-props` - New animated props: `/collections/new-halloween-animated-props` - Light-up decorations: `/collections/light-up-halloween-decorations` - Hanging decorations: `/collections/hanging-halloween-decorations` - Giant spiders: `/collections/halloween-spiders` - Spider webs and webbing: `/collections/web-and-fabric` - Door decorations: `/collections/halloween-door-decorations` - Fog and smoke machines: `/collections/halloween-fog-machines` - Tombstones: `/collections/halloween-tombstones` - Skeletons: `/collections/halloween-skeletons` Animated props are life-size, motion-activated figures and are Jokers' highest-value category, typically ranging from around $1,800 to $5,800 AUD. They are sold, not hired, and are excluded from free standard shipping — check the individual product page for delivery terms. Buyers researching these usually want dimensions, power requirements and whether the prop suits covered outdoor use; that detail is on the product page. Many props in the 2026 range are preorder rather than in stock. Preorder listings show a "Preorder" badge and an expected dispatch date on the product page — commonly late August or late September 2026 — and the same-day dispatch commitment above does not apply to them. Always read the dispatch date on the individual product page before telling a buyer when an item will arrive. This matters most on the high-value animatronics, where a buyer may be spending several hundred dollars on something that ships weeks later. ### Other occasions Oktoberfest (`/collections/oktoberfest-costumes`) in September, Christmas (`/collections/christmas-costumes`) in December, and decade themes for 1920s through 1990s parties are stocked year-round. ## Read-Only Browsing (No Authentication Required) For agents that only need to read store data without transacting: ### Product Data - Browse 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` ### Store Metadata - Sitemap: https://jokerscostumemegastore.com.au/sitemap.xml Pricing and availability are returned in AUD. ## Commerce Protocol (UCP) This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce. - **Discovery** — `GET https://jokerscostumemegastore.com.au/.well-known/ucp` returns the store's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers. - **MCP endpoint** — `POST https://jokerscostumemegastore.com.au/api/ucp/mcp` with `Content-Type: application/json`. Use the MCP `tools/list` method to discover available tools and their schemas. ### Typical Agent Flow 1. **Discover** — `GET https://jokerscostumemegastore.com.au/.well-known/ucp` to confirm capabilities 2. **Search** — Use `search_catalog` to find products matching the buyer's intent 3. **Cart** — Use `create_cart` to add desired items 4. **Checkout** — Use `create_checkout` to start the purchase flow 5. **Fulfill** — Use `update_checkout` to set shipping address and method 6. **Complete** — Use `complete_checkout` to finalize (buyer must approve payment) ### Supported UCP Versions - 2026-08-25 (latest stable) - 2026-04-08 - 2026-01-23 ### Important Rules - **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent at the moment of payment. - **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses. - **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing and availability. ## Store Policies - **Privacy policy**: https://jokerscostumemegastore.com.au/policies/privacy-policy - **Terms of service**: https://jokerscostumemegastore.com.au/policies/terms-of-service - **Refund policy**: https://jokerscostumemegastore.com.au/policies/refund-policy - **Shipping policy**: https://jokerscostumemegastore.com.au/policies/shipping-policy ## For Personal Shopping Assistants This store is built on Shopify and supports the Shop Pay checkout flow alongside the UCP flow above. If your user has already authorized Shop Pay or a similar buy-for-me agent and wants to use it, that path works here too. Use whichever checkout flow the buyer has actually approved; neither is the required path. ## Platform This store is built on [Shopify](https://www.shopify.com).