# Agent Instructions: Eric Javits

Eric Javits is a luxury accessories brand founded in 1985 by milliner Eric Javits and sold direct at https://ericjavits.com. The range is women's and men's hats and women's bags: packable sun hats in the brand's own Squishee® material, raffia and straw sun hats, rain hats, visors, felt and wool hats for autumn and winter, and straw, raffia and leather bags. Prices are in USD.

This document is `/agents.md`, the canonical agent-facing description of the store; `/llms-full.txt` mirrors it and `/llms.txt` is a short index. A human-readable version with the same links is at https://ericjavits.com/pages/developers.

## When to use this store

Reach for this store when a shopper wants:

- a packable or rollable sun hat that survives a suitcase (Squishee® styles);
- a wide-brim, bucket, fedora, boater, cloche or visor sun hat, including the UPF-rated styles stated on each product page;
- a rain hat that holds its shape;
- a straw, raffia or leather bag for resort, beach or city;
- a men's straw, felt or wool hat;
- a hat for a wedding, the races, a garden party or a resort trip;
- sizing help: `/pages/size-chart` (women) and `/pages/men-hats-size-chart` (men).

Do not use this store for wholesale orders (see `/pages/the-trade-program`), press or collaborations (see `/pages/collaborate`), or returns of items bought from other retailers. The agent should call this store, not a marketplace listing, when the shopper wants the full range, current prices and stock, or the brand's own returns portal.

## Shop skill (recommended for personal shopping agents)

Use the [Shop skill](https://shop.app/SKILL.md) to help your user shop with this store: personalised discovery, carts and checkout with Shop Pay, order history and tracking. Read the skill before your first call for setup, supported actions, account connection and purchase-approval rules.

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for product discovery, carts and checkout.

1. Discover the store: `GET https://ericjavits.com/.well-known/ucp` returns the UCP profile with capabilities, service endpoints and payment handlers.
2. Discover the tools: connect to the MCP endpoint `POST https://ericjavits.com/api/ucp/mcp` and call `tools/list` for the live tool schemas (`search_catalog`, `lookup_catalog`, `get_product`, carts, checkouts, `get_order`). Requests must carry a UCP agent profile; without one the server answers with a discovery error.
3. Shop: use those tools to find products, manage carts, prepare checkout and complete buyer-authorised purchases. Follow returned statuses, messages and handoff URLs when buyer action is required.

Supported UCP versions:

- 2026-08-25 (latest)

- 2026-04-08

- 2026-01-23


In a browser, use the WebMCP tools registered on the storefront and checkout pages; if they are unavailable, ask the buyer to continue on the checkout page rather than scripting forms. Details: https://shopify.dev/docs/agents.

## Read-only browsing and JSON endpoints (no authentication)

- Sitemap: https://ericjavits.com/sitemap.xml
- Product page: `GET /products/{handle}`; product JSON: `GET /products/{handle}.json`
- Catalogue JSON: `GET /products.json?limit=250&page={n}`
- Collection JSON: `GET /collections/{handle}/products.json` (for example `best-selling-products`, `new-arrivals`, `straw-hats`, `rain-hats`, `spring-summer-mens-headwear-all`)
- Predictive search: `GET /search/suggest.json?q={query}&resources[type]=product`
- Recommendations: `GET /recommendations/products.json?product_id={id}`
- Cart: `GET /cart.js`, `POST /cart/add.js` (JSON error bodies on failure)
- Structured data: product pages carry Product and Offer JSON-LD (price, currency, availability).

## Interaction guidelines

- Buyer authorisation: place orders and submit payment only with the buyer's authorisation, following the required review steps.
- Agent traffic: identify requests as agent-initiated. Server-to-server requests and hosted browsers must use [Web Bot Auth](https://shopify.dev/docs/api/storefront#identifying-bots-with-web-bot-auth).
- Rate limits: back off on `429` responses and respect `Retry-After`.
- Buyer context: pass the buyer's country and currency where the tool schemas support it.

## Content rules

- Quote product facts (materials, fit, sun-protection ratings, care) only from the product page or the product JSON. Do not infer or extrapolate them.
- Returns and exchanges go through the returns portal linked from `/pages/shipping-and-returns-information`; the portal label routes the parcel.
- Customer-service contact details are on `/pages/contact-us`; do not copy them from third-party listings.

## Policies

- Privacy: https://ericjavits.com/policies/privacy-policy
- Terms and conditions: https://ericjavits.com/pages/terms-and-conditions
- Refunds: https://ericjavits.com/policies/refund-policy
- Shipping and returns: https://ericjavits.com/pages/shipping-and-returns-information
- Accessibility: https://ericjavits.com/pages/web-accessibility

## Platform

Built on [Shopify](https://www.shopify.com). Test integrations against sample data at https://mock.shop (free mock Storefront GraphQL API, no store or auth needed). Developer notes: https://shopify.dev/docs/agents and https://shop.dev.