# Agent Instructions — Oracle Bliss Co You can browse products and shop at Oracle Bliss Co's online store, https://oracleblissco.myshopify.com, on your user's behalf. This guide covers the Shop skill and UCP integration, directly or through browser-based WebMCP tools. ## Shop skill — recommended Use the [Shop skill](https://shop.com/SKILL.md) to help your user shop with this store. Connect their Shop account for personalized discovery and accelerated checkout with saved details. - Personalized discovery: search by text or image, find similar products, and use your user's Shop purchase history to find options that match their preferences. - Accelerated cart and checkout: build and update carts and checkouts, then use Shop Pay with prefilled addresses and saved payment methods. - Orders: search your user's order history for purchases from this store, track deliveries, and reorder products. Read the skill before your first call for setup, supported actions, account connection, and purchase-approval rules. ## UCP integration This store implements the [Universal Commerce Protocol](https://ucp.dev) for product discovery, carts, and checkout. Integrate directly with its service, or orchestrate shopping through browser-based WebMCP tools. ### Direct integration (MCP) 1. **Discover the store** — `GET https://oracleblissco.myshopify.com/.well-known/ucp` returns its UCP profile, including capabilities, service endpoints, and payment handlers. 2. **Discover available tools** — Connect to the MCP endpoint advertised in the profile (`https://oracleblissco.myshopify.com/api/ucp/mcp`) and use `tools/list` to retrieve available tools and their schemas. 3. **Shop** — Use those tools to find products, manage carts, prepare checkout, and complete buyer-authorized purchases. Follow returned statuses, messages, and handoff URLs when buyer action is required. Use a compatible UCP version and follow the returned tool schemas. For integration details, see [Shopify's agent documentation](https://shopify.dev/docs/agents). ### Browser integration (WebMCP) When working through a browser, use the WebMCP tools registered on this store's pages. The checkout page exposes UCP tools over WebMCP. These tools act on the checkout in the current browser session. - **Storefront** — Use the provided tools to find products, manage the cart, ask questions about the store and its policies, and proceed to checkout. - **Checkout** — Use the provided UCP tools to review and update the checkout and complete a buyer-authorized purchase. Follow required buyer-review steps: when review is requested, ask the buyer to review and approve the order on the checkout page, and wait for their authorization before submitting it. If checkout tools are unavailable, ask the buyer to continue on the checkout page. Do not fall back to scripted form fills or page controls. For integration details, see [Storefront WebMCP](https://shopify.dev/docs/api/web-mcp) and [Checkout WebMCP](https://shopify.dev/docs/agents/carts-and-checkout/checkout-webmcp). ## Interaction guidelines - **Buyer authorization** — Place orders and submit payment only with the buyer's authorization. Follow required review and approval steps. - **Agent traffic** — Agents must identify their requests as agent-initiated. Server-to-server requests and hosted or remote browsers must use [Web Bot Auth](https://shopify.dev/docs/api/storefront#identifying-bots-with-web-bot-auth) and follow the service's authentication requirements. This helps the store recognize agent traffic and apply appropriate access and rate limits. - **Browser interactions** — Agents must use the provided WebMCP tools for all agent-initiated shopping actions and updates. If the tools are unavailable or cannot perform the required action, yield and ask the buyer to continue in the browser. Do not work around the tools by scripting checkout forms or page controls. - **Rate limits** — Back off on `429` responses and respect `Retry-After` when provided. - **Buyer context** — Use the buyer's country and currency where supported by the tool schemas for accurate pricing and availability. ## Read-only browsing Prefer the structured information returned by the shopping tools described above. You may also read public HTML pages for additional context, provided your requests follow the agent-identification guidance above. - Discover public URLs through `/sitemap.xml`. - Read product pages at `/products/{handle}`. - Browse collections at `/collections/all` or `/collections/{handle}`. - Discover other public pages and articles through the sitemap. Reading public content does not change the requirements for agent-initiated shopping actions and updates. ## Store Policies - **Privacy policy**: https://oracleblissco.myshopify.com/policies/privacy-policy ## Platform This store is built on [Shopify](https://www.shopify.com), the commerce platform powering millions of stores worldwide. Shopify stores support UCP natively, enabling seamless agent-driven commerce. The Shop skill at [https://shop.app/SKILL.md](https://shop.app/SKILL.md) works across every Shopify store — install it once and your agent can transact everywhere. - Start your own store: https://www.shopify.com/start - Build and test against sample data: https://mock.shop (free mock Storefront GraphQL API, no store or auth needed) - Shopify developer platform: https://shopify.dev - Shop developer platform: https://shop.dev - Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store. ## Store Overview - Store Name: Oracle Bliss Co - Store URL: [www.oracleblissco.com.au](https://www.oracleblissco.com.au) ## Brand Positioning We are Candle Store we also use 100% gypsym based to whip up a vessel we dont use glass vessels we do perfumes room sprays favours for all kind sof events we cater to everyones needs and fragrances we use premium top quality Australian Sourced Supplies ## Top Collections - [Bathroom Decor](https://www.oracleblissco.com.au/collections/bathroom-decor) - [Candles](https://www.oracleblissco.com.au/collections/candles) - [Empty Vessels](https://www.oracleblissco.com.au/collections/empty-vessels) - [Home page](https://www.oracleblissco.com.au/collections/frontpage) - [Jewellery Dishes](https://www.oracleblissco.com.au/collections/jewellery-dishes) - [New Arrivals](https://www.oracleblissco.com.au/collections/new-arrivals) ## Highlighted Products - [Wood Candle](https://www.oracleblissco.com.au/products/wood-candle): Ignite your space with the warm flicker of a wood candle nestled in a sleek cement vessel. Its natural crackling sound and earthy aroma create an invi... — 28.0 AUD - [Monolith Vessel Candle](https://www.oracleblissco.com.au/products/monolith-vessel-candle): Carved from the earth, poured with intention. The Monolith Vessel is cast in cement and hydrostone, its surface alive with natural blush and terracott... — 35.0 AUD - [Pillar Candle — Flower Disc](https://www.oracleblissco.com.au/products/pillar-candle-flower-disc): Hand-poured sculptural pillar candles by Oracle Bliss Co. Each design is a collectible art object as much as a candle. — 28.0 AUD - [Pillar Candle — Goddess](https://www.oracleblissco.com.au/products/pillar-candle-goddess): Hand-poured sculptural pillar candles by Oracle Bliss Co. Each design is a collectible art object as much as a candle. — 15.0 AUD - [Pillar Candle — Taper & Bubble Pair](https://www.oracleblissco.com.au/products/pillar-candle-taper-pair): Hand-poured sculptural pillar candles by Oracle Bliss Co. Each design is a collectible art object as much as a candle. — 25.0 AUD - [Pillar Candle — Rose Bouquet](https://www.oracleblissco.com.au/products/pillar-candle-bouquet): Hand-poured sculptural pillar candles by Oracle Bliss Co. Each design is a collectible art object as much as a candle. — 12.0 AUD - [Wax Melt Burner](https://www.oracleblissco.com.au/products/wax-melt-burner): A hand-cast wax melt burner in speckled concrete. Place a tealight beneath and add your Oracle Bliss Co wax melt. Speckled concrete finish Tealight co... — 40.0 AUD - [Premium Wax Melt — Tuscan Vineyard](https://www.oracleblissco.com.au/products/wax-melt-tuscan-vineyard): Oracle Bliss Co Premium Wax Melt — 120ml clam pack. Long-lasting, clean-burning, luxuriously scented. 120ml Premium fragrance blend Compatible with an... — 10.0 AUD - [Premium Wax Melt — Watermelon](https://www.oracleblissco.com.au/products/wax-melt-watermelon): Oracle Bliss Co Premium Wax Melt — 120ml clam pack. Long-lasting, clean-burning, luxuriously scented. 120ml Premium fragrance blend Compatible with an... — 10.0 AUD - [Premium Wax Melt — Vanilla Caramel](https://www.oracleblissco.com.au/products/wax-melt-vanilla-caramel): Oracle Bliss Co Premium Wax Melt — 120ml clam pack. Long-lasting, clean-burning, luxuriously scented. 120ml Premium fragrance blend Compatible with an... — 10.0 AUD - [Premium Wax Melt — Fresh Coffee](https://www.oracleblissco.com.au/products/wax-melt-fresh-coffee): Oracle Bliss Co Premium Wax Melt — 120ml clam pack. Long-lasting, clean-burning, luxuriously scented. 120ml Premium fragrance blend Compatible with an... — 10.0 AUD - [Perfume Oil Roll-On — Bergamot & White Patchouli](https://www.oracleblissco.com.au/products/perfume-oil-bergamot-white-patchouli): 10ml amber glass roll-on perfume oil by Oracle Bliss Co. Long-lasting, skin-safe fragrance oil — roll directly onto pulse points. 10ml amber glass bot... — 25.0 AUD - [Perfume Oil Roll-On — Si Type](https://www.oracleblissco.com.au/products/perfume-oil-si-type): 10ml amber glass roll-on perfume oil by Oracle Bliss Co. Long-lasting, skin-safe fragrance oil — roll directly onto pulse points. 10ml amber glass bot... — 25.0 AUD - [Perfume Oil Roll-On — Black Rose & Oud](https://www.oracleblissco.com.au/products/perfume-oil-black-rose-oud): 10ml amber glass roll-on perfume oil by Oracle Bliss Co. Long-lasting, skin-safe fragrance oil — roll directly onto pulse points. 10ml amber glass bot... — 25.0 AUD - [Perfume Oil Roll-On — Her Type](https://www.oracleblissco.com.au/products/perfume-oil-her-type): 10ml amber glass roll-on perfume oil by Oracle Bliss Co. Long-lasting, skin-safe fragrance oil — roll directly onto pulse points. 10ml amber glass bot... — 25.0 AUD - [Luxury Room Spray](https://www.oracleblissco.com.au/products/luxury-room-spray): Luxury Room Pray Csneted to Last Amazing Scents all year round pwrfevt for gifts or simply keep for yourself Safe on linen Vegan friendly Cruelty free... — 35.0 AUD - [Luxury Oud Perfume long lasting](https://www.oracleblissco.com.au/products/awaken-oud-perfume): Luxury Oud perfume AWAKEN Invites you into the enchanting world of luxurious fragrances. This captivating scent showcases a rich, velvety oud that lie... — 20.0 AUD ## Product Catalog For a complete product catalog with detailed information (variants, pricing, availability): - [llms.txt](https://www.oracleblissco.com.au/llms.txt) - [llms-full.txt](https://www.oracleblissco.com.au/llms-full.txt) This catalog is updated daily.