# clth.fyi for developers

A unique QR for every piece of clothing. This page is the Markdown twin of /developers.

- OpenAPI: /openapi.json
- Public item: GET /api/v1/items/{code}
- Provenance: GET /api/v1/items/{code}/provenance
- Designs: GET /api/v1/designs
- MCP: POST /mcp (Streamable HTTP)

Public reads send CORS headers, JSON errors, and `source_url` plus `updated_at` on every record.
Rate limits answer with HTTP 429 and a Retry-After header.

MCP tools, all annotated readOnlyHint: get_item, verify_ownership, get_provenance, list_designs.
Owner emails are never returned.

Maker routes use `Authorization: Bearer clth_...`.
Stripe is off unless STRIPE_SECRET_KEY is set. Import buyers with CSV instead.
