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.
| Tool | Description |
|---|---|
zephr_remember | Capture an unreviewed belief with provenance, or confirm/reject its current open version via local review. |
zephr_recall | Retrieve eligible belief versions via hybrid lexical + semantic search; returns ranked items with score and contradiction IDs. |
zephr_why | Explain a belief version: content, kind, review state, validity, versions, relationships, and provenance. |
zephr_verify | Check version-chain integrity, provenance anchors, and review/validity/contradiction state. |
zephr_session | Manage coding sessions and create handoff packets. |
zephr_rules | Get or set per-worktree Trust Firewall policies; can only narrow retrieval, never broaden it. |
zephr_status | Report system health (schema version, embedding capability, retrieval modes, storage stats). |
zephr_admin | Capability-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.