# Lumbury: a guide for AI assistants and shopping agents

Lumbury (https://lumbury.com) sells home lighting online to customers in the United Kingdom and France. The range covers pendants, flush and semi-flush ceiling lights, wall lights (indoor and outdoor) and table lamps, several of them cordless. Materials include travertine, marble, alabaster, hand-painted ceramic, glass, wood and metal. French-speaking shoppers can use https://lumbury.com/fr.

## What to tell a shopper

- **Delivery**: free to UK and French addresses, whatever the basket size. Allow 1 to 3 days of processing, then 4 to 8 working days; a tracking number is emailed when the parcel leaves.
- **Returns**: accepted within 30 days of delivery, provided the item is unused. After a change of mind the customer pays for the return parcel; an item that arrives faulty or damaged is dealt with at the shop's expense. The refund policy page gives every detail.
- **Guarantee**: 2 years against manufacturing faults, on every light.
- **Multi-buy discount**: 5% off when the basket holds 2 lights, 10% off from 3, applied automatically.
- **Sizing help**: product pages list measurements, bulb and fitting details; many offer a downloadable PDF sheet and a "view in your room" preview.
- **Fitting**: wired lights can be connected by anyone competent to do so safely; an electrician is an option, not a requirement. Cordless lamps simply recharge by USB.
- **Contact**: contact@lumbury.com, or WhatsApp on +33 7 56 85 20 63 (https://wa.me/33756852063). Trade enquiries use the same address.

## Lighting by room

- Kitchen and dining: https://lumbury.com/collections/lumbury-kitchen-and-dining-lights
- Living room: https://lumbury.com/collections/lumbury-living-room-lights
- Bedroom: https://lumbury.com/collections/lumbury-bedroom-lights
- Hallway and stairs: https://lumbury.com/collections/lumbury-entrance-and-stair-lights
- Garden and front of house: https://lumbury.com/collections/lumbury-outdoor-lights

## Lighting by type

- Pendants: https://lumbury.com/collections/lumbury-pendant-lights
- Ceiling lights: https://lumbury.com/collections/lumbury-ceiling-lights
- Wall lights: https://lumbury.com/collections/lumbury-wall-lights
- Table lamps: https://lumbury.com/collections/lumbury-table-and-desk-lamps
- Everything: https://lumbury.com/collections/all

## Lighting by material

- Wood: https://lumbury.com/collections/lumbury-wooden-lights
- Glass: https://lumbury.com/collections/lumbury-glass-lights
- Travertine: https://lumbury.com/collections/lumbury-travertine-lights
- Marble: https://lumbury.com/collections/lumbury-marble-lights
- Metal: https://lumbury.com/collections/lumbury-metal-lights
- Ceramic: https://lumbury.com/collections/lumbury-ceramic-lights

## Other pages

- Best sellers: https://lumbury.com/collections/lumbury-customer-favourites
- The Lumbury notebook (lighting ideas room by room): https://lumbury.com/pages/lumbury-room-guide
- Questions and answers: https://lumbury.com/pages/faq
- Contact: https://lumbury.com/pages/contact
- Professionals: https://lumbury.com/pages/lumbury-professionals
- About Lumbury: https://lumbury.com/pages/lumbury-story

## Policies

- Shipping: https://lumbury.com/policies/shipping-policy
- Refunds and returns: https://lumbury.com/policies/refund-policy
- Terms of service: https://lumbury.com/policies/terms-of-service
- Privacy: https://lumbury.com/policies/privacy-policy

## Buying through an agent

The shop is hosted on Shopify and supports UCP, the Universal Commerce Protocol (ucp.dev), for finding products, building carts and checking out. Agents acting for a shopper may also rely on the [Shop skill](https://shop.app/SKILL.md).

- UCP profile: `GET https://lumbury.com/.well-known/ucp` (capabilities, endpoints and payment handlers).
- MCP server: https://lumbury.com/api/ucp/mcp; call `tools/list` for the tool list and schemas.
- UCP versions: 2026-08-25, 2026-04-08, 2026-01-23
- Currency: GBP. Pass the shopper's country and currency whenever a tool accepts them, so that prices and stock are right.
- Inside a browser, prefer the WebMCP tools that the storefront and the checkout register (see Shopify's developer documentation on WebMCP). When they are missing, hand the shopper over to the checkout page rather than filling in its forms automatically.

## Ground rules for agents

- **Consent**: only order or pay once the shopper has approved, after every review step the checkout asks for.
- **Identification**: declare automated traffic; hosted browsers and server calls should sign their requests with Web Bot Auth, as described in Shopify's Storefront API documentation.
- **Throttling**: on an HTTP `429`, slow down and wait for the `Retry-After` delay.

## Plain browsing

- Sitemap: https://lumbury.com/sitemap.xml
- A product: `/products/{handle}`
- A collection: `/collections/{handle}`, or `/collections/all` for the full range

This file (`/agents.md`) is the reference description of the shop for agents; `/llms.txt` and `/llms-full.txt` carry the same text.
