Reference overview¶

Task-oriented map of Occam’s MCP tools and supporting reference pages. Friendly names below are for navigation; the canonical identifier is always the occam_* tool name on each page and in runtime tools/list.

For a learning path (not schemas), use Guides, the workflow gallery, or Examples. For capability domains (not tools), see Capabilities. For a one-page advantages + knobs flashcard, see Why Occam.

Which tool should I use?¶

You want to…	Open	Canonical id
Size later reads to your model window	Client capabilities	`occam_client_capabilities`
Decide if a URL is worth fetching	Probe	`occam_probe`
Read one page as Markdown	Transcode	`occam_transcode`
Research several URLs at once	Digest	`occam_digest`
Extract typed fields	Extract knowledge	`occam_extract_knowledge`
Search the open web	Search	`occam_search`
Discover links on a site	Map	`occam_map`
Look up / draft / save a site recipe	Playbooks group	`occam_playbook_*`
Prove a receipt or cite a block	Verify	`occam_verify`
Check whether a page backs a claim	Claim check	`occam_claim_check`

Full picker table: Tool index. Compact table: Compact tool reference.

Groups in this Reference section¶

Client and diagnostics¶

Inspect before you spend a full extract.

Client capabilities — occam_client_capabilities
Probe — occam_probe

Read and transform¶

Stable page readers and transformers.

Transcode — occam_transcode
Digest — occam_digest
Extract knowledge — occam_extract_knowledge

Search and discovery¶

Find URLs when you do not already have them.

Search — occam_search
Map — occam_map

Playbooks¶

Site recipes for harder extracts (stable tools; authoring is advanced).

Resolve · Lint · Heal · Save

Validation and receipts¶

Integrity and citation workflows. A verified receipt proves integrity relative to a key you supply — not factual truth or authorship.

Verify · Claim check · Attest · Dataset export

Experimental tools¶

Absent from default tools/list until an env flag is set. See also Experimental capabilities.

Batch · Watch · Crosscheck · Failure atlas

Protocol and configuration¶

How the host is wired and spoken to.

Configuration · Transports · MCP API

Contracts and errors¶

Schemas-adjacent tables and typed failure registry.

Tool index · Compact tool reference · Failure codes

Source-of-truth order¶

Priority	Source	Use it for
1	Runtime `tools/list`	Tool availability and input JSON Schema
2	MCP API contract	Response shapes and cross-tool semantics
3	Per-tool pages	Usage, examples, failure handling
4	Guides / examples / handbook	Learning and workflows

If two pages disagree, prefer the higher-priority source and report drift.

Supporting reference¶

Page	Purpose
Concepts	Backends, sessions, playbooks, receipts
FAQ	Short answers
Trust and security	Honesty, receipts, install safety
Signed datasets	Auditable multi-URL export

LLM reading order¶

llms.txt once
Task routing
One page under tools/
Failure codes only after ok: false
Handbook for deep comprehension
MCP API for contract-level detail