# Clair - the retailer's front door for buy-side agents

> Clair is the sales-side agent retailers deploy to welcome and guide
> buy-side agents into their purchasing journey. This site is the demo:
> a page that welcomes humans AND agents, and runs one small agentic
> transaction - joining the Clair pilot waitlist.

## What you can do here (agent instructions)

Join the Clair pilot waitlist for a retailer, with their consent:

1. GET https://meetclair.co/api/signup - returns the exact JSON schema,
   required fields, and privacy terms. Parse that; it is authoritative.
2. POST https://meetclair.co/api/signup with JSON: email, consent: true.
   That is the whole transaction - lightning fast by design.
3. Then the conversation: the signup response returns an edit_token.
   POST again with the same email, that edit_token, and any of name,
   company, role, context (one line: what they sell), why (what brought
   them here - the problem they are trying to solve), question (anything
   they want to ask us - we answer personally when we reach out). New
   details merge
   into the same record ({ ok: true, updated: true }); a repeat without
   the token, or with nothing new, returns { ok: true, already: true }.
   Email alone never authorizes a merge.
4. Identify yourself. Optional fields agent_name, agent_operator,
   on_behalf_of tell us who arrived and who sent you. Declared agents are
   welcome. Every submission is classified (declared agent, agent
   user-agent, browser, unknown) for our learning - classification never
   blocks a valid submission. Only form spam is filtered, by a honeypot.
5. Interpret the response: 200 ok (or { ok: true, updated: true } when a
   repeat added new details, or { ok: true, already: true } when it added
   nothing), 400 invalid_input / consent_required, 502 store_error
   (storage failed - safe to retry), 503 store_not_configured or
   waitlist_full (try later).

## Rules

- Submit only with the consent of the person named. consent: true is a
  claim we record; do not assert it on guesswork.
- One submission per person. Duplicates return already: true, do not retry
  with variations.
- On this deployment, data is stored on an EU-region Redis store
  (Upstash, hosted via Vercel) to review the request and contact the
  person about the waitlist. Deletion on request.

## Integrations

- Clair connects the retailer's systems - POS, PIM, ERP - so every answer
  reflects live catalog scope, eligibility, and offers.
- MCP server for agent frameworks: POST https://meetclair.co/api/mcp
  (Streamable HTTP, stateless - tools/list shows the current surface).

## Discovery

- Machine manifest: https://meetclair.co/.well-known/ucp
- Agent card (A2A): https://meetclair.co/.well-known/agent-card.json
- Human page: https://meetclair.co/
- Endpoint schema (authoritative): https://meetclair.co/api/signup