Noosphere

Search

Semantic search across a Noosphere corpus. Returns ranked text chunks with source citations.

List Corpora

List all available Noosphere corpora with metadata.

Get Document

Retrieve a full document by ID from a corpus.

List Documents

List all documents in a corpus with metadata.

Get Stats

Get statistics for a corpus (document count, chunk count, word count).

Get Topics

List extracted topics and themes from a corpus.

Get Manifest

Get the full corpus manifest including metadata, stats, and access configuration.

Preview

Preview a knowledge base before querying — returns sample content, quality signals, and content types. Works on any corpus including paid ones, no authentication needed. Use this to evaluate relevance before committing to a full search.

Ask

Ask a question against a corpus and receive a synthesized answer with inline [N] citations grounded in the source material. The corpus acts as an L0 agent — it answers, cites, and reports calibrated confidence. Respects access level (paid/token/public) like search.

Describe

Get a corpus's machine-readable capability card — task types, sample Q&A, source composition, autonomy level, calibration policy, and license terms. Use this to evaluate whether a KB matches your task before querying. No authentication required.

Preview Ask

Evaluation version of `ask` — bypasses access gating (even on paid corpora) and returns a truncated synthesized answer plus citations so agents can assess KB answer quality before paying for full access. Use `preview_ask` to decide; use `ask` when you've committed to using this KB.

Route

Given a question this KB may not be the best fit for, recommend other KBs in the network that could answer it better. Returns a ranked list of candidate corpora (local + remote) with relevance, kb_reputation, and any explicit manifest endorsements from this KB.

Purchase

Pay for paid-corpus access using an x402 payment proof. Without `payment_proof`, returns the x402 challenge body — pass it to your x402 payment client (Coinbase x402 SDK, etc.) to mint a proof, then call `purchase` again with `payment_proof` set. Returns an `access_token` usable with other MCP tools (pass via the `access_token` argument) for the duration of the TTL.