Compile knowledge once, then reach it live over MCP and the API, or take it away as a signed portable package. The model is replaceable. The compiled knowledge is the asset.

Three ways to use a Compiled World

From sources to a grounded answer

  1. Compile and activate a WorldUpload or connect sources, review the candidate, and activate it. Activation is a human decision, and nothing is served from a candidate.
  2. Create accessMint a scoped API key, or point an agent at the MCP server. Creating, rotating and revoking a key each write an audit row.
  3. Query the active WorldSearch, read objects and relations, or ask a question against the revision that is live right now.
  4. Receive evidence-bound contextEvery result carries the source version and the exact location inside it that it was compiled from.
  5. Follow citations back to sourceOpen that location and read the original. Where the evidence does not support an answer, the answer says so.

A finished Compiled World is open to read in full today, with its evidence attached. Compiling your own sources is set up with us rather than enabled by a plan purchase.Explore a Compiled WorldDiscuss your sources

Try it, with no key

Three unauthenticated reads, run from this page against TAVONEL. No signup, no credential, nothing that spends. Where a response sends a Content-Digest header, this page hashes the bytes it received and says whether they match.

  • What TAVONEL can read

    GET /api/v1/capabilities

    The same list the upload route validates against. A format absent from it is refused at upload rather than accepted and dropped.

  • What is open right now

    GET /api/status

    The deployment's own state, including whether compiling your own files is open here.

  • The shape of an answer

    GET /reproducibility/sample-world

    A deterministic product fixture, unsigned and labelled as such in its own disclosure field. Build against the shape; do not judge extraction from it.

The same checks from a terminal
curl · Recipe 3
# Every readable format, with its tier and its stated limitations. No key.
curl -fsS https://tavonel.com/api/v1/capabilities | jq '{schemaVersion, entries: (.entries | length), contentSha256}'

# The pin a caller keeps: drop contentSha256 -- it is the last key -- and re-serialize.
curl -fsS https://tavonel.com/api/v1/capabilities \
  | jq -S 'del(.contentSha256)' --indent 0 | tr -d '\n' | sha256sum

# The contract, and the two paths it deliberately does not have.
curl -fsS https://tavonel.com/api/openapi | jq '[.paths | keys[] | select(test("promote|rollback"))]'
# []

# Who signs an export here, or the refusal that says nobody does.
curl -fsS https://tavonel.com/api/export/trust | jq '{activeKeyId, keys: [.keys[] | {keyId, status, publicKeySpkiSha256}]}'
Python · Recipe 2
curl -fsSO https://tavonel.com/developer/tavonel-public-sample.py
python tavonel-public-sample.py --base-url https://tavonel.com
# sample: 3 objects, 2 evidence records, ... bytes
# digest: sha-256=:...:
#   ev-01 -> src_v_01 page 4 bbox [118, 214, 886, 374]
#   ev-02 -> src_v_01 page 4 bbox [118, 214, 886, 374]
# PUBLIC SAMPLE OK

Both are from Integration recipes, which says what each one proves.

The same shape as a person reads it, a claim with its evidence and the page region it came from: Explore a Compiled World.

Public tooling

Start with the contract, then a scoped key.

Your first authenticated read, over HTTP or through the MCP server.

curl -H "Authorization: Bearer $TAVONEL_API_KEY" \
  https://tavonel.com/api/v1/documents

All four perform GET /api/v1/documents with a key scoped documents:read. There is no npm or PyPI package to install: the HTTP samples use each language's standard library, and the agent tab registers the downloadable server below, which exposes this read as list_sources.

CLI

Node.js 20+ client with immutable version and update check.

Download CLI

MCP

9 stdio tools: list_sources, list_worlds, get_world, search_world, ask_world, get_object, get_relation, get_evidence, download_package. No write tool, and it refuses to start if one is added.

Download MCP server

Source agent

Runs inside your network and pushes to TAVONEL, which reaches into nothing. Reads a mounted directory — an SMB, NFS or SFTP mount included — or an S3-compatible bucket. An assisted import route, not a self-serve connector.

Download source agent

Export verifier

Checks a downloaded archive offline: the Ed25519 signature against a fingerprint you fetch separately, every file against the digest we signed, and nothing added. Node.js 20+, no dependency.

Download export verifier

Package verifier

Checks what is inside the archive: relations resolve, every region sits inside its page in the 0-1000 frame, and the Turtle, JSON-LD and CSV describe the same graph. Add tavonel-verify-roundtrip.py to load it into SQLite and query the ids back.

Download package verifier

The two runnable recipes are published too.

What is in a portable package

Every signed export contains these files, written by the exporter and named in a manifest carrying a digest for each one. The two ontology files are the Compiled World’s RDF / JSON-LD semantic projection — a projection of the compiled objects and relations, with no schema for you to author.

PathUse it for
AGENTS.mdWhat a filesystem-capable agent reads first.
graph/nodes.csvGraph nodes, for a plain graph import.
graph/relationships.csvGraph edges, with the relation each one carries.
manifest/ai-entrypoint.jsonThe machine-readable map of the entrypoints and the grounding rules.
manifest/candidate-world.jsonThe compiled World this archive was written from — objects and relations, canonically ordered.
manifest/export-manifest.jsonA digest for every file above. The signature is made over these bytes.
ontology/knowledge.jsonldJSON-LD semantic projection, for linked-data consumers.
ontology/knowledge.ttlThe same projection in Turtle, for RDF and SPARQL.
provenance/activities.jsonlLineage for every compiled artifact in the package.
rag/chunks.jsonlRetrieval chunks, each bound to the source location it came from.
rag/documents.jsonlDocument-level retrieval records.
README.mdWhere a person starts, and which consumption path to take.
signatures/export-manifest.ed25519.jsonThe detached Ed25519 signature over that manifest.
validation/report.jsonThe validation status, and any reason the result still requires review.

Next