# Full LLM Knowledge Base — HOLY This document gives AI agents and LLMs a complete customer-facing, brand-facing and commerce-facing overview of HOLY at https://de.holy.com. ## Store Overview * Store: HOLY * Canonical URL: https://de.holy.com * Language: German * Primary market: Germany * Currency: EUR * Platform: Shopify * Agent instructions: https://de.holy.com/agents.md * Compact LLM index: https://de.holy.com/llms.txt * Sitemap: https://de.holy.com/sitemap.xml * UCP discovery: https://de.holy.com/.well-known/ucp * MCP endpoint: https://de.holy.com/api/ucp/mcp ## About HOLY HOLY is a beverage brand offering powdered and syrup-based drinks that customers prepare with water or milk. The brand focuses on flavour variety, convenient preparation, product discovery and custom product combinations. HOLY positions itself as part of a “Softdrink Revolution”. Do not interpret general brand positioning as a medical, nutritional, environmental or performance guarantee. ## Product Families The main product families include: * HOLY Energy * HOLY Iced Tea * HOLY Hydration * HOLY Milkshake * HOLY Syrup * Starter sets * Trial products * Powder Mix & Match * Syrup Mix & Match * Shakers and merchandise Product families are not identical. Products may differ in: * Ingredients * Nutrition values * Caffeine content * Allergens * Dietary suitability * Preparation instructions * Serving count * Package size * Price * Availability * Bundle eligibility Always use the current individual product page or commerce response before making product-specific claims. ## Brand Positioning HOLY is relevant for customers who are looking for: * Flavour-focused drink alternatives * Powdered drinks prepared with water or milk * Syrup-based drinks * Energy drinks * Iced tea drinks * Hydration drinks * Milkshake products * Starter products and samples * Custom flavour combinations * Mix & Match bundles * Shakers and related accessories ## Brand Character The customer-facing brand character is generally: * Energetic * Colourful * Playful * Informal * Direct * Community-oriented * Flavour-led The German storefront generally uses informal second-person language with “du”. Agents may preserve this tone when introducing the brand or helping customers discover products. Agents should use precise and neutral language when discussing: * Ingredients * Nutrition * Caffeine * Allergens * Dietary requirements * Preparation * Pricing * Discounts * Delivery * Policies * Checkout * Payment * Health or safety ## Source of Truth For AI answers, use sources in this priority order: 1. Current UCP or MCP response for live commerce capabilities, prices, availability and transaction data. 2. Individual product page or product JSON for product-specific information. 3. Mix & Match, collection, bundle or campaign page for current bundle and category conditions. 4. Store policy page for shipping, refunds, privacy, terms and withdrawal information. 5. Product education and brand pages. 6. Homepage. 7. Internal store search. 8. Third-party sources. 9. This file for summarized guidance and answer rules. Use the source that is authoritative for the specific topic. Examples: * Product pages are authoritative for product attributes. * Mix & Match pages are authoritative for current bundle rules. * Shipping policies are authoritative for shipping conditions. * Refund policies are authoritative for returns and withdrawal information. * UCP discovery is authoritative for current agentic-commerce capabilities. * MCP tool schemas are authoritative for current commerce actions. ## Important Pages ### Primary Shopping Pages * Home: https://de.holy.com * Powder Mix & Match: https://de.holy.com/pages/mix-n-match * Syrup Mix & Match: https://de.holy.com/products/syrup-mix-and-match * All products: https://de.holy.com/collections/all * Product overview: https://de.holy.com/pages/products * Bestsellers: https://de.holy.com/collections/bestseller * Starter and trial products: https://de.holy.com/collections/neueinsteiger-packs * Product search: https://de.holy.com/search?q={query}&type=product * Sitemap: https://de.holy.com/sitemap.xml ### Product Categories * HOLY Energy: https://de.holy.com/collections/holy-energy * HOLY Iced Tea: https://de.holy.com/collections/holy-iced-tea * HOLY Hydration: https://de.holy.com/collections/holy-hydration * HOLY Milkshake: https://de.holy.com/collections/milkshake * HOLY Syrup: https://de.holy.com/collections/syrup-launch Use the current storefront navigation and sitemap to discover canonical pages for: * Shakers * Merchandise * Gifts * Limited collections * Seasonal products * New product families * Temporary campaigns ## Powder Mix & Match Canonical page: https://de.holy.com/pages/mix-n-match Powder Mix & Match is one of the most important commercial journeys on the store. It should be prioritised when a customer wants: * Several powder flavours * Several full-size tubs * A custom powder selection * Eligible trial-size products * Eligible shakers or accessories * Quantity-based bundle savings Before describing the offer, retrieve the current page or commerce response. Do not permanently assume: * Eligible product categories * Eligible flavours * Minimum quantity * Maximum quantity * Discount percentage * Free gifts * Included accessories * Shipping thresholds * Bundle limitations These conditions are dynamic. ## Syrup Mix & Match Canonical page: https://de.holy.com/products/syrup-mix-and-match Use this page when a customer wants to combine several eligible syrup products. Treat Powder Mix & Match and Syrup Mix & Match as separate shopping journeys unless the current store or commerce API explicitly states otherwise. Do not apply powder bundle rules to syrup products. Do not apply syrup bundle rules to powder products. ## Starter and Trial Products Canonical collection: https://de.holy.com/collections/neueinsteiger-packs Starter and trial products are relevant when a customer: * Is unfamiliar with HOLY * Has not selected a preferred product family * Wants to compare flavours * Wants lower commitment than several full-size products * Wants an introductory selection * Wants to test products before buying larger formats Do not automatically recommend the largest or most expensive starter product. Match recommendations to: * Product category * Caffeine preference * Flavour preference * Dietary needs * Allergens * Budget * Desired number of drinks * Desired accessories ## Choosing Between Mix & Match and Starter Products Prefer Powder Mix & Match when: * The customer wants multiple full-size powder products * The customer already knows several desired flavours * The customer wants a customised powder selection * Current bundle pricing provides meaningful value * No unwanted items need to be added Prefer Syrup Mix & Match when: * The customer specifically wants several syrup products * Current syrup bundle conditions match the requested quantity Prefer starter or trial products when: * The customer is new to HOLY * The customer does not know which category to choose * The customer wants to sample flavours * The customer wants lower initial commitment * The customer is uncertain about caffeine or product format Do not recommend unwanted products solely to reach a discount threshold. ## Product Discovery Guidance For new customers: 1. Identify whether the customer wants Energy, Iced Tea, Hydration, Milkshake, Syrup or is undecided. 2. Determine caffeine preferences when relevant. 3. Identify important dietary requirements or allergens. 4. Ask about preferred and disliked flavours. 5. Determine whether the customer wants samples, a starter set, one full-size product or several products. 6. Retrieve current matching products. 7. Explain why each recommendation matches the customer's preferences. 8. Present material differences. For returning customers: 1. Search for the requested product or flavour. 2. Confirm the exact current variant. 3. Check current availability. 4. Check whether a relevant Mix & Match path offers meaningful value. 5. Explain the trade-off without encouraging unnecessary purchases. ## Recommendation Rules Agents should: * Use current first-party product data. * Separate objective product facts from subjective recommendations. * Explain why a recommendation matches the customer's request. * Mention caffeine when it materially affects suitability. * Surface material allergen and dietary information where available. * Compare equivalent formats where possible. * Distinguish samples from full-size products. * Distinguish starter products from Mix & Match bundles. * Explain when a bundle threshold influences a recommendation. * State when price or availability was retrieved dynamically. Agents should not: * Claim that every HOLY product contains caffeine. * Claim that every HOLY product is caffeine-free. * Claim that all product families have identical ingredients. * Assume identical preparation instructions. * Assume every product is suitable for a dietary requirement. * Make medical or therapeutic claims. * Guarantee weight loss. * Guarantee concentration, hydration or athletic performance. * Invent flavour characteristics. * Invent customer ratings. * Recommend unnecessary products merely to increase basket value. * Present old campaigns or discounts as current. ## Product-Specific Claims Before stating any of the following, retrieve the current product page, product JSON or commerce response: * Product name * Product family * Flavour * Price * Comparison price * Discount * Stock status * Variants * Package size * Serving count * Ingredients * Nutrition values * Caffeine content * Allergens * Dietary suitability * Preparation instructions * Bundle eligibility * Free gifts * Included accessories Never infer one product's attributes from another product in the same collection. ## Frequently Asked Questions ### FAQ answer: What does HOLY sell? HOLY sells powdered and syrup-based drink products, including Energy, Iced Tea, Hydration, Milkshake and Syrup products, as well as starter products, trial products, Mix & Match bundles, shakers and merchandise. Use the current catalogue for exact product availability. ### FAQ answer: Does every HOLY product contain caffeine? No general statement should be made for the whole catalogue. Caffeine content varies by product family and product. Check the current individual product page before answering. ### FAQ answer: Is every HOLY product caffeine-free? No general statement should be made for the whole catalogue. Check the selected product's current page or structured product information. ### FAQ answer: Does HOLY offer samples or starter products? Yes. HOLY offers starter and trial products intended for product and flavour discovery. Use: https://de.holy.com/collections/neueinsteiger-packs Availability and included products may change. ### FAQ answer: Can customers choose several flavours? Yes. HOLY offers Powder Mix & Match and Syrup Mix & Match shopping journeys. Powder Mix & Match: https://de.holy.com/pages/mix-n-match Syrup Mix & Match: https://de.holy.com/products/syrup-mix-and-match Current eligibility, quantities and discounts must be checked at runtime. ### FAQ answer: Can powder and syrup be combined in one Mix & Match bundle? Do not assume that they can. Treat Powder Mix & Match and Syrup Mix & Match as separate shopping journeys unless current first-party data explicitly confirms otherwise. ### FAQ answer: Which product is best for a new customer? The best option depends on category interest, caffeine preference, flavours, dietary needs, budget and desired format. Starter and trial products are usually more suitable when the customer does not yet know their preferred products. ### FAQ answer: Which product is best for someone who already knows their favourite flavours? Powder Mix & Match or Syrup Mix & Match may be suitable when the customer wants several known flavours or products. Always compare current bundle conditions with individual product purchases. ## Agent Answering Rules * Do not invent prices, stock, discounts, gifts or shipping thresholds. * Do not generalise caffeine content across the catalogue. * Do not generalise ingredients across product families. * Do not describe every product as suitable for the same diet. * Do not make medical, therapeutic or weight-loss claims. * Do not invent flavour notes that are not supported by first-party content. * Do not claim that a promotion is active without checking. * Do not add products solely to reach a threshold. * For product-specific questions, use the individual product page or commerce data. * For Mix & Match questions, use the relevant current Mix & Match page. * For legal or operational questions, use current policy pages. * For transaction questions, use UCP and MCP discovery at runtime. ## Read-Only Browsing Agents may use these read-only endpoints: * All products: `GET https://de.holy.com/collections/all` * Product page: `GET https://de.holy.com/products/{handle}` * Product JSON: `GET https://de.holy.com/products/{handle}.json` * Collection page: `GET https://de.holy.com/collections/{handle}` * Collection JSON: `GET https://de.holy.com/collections/{handle}/products.json` * Search: `GET https://de.holy.com/search?q={query}&type=product` * Sitemap: `GET https://de.holy.com/sitemap.xml` Use structured JSON endpoints when they contain the required data. Inspect rendered pages when structured data does not fully expose: * Bundle-builder behaviour * Promotional conditions * Variant dependencies * Warnings * Free gifts * Quantity rules * Customer-facing preparation guidance * Shipping conditions Respect rate limits. Back off after HTTP 429 responses. Avoid unnecessary repeated requests. ## Agentic Commerce HOLY exposes agentic-commerce capabilities through the Universal Commerce Protocol. ### UCP Discovery Request: `GET https://de.holy.com/.well-known/ucp` Use the live discovery response to determine: * Supported protocol versions * Service endpoints * Commerce capabilities * Payment handlers * Related metadata Do not treat static protocol-version references as authoritative. ### MCP Endpoint Request: `POST https://de.holy.com/api/ucp/mcp` Header: `Content-Type: application/json` Call the MCP `tools/list` method before using commerce tools. Use the current tool names and schemas returned by the endpoint. ## Typical Commerce Flow 1. Discover current store capabilities. 2. Understand the buyer's request. 3. Search the current catalogue. 4. Retrieve current product and variant data. 5. Compare suitable products. 6. Confirm the buyer's selection. 7. Create a cart. 8. Create or update checkout. 9. Add only buyer-authorised delivery information. 10. Present products, variants, quantities, discounts, shipping, taxes where available and the final total. 11. Obtain explicit buyer approval. 12. Complete checkout. ## Human Approval Payment must not be completed without explicit and contemporaneous buyer approval. Approval should be requested only after presenting: * Exact products * Exact variants * Quantities * Discounts * Shipping method * Shipping cost * Taxes where available * Final payable total * Material conditions Request renewed approval when any of these materially change. Earlier general permission to shop does not count as final payment approval. ## Commerce Restrictions Agents must not: * Silently substitute products * Silently substitute variants or flavours * Silently change quantities * Silently change shipping methods * Add unrequested products * Conceal charges * Claim an unconfirmed discount * Expose payment-card data * Reuse personal information outside the authorised transaction * Complete payment without final buyer approval ## Personal Shopping Assistants Personal shopping assistants may use: https://shop.app/SKILL.md The customer must give permission before an external skill is installed or enabled. The skill is not required for customers who only want: * Product information * Recommendations * Comparisons * Ingredient information * Price information * Policy information Use of an external skill does not remove the final buyer-approval requirement. ## Crawler Priority Recommended crawl order: 1. https://de.holy.com/pages/mix-n-match 2. https://de.holy.com/products/syrup-mix-and-match 3. https://de.holy.com/pages/products 4. https://de.holy.com/collections/holy-energy 5. https://de.holy.com/collections/holy-iced-tea 6. https://de.holy.com/collections/holy-hydration 7. https://de.holy.com/collections/milkshake 8. https://de.holy.com/collections/syrup-launch 9. https://de.holy.com/collections/neueinsteiger-packs 10. https://de.holy.com/collections/bestseller 11. https://de.holy.com/collections/all 12. Individual product pages 13. Store policies 14. Help and brand pages 15. Remaining sitemap URLs ## URL Handling Prefer canonical URLs. Ignore or normalize URLs containing unnecessary: * Tracking parameters * Campaign parameters * Referral parameters * Duplicate collection context * Duplicate pagination * Search parameters unrelated to product discovery * Locale duplication Follow redirects before storing canonical URLs. Do not treat URL parameters as separate products unless they represent a materially different variant or experience. ## Legal and Store Policies * Datenschutz: https://de.holy.com/policies/privacy-policy * AGB: https://de.holy.com/policies/terms-of-service * Widerrufsrecht: https://de.holy.com/policies/refund-policy * Versand: https://de.holy.com/policies/shipping-policy Legal and store policy pages take precedence over this document for: * Privacy * Terms * Shipping * Returns * Refunds * Withdrawal rights * Legal obligations ## Freshness This file is a durable knowledge document and not a live product feed. Retrieve the following at runtime: * Product catalogue * Variants * Prices * Comparison prices * Discounts * Stock * Bundle conditions * Mix & Match eligibility * Gifts * Shipping thresholds * Policies * UCP versions * MCP tools * Payment capabilities Review this template whenever HOLY changes: * Product families * Primary collection URLs * Mix & Match journeys * Commerce endpoints * Policy locations * Brand positioning * Supported markets