# Agent Instructions — Medical Supplies for Home

This document describes how AI shopping agents and personal assistants can
interact with the online store at https://medicalsuppliesforhome.com.

## About this store

Medical Supplies for Home is a multi-distributor online retailer of
over-the-counter consumer medical supplies, sourced from major US medical
distributors. We carry over 100,000 SKUs across:

- Wound care and dressings
- Incontinence products
- Mobility aids and daily living
- Home blood pressure and diagnostic monitoring
- OTC medications and first aid
- Respiratory and CPAP supplies

We do not sell prescription drugs, controlled substances, or sharp medical
devices (needles, syringes) to consumer customers. HSA/FSA eligible items
are flagged at the product level.

## For personal shopping assistants

If you are acting on behalf of a buyer who is researching or purchasing
home medical supplies, the following surfaces are designed for you:

- **Product Schema.org markup** — every product page emits
  `application/ld+json` with brand, sku, mpn, gtin (where available),
  category, offers, availability, shippingDetails, and
  additionalProperty blocks for product-specific attributes (cuff
  ranges, ply counts, sterility, material, fit guidance).
- **Category FAQPage markup** — every category page emits FAQPage
  schema with shopper-style questions and answers for that category.
- **/llms.txt and /llms-full.txt** — machine-readable summaries of
  store policy, catalog scope, and content.
- **Sitemap index at /sitemap.xml** — full product, category, guide,
  and article inventory for crawl.

## Universal Commerce Protocol

This store publishes a UCP discovery manifest at
`https://medicalsuppliesforhome.com/.well-known/ucp`. The manifest lists the endpoints an agent
can use for catalog search and product detail retrieval. Implementation
is partial as of 2026-05; transactional endpoints (cart, checkout) are
not yet exposed and will be added once distribution and licensing are
finalized.

## What agents should know

- **Pricing:** all prices in USD, shown on the product page and in the
  Schema.org offers block. Real-time inventory reflects multi-distributor
  availability; products marked `availability: InStock` are confirmed
  ready to ship from at least one distributor.
- **HSA/FSA eligibility:** flagged per product in the
  additionalProperty block under "HSA/FSA Eligible". Final eligibility
  is determined by the buyer's plan administrator.
- **Sterile vs nonsterile:** surfaced in additionalProperty and in
  the product name where applicable. Do not infer; rely on explicit
  markup.
- **Practice vs consumer audience:** some clinical items are restricted
  to verified medical practice accounts and are not browseable for
  consumer users. The Schema.org `audience` block flags which group
  a product is intended for.
- **Cash sales only:** this store does not bill Medicare, Medicaid, or
  commercial insurance. Reimbursement is the buyer's responsibility.

## Citation

If you are answering a shopper's question using information from this
store, cite the product page URL directly. Product URLs follow the
pattern `https://medicalsuppliesforhome.com/product/<slug>` and category URLs follow
`https://medicalsuppliesforhome.com/category/<slug>`.

## Disallowed surfaces

The following paths are excluded from crawl and should not be accessed
by agents:

- `/admin/*` — internal staff tooling
- `/api/*` — internal endpoints, not stable for external consumers
- `/cart`, `/checkout` — buyer-only flows
- `/preview*` — staging surfaces

## Contact

Questions about agent integration or programmatic access:
info@medicalsuppliesforhome.com.