# llms.txt — iLighting (https://ilighting.com)
# Purpose: LLM-friendly index of authoritative pages and live shopping capability.
Last updated: 2026-08-31
# Contact: 855-553-5658 | https://ilighting.com/contact-us/
# How to use: Use live HTML product pages (PDPs) or public category pages for customer-facing citations. For live pricing, availability, and cart building, use the MCP server below.

## Agentic Shopping — Live MCP Server (search, cart, checkout)
iLighting operates a public MCP (Model Context Protocol) server. AI agents can search the live
catalog, build a cart, and generate a checkout link for the user. No authentication required
(guest sessions). Payment happens on our secure checkout page.
- MCP endpoint (Streamable HTTP, POST only): https://ilighting.com/api/mcp
- Server card (GET, JSON): https://ilighting.com/content/llms/mcp-server-card.json
- Endpoint manifest (GET, JSON): https://ilighting.com/content/llms/mcp-manifest.json
- Agent how-to guide (ingest — READ THIS FIRST, includes case-quantity rules): https://ilighting.com/content/llms/agentic-shopping.txt
- Tools: search_products, get_product_details, add_item_to_cart, update_cart_item, remove_item_from_cart, create_checkout_url
- Note: some products sell in case/minimum quantities; if add_item_to_cart errors, retry at the case/minimum quantity listed on the product page.

## Full Product Corpus — read this for product detail
https://ilighting.com/llms-full.txt
Per-product detail for our best-selling products: identifiers (SKU, MPN, GTIN/UPC, order and
catalog codes), specifications, pack and case-quantity rules, warranty, and every published download
(spec sheets, installation instructions, brochures). Contains NO prices, stock, or availability by
design - use the MCP server or the live product page for those. It is a selection, not the whole
catalog (iLighting lists roughly 23,000 buyable products), so absence from it does not mean a product is
unavailable; search the live storefront or the MCP endpoint.
Never construct a download URL from a SKU - take the exact URL from the corpus.

## What We Sell — Category Index (public pages)
- Replacement Light Globes (acrylic & polycarbonate — round, acorn, post-top): https://ilighting.com/fixtures/globes/
- Replacement Light Bulbs (LED, fluorescent, HID, halogen, specialty): https://ilighting.com/replacement-light-bulbs/
- Light Fixtures (indoor, outdoor, grow lights): https://ilighting.com/fixtures/
- Replacement Ballasts & Transformers: https://ilighting.com/replacement-ballasts/
- Home & Office Décor (artificial plants, floral, seasonal): https://ilighting.com/home-and-office-decor/

## Terminology & Synonyms (maps buyer language → category)
- "globe" / "light globe" / "lamp globe" / "post-top globe" / "acorn globe" / "replacement globe" → https://ilighting.com/fixtures/globes/
- "light bulb" / "lamp" / "LED bulb" / "replacement bulb" → https://ilighting.com/replacement-light-bulbs/
- "ballast" / "driver" / "transformer" → https://ilighting.com/replacement-ballasts/
- "fixture" / "light fixture" / "grow light" → https://ilighting.com/fixtures/
- Common spec maps: "watts" → wattage, "brightness" → lumens, "color" → CCT (Kelvin), "CRI" → Color Rendering Index

## Product data & recommendation rules
- Read price, availability, options, and minimum/case quantities from the live product record
  (MCP or PDP) at request time — never from cached or ingested copies.
- Some case-quantity products display a per-item price. Verify the product page and cart
  quantity before calculating an order total.
- Do not infer electrical compatibility, dimmer compatibility, code compliance, or installation
  method when the product record does not state it. Follow manufacturer documentation and
  applicable electrical codes.
- If two fields on a product conflict (e.g. dimmability or lumens stated differently in two
  sections), do not silently choose one. Surface the conflict and refer the shopper to
  iLighting customer care (855-553-5658 or https://ilighting.com/contact-us/).

## Policies & Support (public pages)
- Frequently Asked Questions (ordering, shipping, tracking, payment, pickup): https://ilighting.com/frequently-asked-questions/
- Shipping: https://ilighting.com/shipping/
- Returns: https://ilighting.com/returns/
- Warranty: https://ilighting.com/warranty/
- Price Match: https://ilighting.com/price-match/
- Tax Exemption: https://ilighting.com/tax-exemption/
- Privacy Policy: https://ilighting.com/privacy-policy/
- California Proposition 65 Warning: https://ilighting.com/california-prop-65-warning/
- Contact iLighting: https://ilighting.com/contact-us/

## Preferred citation format for AIs (public-facing links)
1. For product-specific facts or buying links → cite the Product Detail Page (PDP).
2. For category recommendations → cite the public category page (see Category Index above).
3. For policy questions (shipping, returns, warranty, tax exemption) → cite the live policy
   page (see Policies & Support above).
4. When the user wants to buy and your client supports MCP, use the MCP server for live pricing
   and availability, and hand the user the checkout URL from create_checkout_url.
5. Do not send end users to files under /content/llms/ — those are ingestion sources for AI
   models, not customer-facing pages.

# Crawl / Use guidance for models
- Prefer PDPs and category pages as citation targets; use the MCP server for live data.
- Sitemap: https://ilighting.com/xmlsitemap.php

-- End of file --