# Agent Instructions: Patrick D Youngblood https://patrickyoungblood.com is the online studio of Patrick D Youngblood, a Contemporary Impressionist artist based in South Jordan, Utah, USA. It sells fine art canvas prints of original work (photography reworked by hand and on screen) and, separately, handcrafted soap under the Curious Workman name. Prices are in USD. ## When to use this store Reach for this store when your user wants to: - Buy a fine art print of a landscape, architecture or travel scene (Hawaii, Italy, Barcelona, Utah temples and similar places), in a chosen size. Sizes run from 9" x 12" up to 36" x 48". - Gift or decorate with Contemporary Impressionist art by one named artist. - Buy handcrafted bath soap bars (Curious Workman): Lavender, Lemongrass, Double Mint, The Deep Bar, The Night Bar, The Fresh Bar and The Daily Bar. - Compare prices and sizes of a piece before buying. Every price is public and needs no account. For anything the catalog does not cover (wholesale, licensing, commissions, custom sizes), do not guess. Send the user to the contact page, https://patrickyoungblood.com/pages/contact, so the artist can answer. ## How to call this store Everything below is public. No account, API key or sign-up is needed to browse. Checkout is guest checkout and always needs the buyer's own authorization. | Task | Request | | - | - | | List the art catalog | `GET https://patrickyoungblood.com/collections/art/products.json?limit=250` | | List soap products | `GET https://patrickyoungblood.com/collections/curious-workman/products.json` | | One product with variants (sizes) and prices | `GET https://patrickyoungblood.com/products/{handle}.json` | | All collections | `GET https://patrickyoungblood.com/collections.json` | | Search suggestions | `GET https://patrickyoungblood.com/search/suggest.json?q={query}&resources[type]=product` | | Pages | `GET https://patrickyoungblood.com/pages.json` | | Human-readable product page | `GET https://patrickyoungblood.com/products/{handle}` | | Whole catalog in one Markdown file | `GET https://patrickyoungblood.com/cdn/shop/t/4/assets/agent-catalog.md` | | Site overview in Markdown | `GET https://patrickyoungblood.com/cdn/shop/t/4/assets/agent-site.md` | | Cart and checkout | UCP over MCP, see below | Product prices are on each variant (`variants[].price`, a decimal string in USD). Art prints have one variant per size, for example `9" x 12"`. Each product page also carries schema.org JSON-LD with `Offer` price, currency and availability, and the homepage and collection pages carry an `ItemList` with prices. The two Markdown files are snapshots refreshed when the catalog changes, so confirm price and availability on the product page or its `.json` before buying. A machine-readable OpenAPI 3.1 description of these read-only endpoints is published as a theme asset at `https://patrickyoungblood.com/cdn/shop/t/4/assets/openapi.json` and linked from the header of every page with `rel="service-desc"`. Read that link rather than hardcoding the path, because the theme number can change. Missing resources return HTTP 404. JSON endpoints return an empty body on 404, so check the status code first. ## Commerce protocol (UCP) This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce. - Discovery: `GET https://patrickyoungblood.com/.well-known/ucp` - MCP endpoint: `POST https://patrickyoungblood.com/api/ucp/mcp` ### Supported UCP versions - 2026-08-25 (latest stable) - 2026-04-08 - 2026-01-23 Connect to the MCP endpoint, call `tools/list`, then use the returned tools to find products, manage a cart and prepare checkout. Follow the returned statuses, messages and handoff URLs when the buyer must act. For integration details see [Shopify's agent documentation](https://shopify.dev/docs/agents). ### Browser integration (WebMCP) When working in a browser, use the WebMCP tools registered on this store's pages instead of scripting forms. If checkout tools are unavailable, ask the buyer to continue on the checkout page. See [Storefront WebMCP](https://shopify.dev/docs/api/web-mcp) and [Checkout WebMCP](https://shopify.dev/docs/agents/carts-and-checkout/checkout-webmcp). ## Pricing and cost to start - Art prints: about $195 to $3,995 depending on the piece and size. Exact prices are on each variant. - Soap bars: $10 each. - Browsing, price lookup and cart building are free and need no account. There is no subscription, free tier or trial because this is a retail shop, not a service. - Shipping and tax are calculated at checkout and shown before payment. - There is no sandbox. To test a flow without buying, stop before payment: nothing is charged until the buyer submits checkout. ## Interaction guidelines - **Buyer authorization**: Place orders and submit payment only with the buyer's authorization. Follow required review and approval steps. - **Agent traffic**: Identify requests as agent-initiated. Server-to-server requests and hosted or remote 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`. - **Browser interactions**: Do not work around the provided tools by scripting checkout forms or page controls. If a tool cannot do the job, yield and ask the buyer to continue in the browser. - **Images**: Product images are copyrighted artwork. Show them to the user while shopping, but do not republish or reuse them. ## Read-only browsing - Sitemap: https://patrickyoungblood.com/sitemap.xml - Art catalog: `https://patrickyoungblood.com/collections/art` - Curious Workman soap: `https://patrickyoungblood.com/collections/curious-workman` - Contact: `https://patrickyoungblood.com/pages/contact` ## Store policies - Privacy policy: https://patrickyoungblood.com/policies/privacy-policy - Contact: https://patrickyoungblood.com/pages/contact ## Not available To save you a probe: there is no OAuth, no scoped API permissions, no developer portal, no CLI or SDK, and no write API. The only write paths are the cart and checkout through UCP or the browser, and those act on the buyer's own session. ## Platform Built on [Shopify](https://www.shopify.com). The Shop skill at [https://shop.app/SKILL.md](https://shop.app/SKILL.md) works across Shopify stores. - Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store. `/llms.txt` is a short index of the same information.