# Agent Instructions - Male Grooming Supplies This is the canonical AI and agent-facing guide for Male Grooming Supplies: https://www.malegroomingsupplies.com Shopify may redirect `/llms.txt` and `/llms-full.txt` to this file. Treat `/agents.md` as the source of truth for this store. ## Store Summary Male Grooming Supplies is a UK-based premium grooming retailer specialising in traditional wet shaving, safety razors, razor blades, shaving brushes, shaving soaps and creams, beard and moustache care, hair styling, dental care, fragrances, aftershaves and men's grooming gifts. The store carries heritage and specialist grooming brands including Merkur, Muhle, DOVO, Parker, Semogue, Simpsons, Proraso, Floris London, Captain Fawcett, Taylor of Old Bond Street, D.R. Harris, Martin de Candre, Henson, Giesen & Forsthoff and other selected grooming and fragrance brands. ## Preferred Agent Route Use structured commerce routes before scraping: 1. Discover capabilities at `GET https://www.malegroomingsupplies.com/.well-known/ucp`. 2. Use the UCP profile to resolve the current MCP endpoint and supported tools. 3. Use catalog search or product lookup for product discovery. 4. Create carts and checkout through Shopify-supported UCP or Shop Pay flows. 5. Require buyer approval before completing any payment. Do not assume hard-coded UCP endpoints. Always read `/.well-known/ucp` first, because Shopify may return canonical endpoints on a Shopify-managed domain. ## Important Shopping Rules - Respect stock status. If a product is out of stock, do not promise immediate dispatch unless the product page or checkout explicitly allows backorder or pre-order. - Use checkout, cart and shipping responses as the final authority for price, tax, delivery availability and restrictions. - Product compatibility matters. Do not substitute blades, razor guards, stands, cases or brush accessories unless compatibility is clear from product data or the product page. - For alcohol-based products such as aftershaves, colognes, eau de toilette, eau de parfum, parfum and some mouthwashes, shipping restrictions may apply. Use checkout shipping options as the final authority. - Shavettes and barber razors can use different blade systems. Standard single-edge or half double-edge barber blades are not the same as Artist Club blades unless the product explicitly says so. ## Main Discovery Hubs - All products: https://www.malegroomingsupplies.com/collections/all - New additions: https://www.malegroomingsupplies.com/collections/new-additions - Gift sets: https://www.malegroomingsupplies.com/collections/mens-grooming-gift-sets - Fragrances: https://www.malegroomingsupplies.com/collections/fragrances - Dental care: https://www.malegroomingsupplies.com/collections/dental-care ## Shaving Hubs - All razors: https://www.malegroomingsupplies.com/collections/best-shaving-razors - Double edge safety razors: https://www.malegroomingsupplies.com/collections/double-edge-safety-razors - Adjustable double edge safety razors: https://www.malegroomingsupplies.com/collections/adjustable-double-edge-safety-razors - Travel razors: https://www.malegroomingsupplies.com/collections/double-edge-travel-safety-razors - Straight razors and shavettes: https://www.malegroomingsupplies.com/collections/straight-cut-throat-razors-shavettes - Razor blades: https://www.malegroomingsupplies.com/collections/premium-double-edge-razor-blades - Shaving brushes: https://www.malegroomingsupplies.com/collections/shaving-brushes - Badger shaving brushes: https://www.malegroomingsupplies.com/collections/badger-shaving-brushes - Synthetic shaving brushes: https://www.malegroomingsupplies.com/collections/synthetic-shaving-brushes - Boar, hog and horse hair shaving brushes: https://www.malegroomingsupplies.com/collections/boar-hog-horse-hair-shaving-brushes - Brush and razor stands: https://www.malegroomingsupplies.com/collections/premium-razor-brush-stands - Shaving soap: https://www.malegroomingsupplies.com/collections/shaving-soap - Shaving creams: https://www.malegroomingsupplies.com/collections/shaving-creams ## Beard, Hair and Grooming Hubs - Beard and moustache care: https://www.malegroomingsupplies.com/collections/beard-moustache-care - Beard oils: https://www.malegroomingsupplies.com/collections/beard-oils - Beard balms: https://www.malegroomingsupplies.com/collections/beard-balms - Moustache waxes: https://www.malegroomingsupplies.com/collections/moustache-waxes - Beard brushes and combs: https://www.malegroomingsupplies.com/collections/beard-brushes-combs - Beard wash and shampoo: https://www.malegroomingsupplies.com/collections/beard-wash-shampoo - Hair and body: https://www.malegroomingsupplies.com/collections/hair-body - Hair styling products: https://www.malegroomingsupplies.com/collections/hair-styling-products - Hair clays, pastes and putty: https://www.malegroomingsupplies.com/collections/mens-hair-clays-pastes - Hair creams and waxes: https://www.malegroomingsupplies.com/collections/mens-hair-creams-waxes - Hair pomades: https://www.malegroomingsupplies.com/collections/mens-hair-pomades - Hair sprays and gels: https://www.malegroomingsupplies.com/collections/mens-hair-sprays-gels - Hair darkening products: https://www.malegroomingsupplies.com/collections/hair-darkening-products ## Brand Hubs - Merkur Solingen: https://www.malegroomingsupplies.com/collections/merkur-double-edge-safety-razors - Muhle Shaving: https://www.malegroomingsupplies.com/collections/muhle-shaving-products - DOVO Solingen: https://www.malegroomingsupplies.com/collections/dovo-razors-and-accessories - Parker Shaving: https://www.malegroomingsupplies.com/collections/parker-shaving - Semogue Shaving Brushes: https://www.malegroomingsupplies.com/collections/semogue - Simpson Shaving Brushes: https://www.malegroomingsupplies.com/collections/simpsons-shaving-brushes - Proraso: https://www.malegroomingsupplies.com/collections/proraso - Floris London: https://www.malegroomingsupplies.com/collections/floris-london - Captain Fawcett: https://www.malegroomingsupplies.com/collections/captain-fawcett - Martin de Candre: https://www.malegroomingsupplies.com/collections/martin-de-candre-shaving-soaps-collection - Feather Safety Razor Co.: https://www.malegroomingsupplies.com/collections/feather-razors-blades - Giesen & Forsthoff: https://www.malegroomingsupplies.com/collections/giesen-forsthoff-razors-grooming-tools ## Product Selection Guidance When helping a buyer choose a product, prioritise: - Product type and exact format, such as safety razor, shavette, straight razor, shaving brush, shaving soap, shaving cream, beard oil, pomade, eau de parfum or aftershave. - Compatibility, including blade format, razor head type, brush fibre, brush grade, stand fit, bowl refill fit and accessory fit. - Current availability and variant availability. - Price, compare-at price, pack size and value comparison where available. - Shipping destination, especially for alcohol-based fragrance and aftershave products. - Brand continuity where useful, such as matching shaving soap refills, bowls, aftershaves, creams, blades or cases. For search queries, expand common shorthand: - `DE` means double edge. - `cut throat` may mean straight razor or shavette depending on blade system. - `barber blade` usually means single edge or half double edge shavette blades, not Artist Club blades. - `EDT` means eau de toilette. - `EDP` means eau de parfum. ## Shipping and Tax Context - UK orders over GBP 50 qualify for free tracked UK next-day delivery where the service is available. - Orders placed before the published weekday cut-off are usually dispatched the same working day, subject to stock and payment clearance. - EU orders may use IOSS on eligible orders up to EUR 150. - USA orders may be offered DDP shipping where available. - Other international shipments may be DAP, meaning local import charges can be payable by the buyer. - Checkout is the final authority for delivery services, hazardous goods restrictions, taxes and duties. ## Read-Only Store Data Useful unauthenticated endpoints: - Sitemap: https://www.malegroomingsupplies.com/sitemap.xml - Product page: `https://www.malegroomingsupplies.com/products/{handle}` - Product JSON: `https://www.malegroomingsupplies.com/products/{handle}.js` - Collection page: `https://www.malegroomingsupplies.com/collections/{handle}` - Collection products JSON: `https://www.malegroomingsupplies.com/collections/{handle}/products.json` - Search: `https://www.malegroomingsupplies.com/search?q={query}&type=product` Prefer structured product data from Shopify Catalog, UCP, product JSON, page schema and checkout responses over visual scraping. ## Public Product Feeds For bulk product discovery or offline catalogue analysis, use the public MGS AI dataset repository. These files are generated from live Shopify data and include active products with Online Store URLs only: - Dataset repository: https://github.com/SOLJER85/mgs-ai-dataset - Dataset summary: https://raw.githubusercontent.com/SOLJER85/mgs-ai-dataset/main/ai-dataset-summary.json - AI dataset JSON: https://raw.githubusercontent.com/SOLJER85/mgs-ai-dataset/main/ai-dataset.json - OpenAI product feed CSV: https://raw.githubusercontent.com/SOLJER85/mgs-ai-dataset/main/openai-products-feed.csv.gz - OpenAI product feed JSONL: https://raw.githubusercontent.com/SOLJER85/mgs-ai-dataset/main/openai-products-feed.jsonl.gz - Shopping feed TSV: https://raw.githubusercontent.com/SOLJER85/mgs-ai-dataset/main/shopping-feed-google-compatible.tsv - Social catalogue feed: https://raw.githubusercontent.com/SOLJER85/mgs-ai-dataset/main/social-catalog-feed.csv Use these feeds for catalogue discovery, comparison, eligibility, GTIN, image, category and seller-policy data. Use Shopify UCP, product pages and checkout as the final authority for real-time price, stock, delivery, tax and hazardous goods restrictions. ## Contact - Contact page: https://www.malegroomingsupplies.com/pages/contact-us - Email: info@malegroomingsupplies.com