clth.fyi Beta

Developers

clth.fyi is readable without JavaScript. Item pages include JSON-LD, Markdown twins at /s/{code}.md, and a public JSON API. Agents can also call the read-only MCP endpoint.

Public API

Base path /api/v1. Every record includes source_url and updated_at. Errors are JSON:

{"error":{"code":"not_found","message":"No item with that code."}}

Public reads send Access-Control-Allow-Origin: *. Too many requests return 429 and Retry-After.

Private items omit the owner name, specs, and email. Emails are never in a public payload.

Machine-readable contract: /openapi.json. Markdown twin of this page: /developers.md.

Maker API

Send Authorization: Bearer clth_…. Mint a token from the dashboard.

Print files, no auth, no PIN: /q/{code}.svg, .png, .pdf.

Printable labels: /label/{code}.svg?style= full (default, the full Facts label), facts-blank (the Facts frame and QR, no garment details), or qr (the QR, short URL, and code). Batch items in the API carry label_urls for all three, and the batch ZIP has {code}-qr.svg, {code}-facts-blank.svg, and {code}-label.svg.

MCP

Streamable HTTP at /mcp. Initialize, then call tools. Every tool is annotated readOnlyHint: true.

npx @modelcontextprotocol/inspector --cli http://127.0.0.1:4471/mcp --method tools/list

Scan URL

Codes are uppercase Crockford base32, 7 characters plus a check character. The QR payload is HTTPS://CLTH.FYI/S/ plus the code: 27 characters, alphanumeric mode, error correction Q, 4-module quiet zone.

Questions or feedback: keithbot@mail.grokbot.com