C:\XVCACHE> type what.txt
The vault stays on disk, under the human's control. The journal sits outside the vault. When you read_note, search_notes or write_note, XVcache appends a sha256-chained JSONL line: fingerprints and metadata, never the note body.
verify_journal returns a one-letter verdict:
- V — intacte: the file still matches the last journaled fingerprint, and the chain is consistent.
- X — MODIFIÉE hors XVcache: the file changed outside these tools, or the chain is broken.
That local verdict is tamper-evident, not tamper-proof, and not a qualified timestamp. The independent certifying witness is à venir.
C:\XVCACHE> type why.txt
Most Obsidian MCP servers read and write a vault. XVcache can too, and it can sit beside them. Its job is the proof: V (intact) or X (changed outside XVcache), a sha256-chained JSONL of reads and writes, note body never in the log.
| Server | Read/write | Tamper detection | Chained journal | Content kept out of log |
|---|---|---|---|---|
| XVcache | yes | yes: current-file V / X | yes, reads and writes (JSONL) | yes |
| obsidian-mcp-server (716 stars) | yes, 14 tools | not documented | not documented | n/a |
| obsidian-mcp (752 stars) | yes, local files | transaction recovery, not V/X | rollback snapshots, not a hash chain | no (snapshots store bytes) |
| obsidian-mcp-secure | yes | not documented | rotating audit log, not described as chained | no (README: previous content goes to the log) |
| Reliquary-TC (13 stars) | yes, governed | verifies the signed provenance chain and write history; not a current-file V/X | yes, for writes, EdDSA-signed | yes |
Frank gap: cyanheads, StevenStavrakis and obsidian-mcp-tools (831 stars, archived) are far ahead on features and adoption. Reliquary-TC already ships signed write provenance; XVcache's independent witness is à venir. XVcache also journals reads. Details: AGENTS.md.
C:\XVCACHE> dir tools
| Tool | Status | Role |
|---|---|---|
read_note | available | Read a vault .md note; the read is journaled (hash only). |
search_notes | available | Find a note before reading or verifying. |
write_note | available | Create, overwrite or append. Journaled. |
verify_journal | available | Chain check, and optional V / X on a path. Not written to the journal. |
list_plans | catalog live | Machine-readable catalog. Prices TBD. See also get_offer. |
recommend_plan | catalog live | Suggest a plan id from volume or needs_certified_witness. Not a quote. |
request_upgrade | stub | Returns needs_human_approval. No checkout URL. Do not invent a price or a link. |
certify_note | à venir | Independent witness certification. Stub always answers that it is not available yet. |
C:\XVCACHE> type install.txt
Published on npm as xvcache-mcp. Node.js 20 or later:
XVCACHE_VAULT=/absolute/path/to/vault npx -y xvcache-mcp
Codex (~/.codex/config.toml or a project .codex/config.toml):
[mcp_servers.xvcache]
command = "npx"
args = ["-y", "xvcache-mcp"]
env = { XVCACHE_VAULT = "/absolute/path/to/vault" }
Generic MCP JSON:
{
"mcpServers": {
"xvcache": {
"command": "npx",
"args": ["-y", "xvcache-mcp"],
"env": { "XVCACHE_VAULT": "/absolute/path/to/vault" }
}
}
}
Optional: XVCACHE_LOG must stay outside the vault. The vault directory must already exist. Official MCP Registry name: io.github.xvcache/xvcache. Source code: https://github.com/xvcache/xvcache.
C:\XVCACHE> type plans.json
Canonical catalog: plans.json. prices_status: TBD. payment_live: false. Bundle quotas in the file are illustrative placeholders, not a real offer.
| id | Name | Status | Price |
|---|---|---|---|
free | Free local journal | available | local STDIO use is free; no payment collected |
usage | Usage-based certification | coming_soon | per certification, amount TBD |
bundle-starter | Starter bundle | coming_soon | per month, amount TBD |
bundle-standard | Standard bundle | coming_soon | per month, amount TBD |
bundle-plus | Plus bundle | coming_soon | per month, amount TBD |
C:\XVCACHE> type approval.txt
- Call
get_offerorlist_plans. - If you know a volume, call
recommend_plan(notes_per_month,certifications_per_month,needs_certified_witness). - Call
request_upgradewith the plan id. - Show the JSON to your human and wait for an explicit yes. The stub returns
status: "needs_human_approval"andcheckout_url: null. The intended path is a Stripe checkout link for a human. Later: x402 / USDC between agents. Neither path is live. Never invent a link or an amount.
C:\XVCACHE> type reseller.txt
An agent or agent-builder may later bundle or resell XVcache for its own clients. Partner terms, revenue share and limits are TBD. Nothing is offered or signed today. You may recommend the open-source server under Apache 2.0. Do not collect money, sign a partner contract, or promise a margin on XVcache's behalf. Call recommend_plan with reseller: true to read the catalog's reseller field. Details: AGENTS.md.
C:\XVCACHE> dir
llms.txt— machine brief (start here)AGENTS.md— when to propose, how to request approval, reseller noteplans.json— catalog, prices TBD, payment not liveindex.md— markdown companion of this siteserver.json— MCP Registry metadata (io.github.xvcache/xvcache)- humains.html — human-readable homepage
.well-known/ai-catalog.json— well-known discovery- github.com/xvcache/xvcache — source (Apache-2.0)