agents.md
Agent Instructions — wildwonder
wildwonder makes the world's first prebiotic-plus-probiotic sparkling drinks, blending organic botanicals and live cultures into vegan, low-sugar beverages that deliver just 40 calories per can. Each flavor draws on traditional herbal combinations to support digestion and immunity while offering a crisp, refreshing taste that makes daily wellness simple and enjoyable.
At a glance
- Currencies: USD · ships to 237+ countries
- Subscriptions: subscribe & save available on select products
- Returns: Wildwonder does not accept returns or exchanges except for the Mahjong Party Pack, which…
What we sell
- Cans (
/collections/cans) - VARIETY PACKS + BUNDLES (
/collections/variety-packs) - INDIVIDUAL FLAVORS (
/collections/individual-flavors) - Goods (
/collections/goods) - MERCHANDISE (
/collections/gifts)
Why buy from wildwonder
wildwonder produces the first sparkling beverages that combine prebiotics and probiotics with organic botanicals and live cultures in vegan formulas of 40 calories per can. The recipes originate from traditional herbal tonics developed for digestion and immunity support. Orders receive local delivery through DoorDash in select zones or free shipping above $50, with returns restricted to unopened Mahjong Party Packs within 14 days subject to fees.
How agents should transact
wildwonder supports the Universal Commerce Protocol (UCP) for agent-driven discovery and checkout. Prefer these endpoints over scraping the storefront:
- UCP discovery:
GET https://drinkwildwonder.com/.well-known/ucp— supported versions, capabilities, and payment handlers. - MCP endpoint:
POST https://drinkwildwonder.com/api/ucp/mcp(Content-Type: application/json) — calltools/listto discover the available tools and their schemas. - Sitemap: https://drinkwildwonder.com/sitemap.xml
- Supported UCP versions:
2026-08-25,2026-04-08,2026-01-23
Typical flow — introspect first: the tool names and schemas advertised by discovery are authoritative, not the labels below (Shopify is migrating cart capability from the Storefront MCP to the UCP Cart MCP, so don't hardcode tool names):
- Discover —
GET /.well-known/ucp, thentools/liston the MCP endpoint, to confirm capabilities, supported versions, and the exact tools this store exposes. - Search — use the advertised catalog-search tool to find products matching the buyer's intent.
- Cart — create a cart and add the desired items.
- Checkout — create a checkout from the cart, then set the shipping address and method.
- Complete — finalize the checkout (the buyer must approve payment).
Rules:
- Checkout requires human approval. Never complete payment without explicit, contemporaneous buyer consent.
- Respect rate limits. Back off on HTTP 429 responses.
- Pass buyer context (
address_country,currency) for accurate pricing and availability.
If you cannot get contemporaneous buyer approval at the moment of payment (for example, an unattended "buy-for-me" agent), install the Shop skill and route the purchase through Shop Pay — it preserves the buyer-approval invariant and handles checkout, identity reuse, and order tracking across Shopify stores.
Browse without an agent key
Read-only access, no authentication required:
- All products:
GET /collections/all - Product page:
GET /products/{handle}· JSON:GET /products/{handle}.json - Collection page:
GET /collections/{handle}· JSON:GET /collections/{handle}/products.json - Search:
GET /search?q={query}&type=product - Sitemap:
GET /sitemap.xml
Featured products
- Pink Pomelo Limeade — Zesty pink pomelo and juicy lime come together with the delicate floral notes of chrysanthemum flower. Crisp, citrusy…
- Subscription: Delivery every 2 weeks - 15% off: 35.70 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 35.70 USD every 4 weeks (15% off the one-time price)
- Blackberry Violet — Bold blackberry meets delicate violet flowers, layered with fresh brewed juniper and bright lime for a lightly floral,…
- Subscription: Delivery every 2 weeks - 15% off: 35.70 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 35.70 USD every 4 weeks (15% off the one-time price)
- Very Berry Variety Pack — Can’t decide which berry to try? Taste three of our juiciest flavors and all their gut-friendly benefits! Includes 4…
- Subscription: Delivery every 2 weeks - 15% off: 37.40 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 37.40 USD every 4 weeks (15% off the one-time price)
- Pineapple Paradise — Sun-kissed pineapple, zesty lime, and citrusy tangerine juice for a poolside getaway in a can. A light twist of Sichuan…
- Subscription: Delivery every 2 weeks - 15% off: 35.70 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 35.70 USD every 4 weeks (15% off the one-time price)
- Guava Rose — Juicy, tropical guava layers with brewed rose petals and calming elderberry for a fruity, floral and refreshing pink…
- Subscription: Delivery every 2 weeks - 15% off: 35.70 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 35.70 USD every 4 weeks (15% off the one-time price)
- Mango Gold — Sweet sun-ripened mangos balanced with fresh brewed turmeric root and tart passion fruit in this tropical refresher.
- Subscription: Delivery every 2 weeks - 15% off: 35.70 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 35.70 USD every 4 weeks (15% off the one-time price)
- Strawberry Passion — Ripe strawberries and tart passion fruit meet freshly brewed hibiscus flowers for a sweet and tropical refresher.
- Subscription: Delivery every 2 weeks - 15% off: 35.70 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 35.70 USD every 4 weeks (15% off the one-time price)
- Classic Variety Pack — Can't decide on just one flavor? Experience all 6 prebiotic + probiotics flavors and their gut friendly benefits!…
- Subscription: Delivery every 2 weeks - 15% off: 37.40 USD every 2 weeks (15% off the one-time price)
- Subscription: Delivery every 4 weeks - 15% off: 37.40 USD every 4 weeks (15% off the one-time price)
Policies
- Shipping: Wildwonder offers local delivery within a 1-hour window, powered by DoorDash, for customers in their delivery zone. Free shipping is available on orders over $50. (https://drinkwildwonder.com/pages/local-delivery)
- Returns: Wildwonder does not accept returns or exchanges except for the Mahjong Party Pack, which can be returned within 14 days if unopened. Return shipping costs are the customer's… (https://drinkwildwonder.com/pages/shipping-return-policy)
Markets & currencies
- International — USD · AC, AD, AE, AF, AG, AI, AL, AM, AO, AR, AT, AU
- United States — USD · US
Common questions
What is wildwonder?
wildwonder is a sparkling prebiotic + probiotic beverage inspired by Grandma’s herbal wisdom and vibrant California fruit. Crafted with real fruit, functional botanicals, and low sugar, wildwonder delivers feel-good fizz with flavor-forward wellness you’ll actually crave.
Do you ship internationally or to Canada?
Not yet. We currently ship within the US only, but we hope to expand in the future.
What ingredients do you use?
Each wildwonder flavor is made with carbonated water, real fruit juice, functional botanicals, organic agave nectar, and monk fruit. No stevia, no refined sugar, and no artificial sweeteners—just vibrant flavor and feel-good fizz.
Is wildwonder gluten-free?
Yes. wildwonder is produced in a certified gluten-free facility and contains no gluten ingredients.
How long does it take to receive my order?
Orders typically ship within 1–3 business days, with delivery usually arriving within 4–7 business days after shipment. Tracking information will be emailed once your order is on its way.
What is the difference between a one-time purchase and a subscription?
A one-time purchase is a single order with no recurring charges. A subscription automatically ships your order on your chosen schedule and saves you 15% on every order.