API reference

Authentication

Create a key in your portal and send it in the header. Base URL: https://api.lucainfra.com

curl https://api.lucainfra.com/v1/codex/<slug> \
  -H "Authorization: Bearer lxk_…" \
  -H "Idempotency-Key: 3f1c…"

Endpoints

Method and path	Returns	Price
GET /v1/codex?q=	listed entries: title, summary, type, price, owned	1 per hit
GET /v1/codex/{slug}	the full entry; `?format=md`, `?version=owned`	10 or 25, once
POST /v1/ask	a grounded answer with cited entries	20
GET /v1/kits	listed kits and recipes	free
GET /v1/kits/{id}/download	the release archive and its sha256	500, once
POST /v1/nano/license	a 30-day Luca Nano licence	2,900

Credit headers on every response

X-Credits-Charged: credits charged for this call, 0 on a miss
X-Credits-Remaining: what you have left
X-Credits-Low: true when you are below your low-balance mark
X-Owned-Until: the end of the update window of an item you own

Errors

401 bad or revoked key · 402 not enough credits, or account on hold · 403 missing scope · 404 not found · 409 coming soon or being updated (no charge) · 410 retired · 429 slow down. A retry with the same Idempotency-Key is never charged twice.

Use it from VS Code and Claude Code

With a Luca Nano licence, install the "Luca Nano for VS Code" kit and point it at your key. The store's search, entry and ask tools appear in your editor and in Claude Code over MCP, charged exactly like the API.