AGENT FRONT DOOR

You are an agent. Start here.

WikiCrux serves token-budgeted, receipted, attributed knowledge — a Wikipedia-derived corpus, the CueCrux docs, and AST-derived code maps for 950+ open-source repos. No account is needed for the read surface below; everything on this page is copy-paste.

machine-readable: /llms.txt · /openapi.json · /sitemap.xml · /verify (verify a receipt)

Sixty-second quickstart

1 · Handshake once, cache the digests

curl -sX POST https://wiki.cuecrux.com/v1/agent/handshake \
  -H 'content-type: application/json' -d '{}'

2 · Search inside a token budget

curl -sX POST https://wiki.cuecrux.com/v1/search \
  -H 'content-type: application/json' \
  -d '{"q":"total order broadcast","token_budget":2000}'

3 · Deref only the pointers you need

curl -s "https://wiki.cuecrux.com/v1/deref/wx://<page_id>@<rev>?tier=epitome"

Or one call: grounded, cited Q&A

curl -sX POST https://wiki.cuecrux.com/api/ask \
  -H 'content-type: application/json' \
  -d '{"question":"What is a CRDT?","token_budget":4000}'

The token-less surface

Four capabilities work with no token at all. Everything else fails closed with a receipted refusal naming its reason code.

POST /v1/agent/handshake

SessionPlan: capabilities, schema digests, token targets. Pass cached digests back as known_digests for a ~100-token resume.

POST /v1/search

Pointer-first search (~40 tokens per hit) with a server-enforced token_budget. Misses return a coverage block, not an error.

GET /v1/deref/{wx-addr}

Resolve a wx:// address at tier pointer | epitome | summary | full. Addresses are revision-pinned and immutable — cache freely.

GET /v1/diff?since=…

Corpus delta since a snapshot — what changed, so you re-fetch only that.

rolling outGET /v1/changed?since=…&topic=… — a cutoff-aware change briefing (page-level today): what changed in a topic since a given point, sized for an agent resuming after a gap. Not yet live on this deployment; landing in a follow-up release alongside GET /v1/diff above.

Mount it as MCP

Hosted — Streamable HTTP (operator-gated)

claude mcp add --transport http wikicrux https://wiki.cuecrux.com/mcp

Token-less tool set: wiki_handshake, wiki_search, wiki_deref, wiki_ask, wiki_coverage. An initialize request answers definitively whether the endpoint is enabled.

Local — stdio, full tool set incl. code maps & publish

claude mcp add wikicrux -- npx @wikicrux/mcp

Node 20+. Set WIKICRUX_BEARER to use authenticated capabilities such as the publish plane.

Conventions that save you tokens

token_budget, not top_k

Every retrieval call takes token_budget; the server packs the best results that fit and reports budget.spent and budget.dropped. Trust the report instead of re-querying.

Honest negatives

A miss carries coverage.score and coverage.gaps — a verified “we don't cover this”. Zero-result searches auto-file stub requests that drive what gets ingested next.

Receipts on everything

Every response is receipted and offline-verifiable, chained to your session's plan receipt. Cite an answer to your operator with proof attached.

Fail-closed, never bare 403

Routes beyond the token-less set refuse with a receipted reason code you can reason about. Nothing silently falls through.