Vouch MCP server
Git-native, review-gated knowledge base for LLM agents. Cited retrieval, audited writes.
82 stars23 downloads/wk
Reviews
Write oneNobody has reviewed Vouch yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Vouch tools (58, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
kb_approveApprove a proposal → durable artifact. Use carefully.
kb_archivekb_auditReturn the last N audit events, filtered to the viewer scope.
kb_capabilitiesReturn the protocol capabilities of this server.
kb_citeReturn resolved citations (sources or evidence records) backing a claim.
kb_compileCompile live approved claims into topic-page proposals.
kb_confirmkb_contextBuild a ContextPack ready to inject into an agent prompt.
kb_contradictkb_crystallizeApprove every pending proposal in `session_id` (host must trust the agent).
kb_dedup_scanFind near-duplicate artifacts via embedding cosine.
kb_detect_themesDetect recurring entity clusters across completed sessions.
kb_digestRead-only reviewer briefing: pending proposals oldest-first, recent decisions, stale claims, and followups due.
kb_doctorkb_embeddings_statsModel identity, per-kind counts, query cache stats.
kb_eval_embeddingswrite actionRun retrieval eval over a JSONL queries file.
kb_expireExpire stale pending proposals (dry-run unless apply=True).
kb_exportkb_export_checkkb_graph_exportRender the provenance DAG (or one session's subgraph) as dot/mermaid.
kb_impactForward impact: dependents, and breakage if op (archive/contradict/supersede).
kb_import_applykb_import_checkkb_index_rebuildwrite actionDrop and rebuild state.db from the durable files.
kb_lintkb_list_claimsList all claims, optionally filtered by status.
kb_list_entitieskb_list_pagesList pages, optionally filtered by kind and frontmatter.
kb_list_pendingList proposals awaiting human review.
kb_list_relationsList all relations; if node_id is given, only edges touching it.
kb_list_sourceskb_neighborsReturn graph neighbors of a claim, page, entity, or source.
kb_propose_claimPropose a new claim. Becomes durable only after `kb_approve`.
kb_propose_entitykb_propose_pagekb_propose_relationkb_propose_themePropose a theme synthesis page from a detected cluster.
kb_provenance_rebuildRebuild the prov_edges cache from durable files; returns edge count.
kb_read_claimReturn a claim with its citation list.
kb_read_entitykb_read_pageReturn a page (title, body, claim ids).
kb_read_relationkb_register_sourceRegister a source. Evidence intake is NOT gated (registering raw evidence is harmless and de-duplicates by content hash).
kb_register_source_from_pathkb_reindex_embeddingsRe-encode every artifact under the current embedding adapter.
kb_rejectkb_reject_extractedMass-reject pending edges the auto-extractor filed (issue #224).
kb_searchSearch the KB.
kb_session_endkb_session_startkb_source_verifyRe-hash every source and report any drift.
kb_statsObservability: pending by agent, review rates, citation coverage.
kb_statusReturn KB artifact counts and health summary.
kb_supersedekb_synthesizeAnswer a query from approved claims only, with inline `[claim_id]` citations, an explicit gaps block, and a synthesis_confidence grade.
kb_traceShortest typed-edge path between two artifacts (or found=false).
kb_volunteer_contextPoll confidence-gated context volunteered for an active session.
kb_whyBackward provenance for a claim: cites, session, supersedes, approval.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan214 source files scanned15/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 34 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (2)
- mediumeval / new Function used
exec.evalvouch_kb-1.2.2/desktop/src/catalog/methods.json: …p results to retrieve per query for the eval (the k in recall@k)." } ], …
- mediumsubprocess with shell=True
exec.shell-truevouch_kb-1.2.2/src/vouch/compile.py: …ubprocess.run( llm_cmd, shell=True, cwd=tmp, input=prompt,…
What the publisher says
From the Vouch repository's README, as published. We do not edit it. Read it on GitHub
vouch
Git-native, review-gated knowledge base for LLM agents. MCP server + JSONL tool server + CLI.
<!-- mcp-name: io.github.vouchdev/vouch --> <!-- the mcp registry verifies package ownership by matching this marker against server.json's name; keep it in lockstep with server.json at the repo root. -->
Agents should not start every session with amnesia — but they shouldn't get to write whatever they want either.
vouch gives LLM agents durable memory with an explicit review gate: sessions capture themselves, agents propose writes, and nothing becomes durable knowledge until you approve it. Approved artifacts are plain files under .vouch/ — YAML claims, markdown pages — so the KB lives in your repo, is reviewed like code, diffs cleanly, and travels with git clone.
The destination is the one Andrej Karpathy's llm-wiki idea file sketches: stop using LLMs as search engines that rediscover your documents on every question — use them as tireless knowledge engineers that compile, cross-reference, and maintain a living wiki, while humans curate and think. vouch is that idea with the write path made trustworthy. vouch compile has an LLM draft the topic pages, but every page cites approved claims, every [claim: …] citation is machine-verified before the draft is filed, and the drafts pass through the same review gate as every other write. The LLM compiles; the human approves; the wiki compounds.
"I can do this with one prompt"
Often true — and worth being honest about. If you want your agent to remember things, a paragraph in CLAUDE.md, a memory file, or your host's built-in auto-memory gets you most of the way, costs nothing, and needs no install. Reach for that first. Recall is not a hard problem.
What is hard is trust in the write path, and that's a different problem than memory. Single-writer memory needs no trust model: you're the only author, and a bad line costs you a shrug. The moment writes come from more than one author — several agents, a teammate, a future you who forgot the context — the question stops being "what did we say?" and becomes "who decided this was true, on what evidence, and can I audit it later?" A prompt cannot answer that, no matter how good the prompt is.
That's the whole of vouch:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add vouch -- uvx vouch-kb
Vouch: common questions
- Is Vouch MCP server safe?
- Mostly: it is graded B (71/100). Read the Vouch safety report
- How do I install Vouch?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Vouch need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Vouch maintained?
- The last commit was 36 days ago (2026-08-23). The latest release is v1.2.2.
- What can I use instead of Vouch?
- Servers from other publishers that do the same job: Git MCP server, Contentrain MCP server and diffctx MCP server. Compare all Vouch alternatives.
Alternatives to Vouch
Same job from other publishers: the closest match first, then the best rated.
- GitComprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more.not reviewedEstablishedA
- ContentrainGit-native content governance for AI agents — 27 deterministic MCP tools over stdio and HTTP.not reviewedEstablishedA
- diffctxSelects the minimum code an LLM needs to review a git diffnot reviewedGrowingA
- GntGit-native policy layer for AI agents: check_action verdicts against rules approved via PR.not reviewedGrowingA
- Agent MemoryGit-native project memory for AI coding agents: Markdown source of truth, reviewable, secret-safe.not reviewedGrowingA