# Lenshaus USA — assistant-assisted lens selection

Lenshaus supplies replacement lenses for customer-owned frames in the United States.
Customers choose options with an assistant, then review the selection, provide frame
and prescription details and pay on Lenshaus. A handoff link is not an order.

## Integration
- Documentation: https://lenshaususa.com/ai-shopping
- Public catalog (GET): https://lenshaususa.com/api/ai/catalog
- Current estimate (POST application/json): https://lenshaususa.com/api/ai/quote
- Selection link (POST application/json): https://lenshaususa.com/api/ai/handoff
- MCP Streamable HTTP (POST): https://lenshaususa.com/api/mcp
- No authentication is needed for these public, stateless selection tools.
- MCP tools: lenshaus_catalog, lenshaus_quote, lenshaus_selection_link.
- MCP quote/link arguments: { "selection": <selection> }. REST quote/link body: <selection>.

## Conversation
Read the current catalog first. Ask whether lenses are prescription or non-prescription,
what they will be used for, the customer's budget, lens look and preferences.
Explain supported options and ask before adding paid upgrades. Missing required
choices must be asked for, never guessed. Never invent prices, clinical recommendations
or frame compatibility. Office progressives support intermediate/near work, not driving.
Use lenshaus_quote; show the options and estimate, then obtain the customer's
confirmation before returning a selection link. Do not claim a purchase was placed.
Link generation does not store a customer/order record or take payment.

## Selection contract
version: 1; pairs: one to three pairs; mailerKit: standard or rush.
For each pair:
- orderType: rx or non-rx
- lensType: single, progressive, bifocal; null for non-rx
- singleVisionUse: distance, reading, computer (required only for single)
- progressiveDesign: standard, office, best (required only for progressive)
- material: polycarbonate, highIndex (1.67), highIndex174 (1.74), trivex
- arCoating: none, standard, best
- arColor: green or blue (optional when coating is selected; default green)
- blueLight: boolean, default false
- lookId: an exact current catalog look ID
- tintIntensity: light, medium, dark (required only for solid/gradient looks)
- lightTintId: optional solid/gradient look ID, only with Transitions; always Light
- lensCare: none, 1-year, 2-year (default none)
- frameCleaning: clean or keep-as-is (default clean)
Unknown fields and unsupported combinations are rejected.
Mirror includes polarization. Polarization/mirror cannot combine with Transitions
or an additional tint. All pairs share one kit; rush is charged per pair.
Prices are estimates in USD cents, before tax and prescription-dependent adjustments.

## Privacy and checkout
Never send prescriptions, PD values, names, email, phone, addresses, frame photos,
payment information, private order IDs or proposed prices through these public tools.
Customers provide those details only on Lenshaus. All prices are recalculated by
Lenshaus, including when a saved selection is opened. Final compatibility and pricing
are confirmed on Lenshaus before checkout. These tools cannot inspect existing orders.

## Helpful pages
- https://lenshaususa.com/how-it-works
- https://lenshaususa.com/about
- https://lenshaususa.com/lenses
- https://lenshaususa.com/lens-care
- https://lenshaususa.com/schedule