malegroomingsupplies.com

# 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