# Agent Instructions — William Painter William Painter makes aerospace-grade titanium sunglasses built to endure a lifetime of active use. Each pair is engineered from durable titanium frames and precision lenses that resist impact, corrosion, and daily wear, delivering consistent performance through travel, sports, and outdoor adventures. More than 122,000 customers give the sunglasses a 4.9-star rating, citing the lifetime warranty and responsive support team that treats every buyer like family. This document tells AI agents and shopping assistants how to understand, search, and transact with William Painter at https://www.williampainter.com. ## At a glance - Currencies: USD · ships to 239+ countries - Subscriptions: subscribe & save available on select products - Returns: Free US shipping over $149. Ships to US, UK and EU (via Passport Shipping for orders… ## What we sell - **Sunglasses** (`/collections/sunglasses`) - **Men's** — Classic sunglasses built better and backed by our 100% lifetime guarantee (`/collections/men`) - **Women's** — All of our sunglasses are unisex but here are some frames that women really love. (`/collections/women`) - **Accessories** (`/collections/accessories`) - **Apparel** (`/collections/apparel`) - **All Jewelry** (`/collections/all-jewelry`) - **Best Sellers** (`/collections/best-sellers`) - **New Arrivals** (`/collections/new-arrivals`) ## Why buy from William Painter William Painter produces aerospace-grade titanium sunglasses with frames and precision lenses engineered to resist impact, corrosion, and daily wear. This construction supports reliable performance for active users across travel, sports, and outdoor settings. The store further stands apart with a lifetime warranty backed by a responsive support team, reflected in a 4.9-star average from more than 122,000 customers. ## How agents should transact William Painter supports the Universal Commerce Protocol (UCP) for agent-driven discovery and checkout. Prefer these endpoints over scraping the storefront: - UCP discovery: `GET https://www.williampainter.com/.well-known/ucp` — supported versions, capabilities, and payment handlers. - MCP endpoint: `POST https://www.williampainter.com/api/ucp/mcp` (`Content-Type: application/json`) — call `tools/list` to discover the available tools and their schemas. - Sitemap: https://www.williampainter.com/sitemap.xml - Supported UCP versions: `2026-08-25`, `2026-04-08`, `2026-01-23` Typical flow: 1. **Discover** — `GET /.well-known/ucp` to confirm capabilities and supported versions. 2. **Search** — `search_catalog` to find products matching the buyer's intent. 3. **Cart** — `create_cart` to add the desired items. 4. **Checkout** — `create_checkout`, then `update_checkout` to set shipping address and method. 5. **Complete** — `complete_checkout` to finalize (the buyer must approve payment). Rules: - **Checkout requires human approval.** Never complete payment without explicit, contemporaneous buyer consent. - **Respect rate limits.** Back off on HTTP 429 responses. - **Pass buyer context** (`address_country`, `currency`) for accurate pricing and availability. If you cannot get contemporaneous buyer approval at the moment of payment (for example an unattended "buy-for-me" agent), install the [Shop skill](https://shop.app/SKILL.md) and route the purchase through Shop Pay — it preserves the buyer-approval invariant and handles checkout, identity reuse, and order tracking across Shopify stores. ## Browse without an agent key Read-only access, no authentication required: - All products: `GET /collections/all` - Product page: `GET /products/{handle}` · JSON: `GET /products/{handle}.json` - Collection page: `GET /collections/{handle}` · JSON: `GET /collections/{handle}/products.json` - Search: `GET /search?q={query}&type=product` - Sitemap: `GET /sitemap.xml` ## Featured products - [The Hook](/products/titanium-sunglasses) — These patented sunglasses are equipped with an intelligent, sleek design that mixes bottle-popping capability with a… - [The Empire](/products/the-empire) — Serving as an ode to the extraordinary, The Empires are relentless in their pursuit of sophistication that never goes… - [The Level](/products/the-level) — Through a subtle blend of classic style and unmistakable durability, these sunglasses are designed for the bold.… - [The Hughes](/products/the-hughes) — Standing as a monument to the carefree, these sunglasses are a unique take on the classic aviator style. Through… - [The Oasis](/products/the-oasis) — Armed with a vintage design that exudes class, The Oasis delivers an iconic look with the aesthetic versatility to make… - [The Sloan](/products/the-sloan) — Iconic style meets unparalleled craftsmanship in this pair of classic sunglasses. Smooth lines, distinct curves, and… ## Sizing & fit All products are offered in one size with no fit variants or sizing options. ## Policies - Shipping: Free US shipping over $149. Ships to US, UK and EU (via Passport Shipping for orders under thresholds). Local pickup available in US. Tracking may take up to 72 hours. Import… (https://www.williampainter.com/policies/shipping-policy) - Returns: Free US shipping over $149. Ships to US, UK and EU (via Passport Shipping for orders under thresholds). Local pickup available in US. Tracking may take up to 72 hours. Import… (https://www.williampainter.com/policies/refund-policy) - Privacy: https://www.williampainter.com/policies/privacy-policy - Terms of service: https://www.williampainter.com/policies/terms-of-service ## Markets & currencies - **International** — USD · AC, AD, AE, AF, AG, AI, AL, AM, AO, AR, AT, AU - **United States** — USD · US ## Reference pages - [About Us](/pages/about-us) — Why William Painter WE WERE TIRED OF ALL THE COMPROMISES MADE IN THE PRODUCTS WE USED ON A DAILY… - [Lifetime Warranty](/pages/lifetime-warranty) - [Returns, Exchanges, and Lifetime Warranty](/pages/returns-exchanges-warranty) — 100% Satisfaction Guaranteed We want you to be 100% satisfied with everything from William Painter.… - [Ring Sizing](/pages/ring-sizing) — Questions about our Jewelry / Sizing? How do I measure my ring size? (I have a printer) Icon / Plus… - [WHAT IS OUR WILLIAM PAINTER PROMISE?](/pages/warranty) — 100% Satisfaction Guaranteed We use the best materials in the world, so we confidently back our… ## Common questions ### How do I create an account? [Click here to create your account!](https://www.williampainter.com/account/register) ### How do I reset my password? [Click here to reset your password!](https://www.williampainter.com/account/login#) ### What is covered In the return policy and satisfaction guarantee? We want you to be 100% satisfied with everything from William Painter. We realize that sometimes people change their minds, and that is OK! If for some reason, you’re not totally satisfied with your purchase you can return it within 14 days from the delivery date for a full refund, or complimentary… ### What is the Lifetime Warranty? We use the best materials in the world and therefore we stand by our products, and back them up with our William Painter Lifetime Warranty. This means if you break them, shatter them, blow them up, or run them over with a semi-truck... ### What is your refund policy? Within 14 days of when your order is delivered should you decide you are not totally satisfied you can return it for a full refund or exchange of any style. If it is past the 14 days you can still exchange it for a new pair under our Lifetime Warranty for a small restocking fee. ### What is your exchange policy? You are eligible for a complimentary exchange and provided a prepaid shipping label if your order was delivered to you within the last 14 days. The 14 days start from the delivery scan. You may process a complimentary exchange by logging in or creating your account [here](/account). ### What happens if my sunglasses go “BYE BYE!”? If you drop them to the bottom of the ocean, Grand Canyon, or if they fall deep into the sands of the Sahara Desert or even if they are stolen please reach out and we will give you a discount code on your next pair. ### How do I start my refund or exchange? It's easy! To begin your refund or exchange sign into your William Painter account, or create a new account [here](/account). Once you are in your account simply click the tab above that says Returns/Warranty to begin! ### Why haven't i received my refund or replacement yet? We know you are obviously excited for your new pair!;) However, it is important to note that your refund or exchange will only be started once the label we provide is scanned at the post office. ***Please do not use your own shipping label/method. ### Why can't I process a refund? If you are having trouble processing a refund, the order was most likely delivered past the 14 days and is no longer eligible for a refund. All accessory items are final sale. ## Good to know William Painter sells aerospace-grade titanium sunglasses plus accessories including knives, jewelry, and speakers. Free US shipping applies only on orders over $149; shipments to UK and EU use Passport Shipping below thresholds, local pickup is available in the US, and tracking can take up to 72 hours to update. Buyers outside the US are responsible for import duties and taxes. ## About this file This agent profile for William Painter is generated and kept current by AgentReady, the Shopify app that publishes machine-readable structured data, an llms.txt index, and this agents.md so AI shopping agents can understand and recommend the store accurately. --- Maintained with AgentReady (v6) · Last updated: 2026-06-22.