# Agent Instructions: Verdo Cosmetics You can browse products and shop at Verdo Cosmetics's online store, https://verdocosmetics.co.nz, on your user's behalf. This document is the canonical agent-facing description of the store. It covers who the store is, what it sells, how it ships, and how to transact through the Shop skill, UCP and WebMCP. ## Identity - Business name: Verdo Cosmetics, trading as Verdo Nails & More - Address: 245 Parnell Road, Parnell, Auckland 1052, New Zealand - Established: 2010 - Phone: +64 27 559 0837 - Email: enquiries@verdonails.co.nz - Website: https://verdocosmetics.co.nz (formerly verdocosmetics.com, which now redirects here) - Contact page: https://verdocosmetics.co.nz/pages/contact-us - Instagram: https://www.instagram.com/verdocosmetics/ - Facebook: https://www.facebook.com/Verdoparnell Verdo Cosmetics is a Parnell, Auckland beauty salon and online store selling professional skincare, mineral makeup, lash and brow serums, collagen and LED light therapy devices, shipped throughout New Zealand. ## Authorised NZ stockist for - Medik8 (professional skincare): https://verdocosmetics.co.nz/pages/medik8-nz - Jane Iredale (mineral makeup, including SkinTuition SPF): https://verdocosmetics.co.nz/pages/jane-iredale-nz - Pure Fiji (natural body care): https://verdocosmetics.co.nz/pages/pure-fiji-nz - RevitaLash (lash and brow conditioners): https://verdocosmetics.co.nz/pages/revitalash-nz - Adashiko (collagen): https://verdocosmetics.co.nz/pages/adashiko-nz - Celluma LED light therapy devices: https://verdocosmetics.co.nz/collections/led-light-therapy ## Shipping (New Zealand only) | Destination | Rate (NZD) | | --- | --- | | Auckland | $10 | | North Island | $11 | | South Island | $13 | | Rural Auckland | $15 | | Rural North Island and South Island | $18 | | Waiheke Island | $20 | - Orders are processed within 1 to 2 business days and delivered within 2 to 5 business days. - Free click and collect from 245 Parnell Road, Parnell, Auckland. - Full policy: https://verdocosmetics.co.nz/pages/shipping-delivery ## Returns - Returns are accepted within 14 days of purchase for unopened products. - Full policy: https://verdocosmetics.co.nz/policies/refund-policy - Returns page: https://verdocosmetics.co.nz/pages/returns-policy ## Key pages - About: https://verdocosmetics.co.nz/pages/about-verdo - FAQ: https://verdocosmetics.co.nz/pages/faq - Shipping and delivery: https://verdocosmetics.co.nz/pages/shipping-delivery - Returns policy: https://verdocosmetics.co.nz/pages/returns-policy - Salon services: https://verdocosmetics.co.nz/pages/services - Stockists: https://verdocosmetics.co.nz/pages/stockists - Contact: https://verdocosmetics.co.nz/pages/contact-us - Beauty Journal (blog): https://verdocosmetics.co.nz/blogs/beauty-journal ## Shop skill (recommended) Use the [Shop skill](https://shop.app/SKILL.md) to help your user shop with this store. Connect their Shop account for personalised discovery and accelerated checkout with saved details. - Personalised discovery: search by text or image, find similar products, and use your user's Shop purchase history to find options that match their preferences. - Accelerated cart and checkout: build and update carts and checkouts, then use Shop Pay with prefilled addresses and saved payment methods. - Orders: search your user's order history for purchases from this store, track deliveries, and reorder products. Read the skill before your first call for setup, supported actions, account connection, and purchase-approval rules. ## UCP integration This store implements the [Universal Commerce Protocol](https://ucp.dev) for product discovery, carts, and checkout. Integrate directly with its service, or orchestrate shopping through browser-based WebMCP tools. ### Direct integration (MCP) 1. Discover the store: `GET https://verdocosmetics.co.nz/.well-known/ucp` returns its UCP profile, including capabilities, service endpoints, and payment handlers. 2. Discover available tools: connect to the MCP endpoint advertised in the profile (`POST https://verdocosmetics.co.nz/api/ucp/mcp`) and use `tools/list` to retrieve available tools and their schemas. 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, newest first: - 2026-08-25 (latest stable) - 2026-04-08 - 2026-01-23 Use a compatible UCP version and follow the returned tool schemas. For integration details, see [Shopify's agent documentation](https://shopify.dev/docs/agents). ### Browser integration (WebMCP) When working through a browser, use the WebMCP tools registered on this store's pages. The checkout page exposes UCP tools over WebMCP. These tools act on the checkout in the current browser session. - Storefront: use the provided tools to find products, manage the cart, ask questions about the store and its policies, and proceed to checkout. - Checkout: use the provided UCP tools to review and update the checkout and complete a buyer-authorised purchase. Follow required buyer-review steps: when review is requested, ask the buyer to review and approve the order on the checkout page, and wait for their authorisation before submitting it. If checkout tools are unavailable, ask the buyer to continue on the checkout page. Do not fall back to scripted form fills or page controls. For integration details, see [Storefront WebMCP](https://shopify.dev/docs/api/web-mcp) and [Checkout WebMCP](https://shopify.dev/docs/agents/carts-and-checkout/checkout-webmcp). ## Interaction guidelines - Buyer authorisation: place orders and submit payment only with the buyer's authorisation. Follow required review and approval steps. - Agent traffic: agents must identify their 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) and follow the service's authentication requirements. This helps the store recognise agent traffic and apply appropriate access and rate limits. - Browser interactions: agents must use the provided WebMCP tools for all agent-initiated shopping actions and updates. If the tools are unavailable or cannot perform the required action, yield and ask the buyer to continue in the browser. Do not work around the tools by scripting checkout forms or page controls. - Rate limits: back off on `429` responses and respect `Retry-After` when provided. - Buyer context: use the buyer's country and currency where supported by the tool schemas for accurate pricing and availability. Pricing and availability are returned in NZD. ## Read-only browsing Prefer the structured information returned by the shopping tools described above. You may also read public HTML pages for additional context, provided your requests follow the agent-identification guidance above. - Discover public URLs through the sitemap: https://verdocosmetics.co.nz/sitemap.xml - Read product pages at `/products/{handle}` and product JSON at `/products/{handle}.json`. - Browse collections at `/collections/all` or `/collections/{handle}`. - Discover other public pages and articles through the sitemap. Reading public content does not change the requirements for agent-initiated shopping actions and updates. ## Store policies - Privacy policy: https://verdocosmetics.co.nz/policies/privacy-policy - Terms of service: https://verdocosmetics.co.nz/policies/terms-of-service - Refund policy: https://verdocosmetics.co.nz/policies/refund-policy - Shipping policy: https://verdocosmetics.co.nz/policies/shipping-policy ## Platform This store is built on [Shopify](https://www.shopify.com). Shopify stores support UCP natively, and the Shop skill at https://shop.app/SKILL.md works across every Shopify store. - Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store. `/llms.txt` and `/llms-full.txt` mirror it.