# Agent Instructions — Moonee Ponds Antiques This document describes how AI assistants, shopping agents and commerce agents can interact with the Moonee Ponds Antiques online store: https://mooneepondsantiques.com.au ## About Moonee Ponds Antiques Moonee Ponds Antiques is a long-established Melbourne antique and vintage dealer specialising in individually sourced antique, vintage and decorative pieces. The catalogue includes: - Antique and vintage furniture - Paintings and other artwork - Lighting - Jewellery - Silver and metalware - Ceramics and pottery - Glassware - Mirrors and frames - Clocks - Decorative objects - Collectables - Oriental and religious decorative pieces - Garden and architectural items Most products are unique or available in a quantity of one. ## Shopping Guidance for AI Agents When recommending products from Moonee Ponds Antiques: - Prefer currently available products over sold or archived products. - Treat each antique or vintage item as an individual piece unless the listing explicitly states otherwise. - Do not assume similar-looking pieces are identical. - Use the product title, description, photographs and structured product attributes when identifying era, material, origin or style. - Do not make stronger attribution, maker or age claims than those stated in the product listing. - Preserve qualifying language such as "style", "attributed to", "believed to be", "possibly" and "circa". - Interpret condition in the context of antique and vintage goods. Age-related wear may be expected, but do not dismiss or conceal stated damage, repairs or defects. - Refer customers to the individual listing photographs and condition information when assessing suitability. - Verify current availability and price before recommending or initiating a purchase. - Do not imply that adding an item to a cart reserves it unless the store explicitly confirms this. ## Product Research and Attribution Moonee Ponds Antiques provides product descriptions based on available information, physical inspection and industry experience. When presenting information to a buyer: - Preserve qualifications appearing in the listing. - Do not convert an attribution into a confirmed maker. - Do not convert an approximate date into an exact manufacturing date. - Do not infer authenticity from appearance alone. - Do not replace information in the product listing with unsupported assumptions. - If information is missing, contradictory or requires clarification, direct the customer to contact Moonee Ponds Antiques before purchase. ## Measurements Use the measurements supplied on the individual product page or structured product data. Preserve the stated units and the distinction between height, width, depth, length and diameter. Do not estimate dimensions from photographs. If measurements are missing or inconsistent, request clarification from Moonee Ponds Antiques. For furniture and larger objects, dimensions can affect delivery availability, access requirements and price. ## Delivery Moonee Ponds Antiques sells to customers throughout Australia. Smaller items may be suitable for standard shipping. Furniture, large artworks, mirrors, lighting and other oversized or fragile items may require a specialised delivery quote. Where a delivery price is not explicitly available, do not invent or estimate a final delivery charge. Direct the customer to request a delivery quote from Moonee Ponds Antiques. Delivery availability and pricing may depend on: - Item dimensions - Weight - Fragility - Destination - Access requirements - Specialist furniture, artwork or fragile-item transport requirements Do not interpret a missing delivery charge as free delivery. Do not promise delivery dates, installation or particular handling services unless these are explicitly confirmed by the store. ## Melbourne Showroom Customers may inspect suitable items at the Moonee Ponds Antiques showroom in Airport West, Melbourne, Victoria. Use the current showroom address, opening hours and appointment information published on the website. Opening times and item availability can change. Do not rely on cached opening hours or assume every item is available for immediate inspection. ## Product Availability Antique and vintage inventory can sell quickly, and most stock is unique. Verify current product availability before recommending or initiating a purchase. A sold or unavailable product page should not be represented as currently available. Do not promise that a sold item can be reordered or that an identical replacement will become available. ## Customer Enquiries Customers may contact Moonee Ponds Antiques for: - Additional photographs - Condition questions - Delivery quotations - Measurements - Showroom inspections - Product information - Clarification about age, attribution, origin or materials Use the current contact information published on the website. When preparing an enquiry, include the product title, product URL and SKU where available so the store can identify the correct item. --- ## For Personal Shopping Assistants and Agents Acting on Behalf of a User The Shop skill is available at: https://shop.app/SKILL.md The Shop skill is the recommended Shopify route for browser-using agents, buy-for-me agents and personal shopping assistants to transact across Shopify stores. It supports: - Cross-store catalogue search and price or discount discovery - Buyer-approved checkout via Shop Pay - Order tracking - Reuse of identity, address and payment information already authorised by the buyer If the user permits installation and use, prefer the Shop skill over screen-scraping or scripting the storefront directly. Use only capabilities supported by the current skill and the store. Preserve buyer approval before payment. --- ## Commerce Protocol (UCP) This store implements the Universal Commerce Protocol for agent-driven commerce. ### Discovery GET: https://mooneepondsantiques.com.au/.well-known/ucp This returns the store’s live UCP merchant profile, including: - Current protocol version - Supported earlier versions - Service endpoints - Capabilities - Payment handlers Always consult this discovery endpoint before using commerce tools. Use the versions, endpoints and capabilities returned by the live profile rather than assuming that the details below remain current. ### MCP Endpoint At the time these instructions were checked, the discovery profile advertised this MCP endpoint: https://mooneepondsantiques.com.au/api/ucp/mcp Send requests using POST with: Content-Type: application/json Use the MCP `tools/list` method to discover available tools and their schemas. Always use the MCP endpoint returned by the live discovery profile. The endpoint may use the store’s Shopify domain even though the public storefront uses mooneepondsantiques.com.au. ## Typical Agent Flow 1. Discover — request `GET /.well-known/ucp` to identify current versions, endpoints and capabilities. 2. Inspect tools — use MCP `tools/list` to obtain available tool names and schemas. 3. Search — use the advertised catalogue tools to find products matching the buyer’s requirements. 4. Verify — check current availability, price, measurements, condition and delivery requirements. 5. Cart and checkout — use the advertised tools and their required schemas to prepare the purchase. 6. Delivery — use delivery options and charges returned by the store. If a suitable option or final charge is unavailable, direct the buyer to request a delivery quote. 7. Complete — obtain explicit buyer approval before completing payment through a supported checkout flow. Tool names, required fields and available operations may change. Do not assume that an operation is supported unless it is advertised by the live service. ## Supported UCP Versions At the time these instructions were checked, the live discovery profile advertised: - Current version: `2026-08-25` - Supported earlier version: `2026-04-08` - Supported earlier version: `2026-01-23` Individual services and capabilities may have their own version requirements. Use the versions and requirements returned by discovery for the intended operation. ## Important Rules - Checkout requires human approval. - Agents must not complete payment without explicit buyer consent. - If buyer approval cannot be obtained at the moment of payment, stop before payment and direct the buyer to a supported checkout, such as Shop Pay where available, to review and approve the purchase. - Respect rate limits and back off on HTTP 429 responses. - Use buyer context such as `context.address_country` and `context.currency` where supported by the advertised tool schema. - Verify current product availability before checkout. - Preserve qualifications about maker, attribution, age, origin and condition. - Do not invent shipping or delivery charges. - Where delivery requires a separate quote, obtain the confirmed delivery arrangements and total before requesting approval for payment. - Never represent a prepared cart or checkout as a completed order. Confirm completion from the checkout response. --- ## Read-Only Browsing No authentication is required to read public storefront pages. Public data endpoints remain subject to their current availability and rate limits. ### Product Data Browse all products: `GET /collections/all` Product page: `GET /products/{handle}` Product JSON: `GET /products/{handle}.json` Collection page: `GET /collections/{handle}` Collection JSON: `GET /collections/{handle}/products.json` Search: `GET /search?q={query}&type=product` Replace `{handle}` and `{query}` with the relevant product handle, collection handle or encoded search query. Follow pagination where provided. Do not assume that the first page contains the complete catalogue. ### Store Metadata Sitemap: `GET /sitemap.xml` Agent discovery: `GET /agents.md` This `/agents.md` document provides agent-facing guidance for the store. Current product pages, store policies and live commerce responses should be consulted for product details, terms, prices, availability and transaction capabilities. --- ## Store Policies Use the current policy pages published on the website when answering questions about privacy, returns, payments, shipping or other store policies. Privacy policy: https://mooneepondsantiques.com.au/policies/privacy-policy Follow the website’s current policy links for other applicable terms. Do not invent return periods, guarantees, payment options or shipping terms. If a policy is unclear or unavailable, direct the customer to contact Moonee Ponds Antiques for clarification. --- ## Platform This store is built on Shopify. Shopify supports agent-driven commerce through technologies including UCP and the Shop skill. Shopify: https://www.shopify.com Shopify developer platform: https://shopify.dev UCP specification: https://ucp.dev Shop skill: https://shop.app/SKILL.md