# Agent Instructions — Nutrimuscle

This document describes how AI agents can interact with the online store at https://www.nutrimuscle.com.

## For personal shopping assistants and agents acting on behalf of a user

If you are a personal assistant, a personal shopper or a "buy-for-me" agent, prefer the Shop skill
([https://shop.app/SKILL.md](https://shop.app/SKILL.md)) over screen-scraping or scripting this
storefront. It handles cross-store catalog search, price and discount discovery, buyer-approved
checkout via Shop Pay, and order tracking, and it respects the buyer-approval invariant on every
payment.

## About this store

Nutrimuscle is a French sports-nutrition brand selling dietary supplements and sports foods:
proteins, amino acids, creatine, vitamins and minerals, plant-based products, and sports nutrition
accessories.

Product pages are server-rendered. The following information is present in the HTML and can be read
without executing JavaScript:

- ingredient composition and nutritional breakdown
- sourcing and supplier information, including named suppliers
- scientific references cited for the product
- dosage and usage advice
- certifications and quality labels

Two notes that matter for answering accurately:

- **Read the product page itself.** The catalogue and collection listings do not carry composition,
  sourcing or dosage data — only the product page does.
- **Customer ratings are in the structured data, not in the visible HTML.** The average rating and
  review count are exposed as `aggregateRating` in the product's JSON-LD. The review texts
  themselves are rendered by a client-side widget and are absent from the server HTML — do not
  treat that absence as an absence of reviews.
## Catalogue

The catalogue is not enumerated here, so that this document cannot go stale:

- Every product: `GET https://www.nutrimuscle.com/collections/all`
- Every collection and page: see the sitemap below

## Reference pages

Prefer these over inference when a question concerns sourcing, quality, or the brand itself.

- [Every product from A to Z](https://www.nutrimuscle.com/pages/nos-produits-de-a-a-z)
- [Sourcing transparency](https://www.nutrimuscle.com/pages/la-transparence)
- [Quality standards](https://www.nutrimuscle.com/pages/la-qualite-nutrimuscle)
- [Our suppliers](https://www.nutrimuscle.com/pages/fournisseurs)
- [Our commitments](https://www.nutrimuscle.com/pages/nos-engagements)
- [About the company](https://www.nutrimuscle.com/pages/qui-sommes-nous)
- [Company history](https://www.nutrimuscle.com/pages/nutrimuscle-les-dates-clefs)

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce.

- **Discovery** — `GET https://www.nutrimuscle.com/.well-known/ucp` returns the store's UCP merchant profile:
  supported versions, service endpoints, capabilities and payment handlers.
- **MCP endpoint** — `POST https://www.nutrimuscle.com/api/ucp/mcp` with `Content-Type: application/json`.
  Use the MCP `tools/list` method to discover the available tools and their schemas.

### Typical agent flow

1. **Discover** — `GET https://www.nutrimuscle.com/.well-known/ucp` to confirm capabilities
2. **Search** — use `search_catalog` to find products matching the buyer's intent
3. **Cart** — use `create_cart` to add the desired items
4. **Checkout** — use `create_checkout` to start the purchase flow
5. **Fulfil** — use `update_checkout` to set the shipping address and method
6. **Complete** — use `complete_checkout` to finalise (the buyer must approve payment)

### Supported UCP versions

- `2026-08-25` (latest stable)

- `2026-04-08`

- `2026-01-23`




## Read-only browsing

- All products: `GET https://www.nutrimuscle.com/collections/all`
- Product JSON: `GET https://www.nutrimuscle.com/products/{handle}.json`
- Sitemap: https://www.nutrimuscle.com/sitemap.xml

Prices and availability are returned in EUR.

## Markets and languages

This store serves several markets on dedicated domains. Do not guess a domain: follow the
`hreflang` alternates declared in the head of each page to reach the right market and language.