Zephr Docs

MCP tools and status

The tool surface is defined in the single catalog at packages/protocol/src/catalog.ts, canonically ordered in packages/protocol/src/mcp-tools.ts, and CI-asserted against scripts/tier-manifest.json. Do not hand-edit the surface from docs — the registry is the source of truth.

Frequently used tools

This is a quick-start subset, not the registered inventory. The complete generated inventory is published in the generated MCP tools reference. Destructive operations route through zephr_admin and require a minted ZEPHR_ADMIN_TOKEN capability; without it, read-only stats still work and destructive actions are refused.

ToolDescription
zephr_rememberCapture an unreviewed belief with provenance, or confirm/reject its current open version via local review.
zephr_recallRetrieve eligible belief versions via hybrid lexical + semantic search; returns ranked items with score and contradiction IDs.
zephr_whyExplain a belief version: content, kind, review state, validity, versions, relationships, and provenance.
zephr_verifyCheck version-chain integrity, provenance anchors, and review/validity/contradiction state.
zephr_sessionManage coding sessions and create handoff packets.
zephr_rulesGet or set per-worktree Trust Firewall policies; can only narrow retrieval, never broaden it.
zephr_statusReport system health (schema version, embedding capability, retrieval modes, storage stats).
zephr_adminCapability-gated administrative operations: purge beliefs, run migrations, inspect statistics.

Extensibility

The catalog remains the authority. Related behaviors may share an action enum instead of creating another sibling tool.

zephr_status

zephr_status reports system health — schema version, embedding capability, retrieval modes, and storage stats. With action "changes" it returns a worktree-scoped Change Radar report since a session or timestamp anchor.