# Agent Instructions — Murano Plus

You can browse products and shop at Murano Plus's online store, https://www.muranoplus.com, on your user's behalf. This guide covers the Shop skill and UCP integration, directly or through browser-based WebMCP tools.

## Shop skill — recommended

Use the [Shop skill](https://shop.com/SKILL.md) to help your user shop with this store. Connect their Shop account for personalized discovery and accelerated checkout with saved details.

- Personalized 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://www.muranoplus.com/.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 (`https://www.muranoplus.com/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-authorized purchases. Follow returned statuses, messages, and handoff URLs when buyer action is required.

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-authorized 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 authorization 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 authorization** — Place orders and submit payment only with the buyer's authorization. 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 recognize 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.

## 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 `/sitemap.xml`.
- Read product pages at `/products/{handle}`.
- 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://www.muranoplus.com/policies/privacy-policy
- **Terms of service**: https://www.muranoplus.com/policies/terms-of-service
- **Refund policy**: https://www.muranoplus.com/policies/refund-policy
- **Shipping policy**: https://www.muranoplus.com/policies/shipping-policy


## Platform

This store is built on [Shopify](https://www.shopify.com), the commerce platform powering millions of stores worldwide. Shopify stores support UCP natively, enabling seamless agent-driven commerce. The Shop skill at
[https://shop.app/SKILL.md](https://shop.app/SKILL.md) works across every Shopify store — install it once and
your agent can transact everywhere.

- Start your own store: https://www.shopify.com/start
- Build and test against sample data: https://mock.shop (free mock Storefront GraphQL API, no store or auth needed)
- Shopify developer platform: https://shopify.dev
- Shop developer platform: https://shop.dev

- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.



## Store Overview
- Store Name: Murano Plus
- Store URL: [www.muranoplus.com](https://www.muranoplus.com)

## Brand Positioning
Shop designer lighting NZ-wide at Murano Plus. Explore chandeliers, pendants, wall lights and bespoke designs, with an Auckland showroom and expert advice.

## Highlighted Products
- [Athena Chandelier - Custom Made](https://www.muranoplus.com/products/athena): A crystal feature pendant light that will bring glamour to any space. The Athena is perfect for that eye-catching statement piece. Long and narrow, th... — 1790.0 NZD
- [Arthur Pendant](https://www.muranoplus.com/products/arthur): Reminiscent of the Victorian era, the Arthur Pendant Light is a quirky yet sophisticated design that undoubtedly adds character in any setting. Availa... — 1018.0 NZD
- [Caen Pendant](https://www.muranoplus.com/products/caen): This rustic Antique Brass lantern is a classic with an ornate frieze, handcrafted in Egypt. Extravagance at its finest. Handcrafted in solid brass wit... — 2400.0 NZD
- [Limoux Chandelier](https://www.muranoplus.com/products/limoux): The Limoux chandelier is an exquisite fitting. The perfect focal point to any sophisticated living space. The contrast of the Egyptian handmade antiqu... — 4890.0 NZD
- [Royan Chandelier](https://www.muranoplus.com/products/royan): The Royan chandelier is an exquisite fitting is the perfect focal point to any sophisticated living space, classic or modern. Completely hand-crafted ... — 2759.0 NZD
- [Vetro Pendant](https://www.muranoplus.com/products/vetro): A sleek Art Deco pendant New York-inspired handcrafted with individual handmade glass rods with a Nickel finished frame. Details Small - 145mm Diamete... — 810.0 NZD
- [Madere Pendant](https://www.muranoplus.com/products/madere): The Madere pendant is a gorgeous mix of industrial contemporary style, combined with the luxury and elegance of premium crystal. Faceted crystals are ... — 3590.0 NZD
- [Jagger Pendant](https://www.muranoplus.com/products/jagger-pendant): This vintage silhouette and a sleek hand-polished brass-based fixture will both perfectly illuminate your kitchen or workplace and provide a perfect c... — 995.0 NZD
- [Hampton Pendant](https://www.muranoplus.com/products/hampton): Give your home the Hamptons feel, with this beautifully detailed pendant. Solid brass frame with unlacquered Antique Brass finish designed to age grac... — 3990.0 NZD
- [Baldwin Pendant](https://www.muranoplus.com/products/baldwin): This timeless classic solid brass fitting has an unlacquered Antique Silver finish designed to age beautifully over time, paired with handmade glass. ... — 690.0 NZD
- [Dae Wall Light](https://www.muranoplus.com/products/dae): The Dae Wall Lamp is an impeccable industrial classic design that combines a lovely handmade glass shade with a dark Antique Brass fitting. Details 21... — 268.0 NZD
- [Fletcher Outdoor Wall Light](https://www.muranoplus.com/products/fletch): Fletcher is an industrial-modern wall light with handcrafted in solid brass with handmade glass. A beautiful and functional feature piece ideal for ne... — 590.0 NZD
- [Cabrini Wall Light](https://www.muranoplus.com/products/cabrini-wall-light): A classic, yet unique fixture, the Cabrini Wall Lamp is a beautiful art-deco style, solid brass wall sconce that is perfect for indoor or outdoor use ... — 1390.0 NZD
- [Eald Wall Light](https://www.muranoplus.com/products/eald): Rustic in style and simple in form, this hand-forged vintage-inspired sconce makes an elegant statement. Solid brass base available in Antique Bronze ... — 325.0 NZD
- [Minerva Chandelier](https://www.muranoplus.com/products/minerva): A custom-made crystal feature pendant light that will bring glamour to any space. The Minerva is perfect for that eye-catching statement piece. Assemb... — 890.0 NZD
- [Wessex Pendant](https://www.muranoplus.com/products/wessex-pendant): The Wessex is a classical lantern with Chrome frame that features clear bevelled glass. Details3 Light - 280mm Diameter x 600mm Height + Suspension | ... — 1149.0 NZD
- [Essex Pendant](https://www.muranoplus.com/products/essex): The Essex pendant light is an elegant hexagon-shaped lantern, perfect in a stairwell or over a kitchen bench. With a range of sizes, play with groupin... — 729.0 NZD
- [Toscana Pendant](https://www.muranoplus.com/products/toscana-large): Toscana is a medieval-inspired chandelier pendant with a Satin Black frame, perfect for a dining table or as a feature in an open-plan living area. Ma... — 1919.0 NZD
- [Sussex Pendant](https://www.muranoplus.com/products/sussex): The Sussex pendant light is a modern take on the early 19th-century gas lamp. The Rubbed Black finish highlights the edges with soft gold detailing. P... — 1405.0 NZD
- [Halo Fine Pendant - Small Single](https://www.muranoplus.com/products/halo-fine): Simplicity with an edge. The Halo Fine pendant range proves that even the simplest of forms can create an impact. Play around with angles, grouping, o... — 485.0 NZD
- [Oregon Pendant](https://www.muranoplus.com/products/oregon): The Oregon pendant light features antiqued 'Mercury' effect glass panes with warm antiqued iron framing in a leadlight-inspired style. An absolutely s... — 2490.0 NZD
- [Cacique Ceiling Mount](https://www.muranoplus.com/products/cacique-ceiling-mounted): The classic Cacique ceiling mounted chandelier in Chrome set with beautiful Premium Crystal prisms is wonderfully detailed to add grace, charm, and el... — 2190.0 NZD
- [Baptiste Pendant Light](https://www.muranoplus.com/products/baptiste-pendant-light): The Baptiste pendant is a unique industrial rustic pendant light, featuring an antiqued patina metal finish with mesh detailing. A beautiful option fo... — 1990.0 NZD
- [Basilio Pendant](https://www.muranoplus.com/products/basilio-pendant): The Basilio pendant light has an industrial rustic look and features a patina metal finish with mesh inserts to gently diffuse the light. A stunning a... — 1740.0 NZD
- [Edgar Wall Light](https://www.muranoplus.com/products/edgar): Simple, classy black/bronze finished metal wall sconce captured in a glass box. Suitable for interior use only. Details 200mm W x 120mm D x 400mm H | ... — 550.0 NZD
- [Wayfarer Wall Light](https://www.muranoplus.com/products/wayfarer): The Wayfarer wall light is suitable for both indoor and outdoor use. Available in Antique Black, Brass or Silver finish, electroplated over solid bras... — 690.0 NZD
- [Olge Pendant](https://www.muranoplus.com/products/olge-pendant): Olge is a simple Opaque White glass pendant light with an edge. Mix and match the various sizes and shapes to create visual interest, and change the l... — 425.0 NZD
- [Droim Chandelier](https://www.muranoplus.com/products/droim): The Droim chandelier is a modern classic chandelier, beautiful in it's simplicity, and inspired by the best of modern Italian design. Star-profiled cr... — 2990.0 NZD
- [Crystal Faceted Oval LED E27 Light Bulb - 60D](https://www.muranoplus.com/products/pineapple): A faceted oval solid crystal bulb with gold fitting. Available in an E14 or E27 screw format. Details E27 Crystal Faceted Oval LED 5W - φ60*80 - Warm ... — 68.0 NZD
- [Crystal Round Faceted LED E14 Light Bulb](https://www.muranoplus.com/products/beehive): A faceted rounded solid crystal bulb with gold fitting. Details E14 Crystal Faceted Round LED 3W - 50D - 3000K Warm White Dimmable — 59.0 NZD
- [Crystal Diamond LED E27 Light Bulb - 100D](https://www.muranoplus.com/products/diamond): A faceted diamond-shaped solid crystal bulb with gold fitting. Real premium crystal. Details E27 Large - Crystal Diamond LED 5W 3000K - 100D*58 - Warm... — 99.0 NZD
- [Crystal Oval LED E27 Light Bulb](https://www.muranoplus.com/products/cylinder): An elongated oval solid crystal bulb with inner cylindrical feature and gold fitting. Available in both E14 and E27 screw formats. Details E27 Crystal... — 89.0 NZD
- [All Star 3W 3000K LED E27 Light Bulb](https://www.muranoplus.com/products/s-all-star): Starry effect "All Star" filament bulb, pear shaped with textured surface. Details E27 LED Bulb 3W 3000K Non-dimmable | 92mm D x 130H — 69.0 NZD
- [Philips G9 LED Bulb 2.3W 2700K](https://www.muranoplus.com/products/g9-dimmable): A practical G9 bulb suitable for many smaller fittings. Details Philips CorePro - G9 LED Bulb 2.3W 2700K Dimmable 215 Lumen — 18.0 NZD
- [Crystal Candle LED E14 Light Bulb](https://www.muranoplus.com/products/candle-crystal): This beautiful lightbulb is our bestseller for use in chandeliers, adding an extra dimension of genuine premium faceted crystal. Also suitable for pen... — 38.0 NZD
- [G125 Filament 8W 2700K Dimmable LED E27 Light Bulb](https://www.muranoplus.com/products/antique-edison): A large round Clear glass bulb with LED filaments. Details E27 G125 LED 8W - 2700K Warm White Dimmable — 42.5 NZD
- [X Cross Pendant](https://www.muranoplus.com/products/x-cross-pendant): This fantastic industrial-style pendant will make an impact in any space. A great practical option, the X Cross features both up and down lighting. Tr... — 133.0 NZD
- [Capuche Pendant](https://www.muranoplus.com/products/capuche): An industrial-inspired pendant with a rustic Black iron finish. The interior of the pendant reflects a warm glow. Folded edges give the Capuche pendan... — 789.0 NZD
- [Cosima Chandelier - Large](https://www.muranoplus.com/products/cosima): Simply stunning and handmade, The Cosima hand-crafted glass leaf chandelier is an inspired future classic adding subtle glamour and WOW to any environ... — 9999.0 NZD
- [Piramide Chandelier](https://www.muranoplus.com/products/piramide-chandelier): The Piramide chandelier features stunning star-shaped crystal lengths suspended at different levels to create a layered silhouette. A timeless feature... — 2249.0 NZD
- [Marco Pendant](https://www.muranoplus.com/products/marco): Marco is a gorgeous Clear glass and Matt Black chandelier pendant light. Would make a bold statement in any modern or contemporary space. A number of ... — 635.0 NZD
- [Seis Pendant](https://www.muranoplus.com/products/seis): Seis is a pendant light inspired by mid-century modern design. The Chrome frame features 6 adjustable arms that can be rotated to create new looks. Cr... — 379.0 NZD
- [Galaxy Pendant](https://www.muranoplus.com/products/galaxy-balls): Stunning solid crystal balls, with a bubbled interior to the crystal that gives a gorgeous effect when lit. Hang a single pendant for minimalist impac... — 128.0 NZD
- [Monaco Brass Pendant](https://www.muranoplus.com/products/monaco): This is a brushed Antique Brass finish fitting that is truly stunning with brass linked pole suspension. A simple yet impactful retro-industrial inspi... — 949.0 NZD
- [Alpha Pendant](https://www.muranoplus.com/products/alpha): Alpha is a contemporary range available in a variety of formats, with clear etched glass sections joined with Polished Rose Gold fittings. Details Sec... — 1190.0 NZD
- [Catie Pendant](https://www.muranoplus.com/products/catie): The Catie pendant light is a glamorous ring embellished with delicate crystals for the utmost in luxury. This pendant light will add elegance and extr... — 2299.0 NZD
- [Damien Wall Light](https://www.muranoplus.com/products/damien): A unique contemporary wall light featuring a handmade clear textured glass panel in a brass frame. Details 145mm Width x 145mm Depth x 300mm Height | ... — 1290.0 NZD
- [Cronus Pendant](https://www.muranoplus.com/products/cronus): The unique Cronus pendant features Black or Gold fittings paired with rippling sheets of glowing acrylic. Adjust the height of each individual acrylic... — 2490.0 NZD
- [Vera Pendant](https://www.muranoplus.com/products/vera): Stylish modern-glam pendant light with frosted bulb covers to illuminate the entire room. Available in two sizes, this light can be used in various ro... — 950.0 NZD
- [Linza Pendant](https://www.muranoplus.com/products/linza): Stylish and modern, this playful light features rods of light in an angled arrangement to add a sense of movement in the space. Matt Black frame with ... — 1990.0 NZD