Skip to content

Tool index

Occam exposes 15 core tools under OCCAM_PROFILE=full (product default is reader = 8); 6 more are opt-in via host environment flags (plus occam_browser_interact). All tools return a JSON string (camelCase). The trust rule everywhere: ok: false means the page content is unknown — never substitute model memory.

For an agent, this page is a router, not a prompt payload: choose one tool, then open only its linked page. Runtime tools/list is authoritative for availability and input schemas; these pages explain intent, outputs, and recovery behavior.

Pick by job

You want to… Use Notes
Tell Occam your context window (once) occam_client_capabilities Sizes later reads; or set OCCAM_CLIENT_CONTEXT_TOKENS
Read one page as clean Markdown occam_transcode The default page reader; only url required
Decide whether a page is worth fetching occam_probe Cheap classify: extractability 0–1, recommended backend
Research several pages at once occam_digest Up to 8 URLs → per-page excerpts + combined Markdown
Find pages on a site when you have no URLs occam_map Same-domain links from homepage/sitemap/robots
Search the open web for URLs occam_search Keyless DuckDuckGo by default; override or off via env
Extract typed fields (title/price/author…) occam_extract_knowledge Needs a playbook knowledge_schema for the host
Look up a site's saved extraction recipe occam_playbook_resolve Read-only
Draft a recipe for a hard site occam_playbook_heal Captures DOM skeleton + selector candidates
Validate a recipe without fetching occam_playbook_lint Static, deterministic
Save a recipe (with live verify) occam_playbook_save Default dry-runs a transcode first
Verify a signed receipt / cite a block occam_verify offline / live / prove / citation / history modes
Check whether a page backs a claim occam_claim_check Returns retrieved blocks + Merkle membership proofs; found:false is retrieval-only
Audit a report's citations in bulk occam_attest 1–50 {claim, sourceUrl} rows
Build a signed, auditable URL corpus occam_dataset_export Per-row receipts + one manifest signature

Opt-in tools (absent from tools/list until enabled)

Set the flag in the host environment before starting the MCP server, then reload the client.

Tool Enable with Purpose
occam_batch_submit / occam_batch_status / occam_batch_results OCCAM_BATCH_MCP=1 Fire-and-forget async transcode of a URL list
occam_watch OCCAM_WATCH_MCP=1 Stateful page-change detection; history entries signed when receipts enabled
occam_crosscheck OCCAM_CONSENSUS_MCP=1 Compare vantage points; detect cloaking/personalization
occam_failure_atlas OCCAM_ATLAS_MCP=1 Per-host failure map of the current run; skip walled hosts
occam_browser_interact OCCAM_BROWSER_ACTIONS_MCP=1 Declarative browser actions, then materialize Markdown + Receipt v1

Common parameters

  • backend_policy — http (fast, no JS), browser (Playwright render), or http_then_browser (default: HTTP first, escalate when the result looks thin or challenged). See concepts.
  • session_profile — id of a headers profile JSON under OCCAM_SESSIONS_ROOT/<id>.json, for gated/logged-in pages. See configuration.
  • focus_query / fit_markdown / max_tokens — token-economy controls; see each page.