MCP tools
Generated reference — do not edit by hand.
This page is generated from the canonical MCP tool registry. No hand-written list is authoritative.
| Tool | Tier | Residency | Description |
|---|---|---|---|
zephr_remember | core | resident | Capture, review, or mutate a governed cloud memory. Update appends an immutable revision; delete tombstones the active version. |
zephr_recall | core | resident | Retrieve eligible belief versions via hybrid lexical + semantic search. Returns ranked items with a final score and contradiction belief IDs. |
zephr_why | search | resident | Explain a belief version: returns its content, kind, review state, validity, version count, worktree-scoped relationships (contradiction and supersession belief IDs, directed relative to the belief), and provenance (source + anchors) when recorded. |
zephr_verify | search | deferred | Check a belief's version-chain integrity (current-version pointer, contiguous revisions, non-overlapping transaction intervals, one open version), its provenance anchors, and its current review/validity/contradiction state. Returns a verificationProfile and warnings; only well-formed, provenanced, confirmed beliefs are reported verified. |
zephr_session | core | deferred | Manage coding sessions and create handoff packets. Create a session, list sessions, or summarize recent beliefs for context handoff. |
zephr_rules | review | deferred | Get or set per-worktree Trust Firewall policies. recallEligibleStates only NARROWS the fixed core-eligible set (confirmed + valid); it never broadens retrieval. |
zephr_status | core | resident | Report system health (schema version, embedding capability, retrieval modes, storage stats), or with action "changes" return a worktree-scoped Change Radar report since a session or timestamp anchor. |
zephr_admin | review | deferred | Administrative operations requiring capability authorization: purge beliefs, run migrations, or inspect detailed statistics. |
zephr_search | search | resident | Unified search routing: classify the query and dispatch to the best backend (lexical grep, structural LSP, semantic recall, or hybrid). Accepts symbol names, regex patterns, natural language, or prefixed directives (def:/refs:/grep:). |
zephr_grep | search | deferred | Search files in the admitted worktree using gitignore-aware lexical pattern matching via ugrep. Supports regex, fixed strings, file type filtering, and context lines. |
zephr_lsp | search | deferred | Navigate and inspect code structure within the admitted worktree using the Language Server Protocol. Supports hover type info, go-to-definition, find-references, and diagnostics. TypeScript supported via typescript-language-server. Read-only — no code actions, formatting, or rename. |
zephr_docs | docs | deferred | Documentation catalog (ADR-Z-20): search across project docs (local) and hosted third-party library docs (managed cloud), import user docs as evidence-anchored beliefs, list indexed sources, remove imported sources, and probe library staleness. Foundation-only — third-party actions return a structured degraded response when managed cloud is unreachable; project-docs actions operate against the admitted worktree in local mode. |
zephr_files | docs | deferred | User-file vault: list / stat / read-markdown / actual byte upload / rm. rm is the governed erase path. Unparsed files return file_unparsed rather than fabricated markdown. |
zephr_graph_query | search | deferred | Query the T4 entity-relation edge graph (indexed-corpus layer, NOT the belief layer per constraint 6). Returns typed (source_entity, relation, target_entity) edges with full provenance and confidence tier. A query that matches 0 edges returns the typed absence reason — absent_unindexed (corpus not built) or absent_verified (built + covered) — never a bare empty list. |
zephr_sync_status | core | deferred | Sync state (add-zephr-sync): report per-client/per-surface reconciliation status (synced/drifted/conflict/not-installed) from the local operational cache. Parity with zephr sync status --json. |
zephr_review_usage | review | deferred | Review-ledger read-only pre-flight (add-llm-augmented-review group 10). Returns the same ReviewUsageView the CLI and web dashboard read so an agent can reason "can I afford a review here?" — the entitlement-before-work rule applied to review calls. |
zephr_review | review | deferred | Run an LLM-augmented governed review of a code change (ref range, base/head pair, worktree, or PR). Findings are written through the governed review path — never bypassing RLS/tenancy. A structured abstention is returned when the review substrate is unavailable; a verdict is never fabricated. |
context7_call | hosted | deferred | Hosted Curated Tool — context7: look up up-to-date documentation for an external library/sdk/framework. Metered at 0.5 credit per invocation on the 0005 ledger (hosted credential); uses the tenant BYOK key (cost-only pass-through) when tools.context7.key is set. Band-gated + fail-closed on meter outage. |
firecrawl_scrape | hosted | deferred | Hosted Curated Tool — firecrawl: scrape a URL into clean markdown (JS-rendered). Metered at 2 credits per invocation on the 0005 ledger (hosted credential); uses the tenant BYOK key (cost-only pass-through) when tools.firecrawl.key is set. Band-gated + fail-closed on meter outage. |
tavily_search | hosted | deferred | Hosted Curated Tool — tavily: web search returning full page content. Metered at 1 credit per invocation on the 0005 ledger (hosted credential); uses the tenant BYOK key (cost-only pass-through) when tools.tavily.key is set. Band-gated + fail-closed on meter outage. |
browser_render | hosted | deferred | Hosted Curated Tool — chromium/playwright: render a URL to a viewable snapshot (screenshot/HTML). Near-free at retail (0 micros → free on every tier); uses the tenant BYOK credential when tools.browser.key is set. Band-gated + fail-closed on meter outage. |
sentry_query | hosted | deferred | Hosted Curated Tool — sentry: query a project |
github_api | hosted | deferred | Hosted Curated Tool — GitHub: call the GitHub devtools API (repos, PRs, issues, code search). Free at retail (0 micros → free on every tier); uses the tenant BYOK token when tools.github.key is set. Band-gated + fail-closed on meter outage. |
linear_search | hosted | deferred | Hosted Curated Tool — Linear: search issues, projects, and teams. Read-only query surface; fails closed with not_wired when no executor is configured. |
supabase_query | hosted | deferred | Hosted Curated Tool — Supabase: read-only query over Postgres tables. Fails closed with not_wired when no executor is configured. |
zephr_timeline | core | deferred | Recall ladder Layer 2: chronological HANDLES of captured events (provenance atoms, never full content). Full content is Layer 3 (zephr_get_observations) by explicit ID only. Honest empty result when no session matches — never fabricated. |
zephr_get_observations | core | deferred | Recall ladder Layer 3: the SOLE path where L0 crosses the trust boundary. Handle-lookup by explicit observation IDs the caller already holds; unindexed/out-of-scope IDs are reported in missing, never fabricated. |
zephr_constraint | core | deferred | Governance constraint ladder (ZEP-1941 W6): create/get/list/update/retire/promote/demote/evaluate_shadow/confirm_from_edge/waiver_create. Human-gated confirm and promote-to-enforced; fails closed with capability_required when constraint ports are omitted. |
zephr_how_to_obtain | core | deferred | Opaque confirmed-edge chain hints over the T4 edge graph (ZEP-1878). Returns one hint per confirmed edge, carrying sha-256 content digests only — raw belief/edge ids never leave the system. Honest no_confirmed_chain result when nothing matches. |
zephr_tools_search | core | deferred | JIT hosted-tool surface discovery (ZEP-1879): returns the fixed hosted-tool allowlist with a short descriptor per integration. User-invariant and byte-identical per release — no connect state, no credential-presence signal. |
zephr_tools_execute | core | deferred | JIT hosted-tool credential-less execute (ZEP-1879). Resolves credentials server-side only; on missing credentials mints an opaque single-use connect_ref and fails closed — never a user_code/device_code/verification URI. Unknown tool 404, unknown operation 403, non-allowlisted host denied. |
zephr_activate | core | deferred | Composes a deterministic project-grounded activation plan (≤2 tools, ≤1 skill) |