Zephr Docs

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.

ToolTierResidencyDescription
zephr_remembercoreresidentCapture, review, or mutate a governed cloud memory. Update appends an immutable revision; delete tombstones the active version.
zephr_recallcoreresidentRetrieve eligible belief versions via hybrid lexical + semantic search. Returns ranked items with a final score and contradiction belief IDs.
zephr_whysearchresidentExplain 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_verifysearchdeferredCheck 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_sessioncoredeferredManage coding sessions and create handoff packets. Create a session, list sessions, or summarize recent beliefs for context handoff.
zephr_rulesreviewdeferredGet or set per-worktree Trust Firewall policies. recallEligibleStates only NARROWS the fixed core-eligible set (confirmed + valid); it never broadens retrieval.
zephr_statuscoreresidentReport 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_adminreviewdeferredAdministrative operations requiring capability authorization: purge beliefs, run migrations, or inspect detailed statistics.
zephr_searchsearchresidentUnified 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_grepsearchdeferredSearch files in the admitted worktree using gitignore-aware lexical pattern matching via ugrep. Supports regex, fixed strings, file type filtering, and context lines.
zephr_lspsearchdeferredNavigate 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_docsdocsdeferredDocumentation 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_filesdocsdeferredUser-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_querysearchdeferredQuery 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_statuscoredeferredSync 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_usagereviewdeferredReview-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_reviewreviewdeferredRun 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_callhosteddeferredHosted 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_scrapehosteddeferredHosted 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_searchhosteddeferredHosted 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_renderhosteddeferredHosted 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_queryhosteddeferredHosted Curated Tool — sentry: query a project
github_apihosteddeferredHosted 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_searchhosteddeferredHosted Curated Tool — Linear: search issues, projects, and teams. Read-only query surface; fails closed with not_wired when no executor is configured.
supabase_queryhosteddeferredHosted Curated Tool — Supabase: read-only query over Postgres tables. Fails closed with not_wired when no executor is configured.
zephr_timelinecoredeferredRecall 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_observationscoredeferredRecall 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_constraintcoredeferredGovernance 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_obtaincoredeferredOpaque 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_searchcoredeferredJIT 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_executecoredeferredJIT 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_activatecoredeferredComposes a deterministic project-grounded activation plan (≤2 tools, ≤1 skill)