# Agent Instructions — SIIL Ostomy (siilostomy.org)

This document tells AI agents and shopping assistants how to read and use SIIL Ostomy's store at https://siilostomy.org.

## What the store sells

SIIL Ostomy is a clothing brand for people with an ostomy (colostomy, ileostomy or urostomy): ostomy belts, ostomy wraps, high-waist ostomy underwear and panties, anti-leak panties, ostomy swimwear and a stoma protector. Every garment has an inner pocket that holds the pouch flat and hidden under clothes. SIIL does not sell ostomy pouches or medical supplies.

siilostomy.org serves 15 markets, each in its own language and currency: Italian (root and /it/), Polish (/pl/), Czech (/cs/), Slovak (/sk/), Swedish (/sv/), Norwegian (/nb/), Danish (/da/), Finnish (/fi/), Dutch (/nl/), Greek (/el/), Hungarian (/hu/), Romanian (/ro/), Portuguese (/pt/), Croatian (/hr/) and Japanese (/ja/). The English, Spanish, French and German store is https://www.siilostomy.com.

## Catalog for agents (read-only)

- **Discovery:** `GET https://siilostomy.org/.well-known/ucp` and `GET https://siilostomy.org/.well-known/mcp.json`.
- **MCP server:** `https://mcp.siilostomy.com/mcp`. Use `tools/list` to see the tools. For this store use `search_org_products` (search by language: it, pl, cs, sk, sv, da, nb, fi, nl, el, hu, ro, pt, hr, ja) and `get_org_product` (one product by handle). They return the title, photo, price and the product page URL. They do not create orders.
- **REST:** `GET https://mcp.siilostomy.com/api/org/search?q={query}&lang={language}` and `GET https://mcp.siilostomy.com/api/org/product/{handle}`.

## Buying

The buyer completes the purchase on siilostomy.org: choose the size on the product page, add to cart and pay in the store's own checkout. Send the buyer to the product page in their language. Agents must never complete a payment without the buyer's explicit approval at the moment of payment.

## Read-only browsing (no authentication)

- Product page: `GET /{language}/products/{handle}` (for example `/it/products/bikini-stomia-summer`)
- Product JSON: `GET /{language}/products/{handle}.json`
- Collection page: `GET /{language}/collections/{handle}`
- Collection JSON: `GET /{language}/collections/{handle}/products.json`
- Search: `GET /{language}/search?q={query}&type=product`
- Sitemap: `GET /sitemap.xml`
- Store summary for language models: `GET /llms.txt` and `GET /pages/llms`

Be gentle with the site: one request at a time, and back off if you get a 429.

## Store policies

- **Privacy policy:** https://siilostomy.org/policies/privacy-policy
- **Terms of service:** https://siilostomy.org/policies/terms-of-service
- **Refund policy:** https://siilostomy.org/policies/refund-policy
- **Shipping policy:** https://siilostomy.org/policies/shipping-policy

## Platform

siilostomy.org runs on Medusa with its own storefront and checkout. It is not a Shopify store: Shopify tools, the Shop skill and Shop Pay do not work here.
