Public agent access

Inspect first. Ask before purchase.

An agent can read exact mug options and artwork rules. It must use the website for artwork, proof review, and checkout. No public tool can place an order.

Supported workflow

Use these steps today.

1
Read the catalog.
Call GET /api/products and select one exact variant_id.
2
Open the stable variant URL.
The URL preselects the exact mug color and capacity.
3
Create or upload artwork.
Use the labeled website controls. Check the file and print requirements first.
4
Show the proof.
Show the selected mug, artwork placement, delivery details, and displayed cost to the user.
5
Stop for approval.
Do not submit payment or place the order without explicit user approval.

Machine resources

Start with a defined contract.

/api/productsProduct catalog

Exact variants, prices, print areas, upload limits, and stable variant URLs.

/openapi.jsonOpenAPI document

The contract for the read-only getProductOptions operation.

/llms.txtLLM index

A short text index of the public machine resources and store policies.

Exact variants

“Black, large” becomes one ID.

Use the catalog value. Do not infer a capacity from words such as “large.”

Variant ID	Color	Capacity	Recommended art	Print area
`white-glossy-11oz`	White glossy	11 oz	930 × 930 px	2700 × 1050 px
`white-glossy-15oz`	White glossy	15 oz	1010 × 1010 px	2700 × 1140 px
`white-glossy-20oz`	White glossy	20 oz	1070 × 1070 px	3071 × 1205 px
`black-glossy-11oz`	Black glossy	11 oz	820 × 820 px	2250 × 925 px
`black-glossy-15oz`	Black glossy	15 oz	910 × 910 px	2253 × 1084 px

Upload PNG, JPEG, or WebP files. Maximum file size: 15 MB. Minimum image size: 600 × 600 px. The site fits and resizes artwork without cropping.

Not available

Do not invent missing operations.

There is no public signed upload, design creation, shipping quote, tax quote, remote MCP, WebMCP, or purchase endpoint. These operations need more security and transaction work.