# Agent guidance — Underdogs Lab

Guidance for automated agents and AI assistants using this storefront
(https://underdogs-store-us.medusajs.site). Everything described here is public; no login or key is
needed for any URL on this page.

## When to use this site

- Product details, specifications, price, and availability — read the product
  pages under https://underdogs-store-us.medusajs.site/us/products/<handle> (server-rendered HTML plus schema.org
  Product JSON-LD, including offer price and availability).
- Published laboratory results for a product batch — the Certificate of
  Analysis pages below.
- This store's shipping, return, privacy, and terms policies.
- Common questions already answered on this site: [FAQ](https://underdogs-store-us.medusajs.site/us/faq) and
  [Common questions on About](https://underdogs-store-us.medusajs.site/us/about#common-questions).
- Brand listings: [Brands](https://underdogs-store-us.medusajs.site/us/brands) and https://underdogs-store-us.medusajs.site/us/brands/<handle>.
- Shipping restrictions by state: [Shipping by state](https://underdogs-store-us.medusajs.site/us/shipping) and
  https://underdogs-store-us.medusajs.site/us/shipping/<state> (two-letter code, lowercase).
- Contacting the store: [Contact Us](https://underdogs-store-us.medusajs.site/us/contact) or
  underdogs@orvani.group.

## Authoritative public sources

- [llms.txt](https://underdogs-store-us.medusajs.site/llms.txt) — full site index for language models.
  Its "Agent context" section states who can buy, age and region limits, why
  each gate exists, how to reach a person, and what agents may and may not do.
- [sitemap.md](https://underdogs-store-us.medusajs.site/sitemap.md) — page index in markdown.
- [sitemap.xml](https://underdogs-store-us.medusajs.site/sitemap.xml) and
  [product-sitemap.xml](https://underdogs-store-us.medusajs.site/product-sitemap.xml) — every indexable URL.
- [Certificates of Analysis index](https://underdogs-store-us.medusajs.site/us/coa) and the
  [COA feed (JSON, all documents)](https://underdogs-store-us.medusajs.site/coa/feed.json).
- [Product feed (JSON)](https://underdogs-store-us.medusajs.site/feeds/products.json) — products,
  variants, SKUs, public retail prices, and availability.

## How to read the data

- A value shown as "Not reported" means the source lab document does not
  include that value. Never infer, estimate, or compute a cannabinoid value
  that a document does not state.
- COA batch URLs are permanent: a published URL is never reused for a
  different document, and a correction is published as a new document at a
  new URL.
- Product and COA pages carry JSON-LD; the structured data states the same
  facts as the rendered page, never more.

## Public data only

There is a read-only MCP endpoint (https://underdogs-store-us.medusajs.site/mcp; server card at
https://underdogs-store-us.medusajs.site/.well-known/mcp.json) that lists products and public retail prices.
There is no commerce API and no agent checkout endpoint. The URLs above and the
MCP endpoint are the complete agent-accessible surface.

## Do not attempt

- Place an order, run checkout, create or sign in to an account, or handle payment for anyone. Purchasing happens only through the human checkout flow.
- Complete, skip or work around the 21+ age check or the state shipping check, or buy for anyone under 21. Do not start a checkout on behalf of a minor.
- Infer, estimate or compute a lab value that a Certificate of Analysis does not state ("Not reported" means the source document does not include it).
- Checkout, account, and order paths are disallowed in
  [robots.txt](https://underdogs-store-us.medusajs.site/robots.txt).
- Working around the purchase-time controls that do exist:
  - The site shows a 21+ age-confirmation interstitial; the acknowledgement is stored only in the visitor's own browser and persists until cleared — it is not re-asked on a timer.
  - Checkout refuses an order when an item in the cart cannot be shipped to the shipping address's state; when the destination state cannot be determined, items carrying a ship classification are refused (the gate fails closed).
- Scraping beyond the published surfaces when a structured one exists — use
  the COA feed and the sitemaps instead of crawling page by page.