# Leaves To Lights — Agent Guide

> This document tells AI agents and assistants how to work with leavestolights.com.

Leaves To Lights sells seasonal home decor: fall wreaths and porch decor, Thanksgiving table linens and centerpieces, Christmas ornaments, wreaths, outdoor decorations and lights. This guide describes what AI agents can do on this site and how to read the product catalog.

- Store URL: https://www.leavestolights.com
- AI Discovery File: https://www.leavestolights.com/llms.txt
- Catalog API: https://www.leavestolights.com/api/ucp/mcp

## What Agents Can Do

- **Browse products**: search the catalog by keyword ("fall wreath", "table runner", "string lights")
- **Get product details**: name, price, availability, season, type, images and the product page link
- **Browse categories**: list the category pages
- **Link to products**: send shoppers to product pages to buy

## What Requires Human Action

- **Checkout**: purchases are completed by a person. Agents may link to product pages and the cart, but cannot pay.
- **Order changes and returns**: by the customer, on the order status and returns pages.

## Catalog API (MCP-compatible)

**Endpoint:** `POST https://www.leavestolights.com/api/ucp/mcp`
**Protocol:** JSON-RPC 2.0

### Available Tools

- `search_catalog` — `{ "query": "fall wreath", "limit": 8 }` → matching products
- `get_product` — `{ "id": 1001 }` → one product
- `lookup_catalog` — `{}` → category pages

### Example

```json
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "search_catalog", "arguments": { "query": "pre-lit wreath" } } }
```

## Store policies

- Free standard shipping on US orders over $75
- 60-day returns, started online (personalized items can't be returned)
- Ships within the United States only

## Contact

customerservice@leavestolights.com
