Veracium MCP Server
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Veracium
Veracium is a provenance-aware memory plug-in for agentic systems — durable, per-user memory that resists the injection and confabulation failures that plague naive agent memory. Provenance means every fact tracks who said it: a claim from an email your agent merely read can never become a "fact" it asserts. It remembers what the user said, past interactions, and what worked — and it remembers where each of those came from.
Veracium is the production distillation of an evaluation-driven research project
(agent-memory): every design choice below traces to a measured finding, and the
research's synthetic-corpus harness is reused as the regression suite.
Research: the evaluation instrument behind those findings — a longitudinal benchmark for agent memory — is described in Q. Spencer, "Ground Truth First: A Longitudinal Evaluation Instrument for Agent Memory, and the Tenure Crossover in Memory-Architecture Rankings" (arXiv:2607.21962, 2026).
Why it's shaped this way
Typed graph + dated episodes are the store of record. Entity facts live as relational edges (with unforgeable provenance); interaction history lives as dated episodes. A curated "wiki" view is compiled from them and cached — never the source of truth. (The layered design won on both short and 9-week horizons; flat stores each failed one regime.)
Supersession, never erasure. Single-valued facts (employer, location, deadline) keep one current value with the prior value retained as history — "what did X used to be?" stays answerable. Facts that can hold several values at once (preferences, measurements, health states) accumulate instead. A user can hold several deadlines: each dated obligation is stored under its own name with an ISO date, and a rescheduled one shows once, marked contested, with both dates kept.
correct()applies no reschedule to such a date (it refuses: the subject is the obligation, not the user, specs/0011 §4b) andconfirm()retires neither; the user resolves it by disputing each stale date (dispute(), a host-wired user action; or, where the host attestsdirect, the agent'sdispute_facttool), which keeps it as history. (The category commercial memory systems handle worst; Veracium's strongest.)Representation is a security control. Third-party claims (received email, external docs) are quarantined structurally — stored as
third_party_claimedges with the claimant as subject, never as user facts. Content-type quarantine catches obligation/debt/renewal claims regardless of how plausible they look. (Held against a full plausibility ladder incl. contact-impersonation.) What this is, and is not: the store governs retention, retrieval, description and recommendation — what it will say and how it labels it. It does not instantiate, authorize or execute anything; those belong to the host's harness. Without an exclusive harness path that consumes the labels, Veracium's trust classes are advisory labelling, not enforcement.Bring your own model. Veracium never owns your API keys or model choice; it calls a
Completecallable you supply. A reference Anthropic provider ships in the box.Embedded by default. Zero external services: one SQLite file. Swap in Neo4j/Postgres later via the
Storeinterface.
Related MCP server: Verantyx Vera MCP Server
Install
pip install "veracium[anthropic]" # core + the reference LLM providerPython and SQLite requirement. Veracium needs Python 3.14 or newer. It measures your Python's SQLite build on every open instead of checking it against a list: the build must pass the feature probes and reproduce every accepted schema version exactly. A build that passes opens as
verified, with oneUnattestedBuildWarningper process; one the project's CI has also attested opens with no warning. The CI has attested 22 builds: SQLite 3.34.1 to 3.54.1 on Linux (glibc and musl, x86_64 and arm64) and macOS (arm64), from uv, python.org, Homebrew, conda-forge, setup-python, deadsnakes, pyenv, the official Docker images and the distributions' own Pythons. No Windows build is attested yet. A build that fails is refused (unsupported-sqlite, naming the first failing check), for a new store and an existing one alike.veracium doctorreports your build's status and lists the attested builds, with or without a store. Ubuntu 24.04's own system Python is 3.12, below the floor:pipthere installs 0.26.1, the last release that supports it. Without Python 3.14, use the container image (next section).
The container image (no Python 3.14 needed)
ghcr.io/veracium-ai/veracium:<version> (from 0.32.0) runs the MCP server over stdio from that release's own wheel, on
Python 3.14 and an attested SQLite build, for linux/amd64 and linux/arm64 (specs/0054). The store lives on a volume at
/data. The image sets no trust value of its own: the host supplies them at run time. An MCP client configuration:
{"mcpServers": {"veracium": {
"command": "docker",
"args": ["run", "-i", "--rm", "-v", "veracium-data:/data",
"-e", "ANTHROPIC_API_KEY", "-e", "VERACIUM_MCP_SOURCE_ID",
"ghcr.io/veracium-ai/veracium:0.33.0"],
"env": {"ANTHROPIC_API_KEY": "<key>", "VERACIUM_MCP_SOURCE_ID": "<your source id>"}}}}The env block is required: an MCP client starts the server with a minimal environment, and -e NAME forwards only
what is there. What each configuration stores:
configuration |
| what |
neither variable | refused: | nothing stored |
| stored as a third-party claim | under "UNVERIFIED THIRD-PARTY CLAIMS", never asserted as fact |
| the user's own statements are the user's | verified facts |
direct is the deployment's own attestation that every call comes from the authenticated user, for example a
single-user desktop where you are that user (see veracium-mcp --help). Name a version tag, never :latest: a newer
image whose store schema is higher refuses to open the volume's store and names the veracium migrate command to run
first. /data holds the store and its SQLite sidecars, plus config/ and state/ (the telemetry and diagnostics
choices, off by default, and the local diagnostics log). On Docker Desktop for macOS or Windows, use a named volume, not
a bind mount.
Extras: [mcp] adds the MCP server, [dev] adds pytest. The core alone depends
only on pydantic. To work from source instead:
git clone https://github.com/veracium-ai/Veracium.git && cd Veracium
pip install -e ".[anthropic,dev]"Links: docs · veracium.ai · PyPI
Upgrading an existing store
veracium migrate upgrades a store written by any earlier release, one audited schema version at a time
(since 0.31.0). Take a backup first and stop every other process using the store:
veracium migrate --db path/to/veracium.db --i-have-quiesced --backup <your-backup-ref>Each step is its own audited operation, so a walk across several versions does several transactions;
migrate_store(path) in the library stays the one-transaction route. If a walk stops part-way, its last lines say
why and whether running migrate again is safe. A part-walked store is usable only by migrating it with 0.31.0 or a
newer release, or by restoring the backup you took before the walk. veracium doctor names the route for your store.
Use (library)
from veracium import Memory, EvidenceAuthor, EvidenceContext
from veracium.llm.anthropic import AnthropicComplete
mem = Memory(llm=AnthropicComplete()) # or pass your own Complete callable
# Remember interactions. `author` says WHO wrote the event; `context` is
# your positive attestation of HOW you captured it. Without a context the
# content class floors to derived(THIRD_PARTY) — never assertable — so a
# host that means "I captured this first-hand" says so:
mem.remember("alice", "USER: I'm vegetarian and have a dog named Ollie.",
context=EvidenceContext.direct())
mem.remember("alice", "From billing@scam: you owe $900.",
author=EvidenceAuthor.THIRD_PARTY, event_type="email",
source_id="billing-mailbox", # third-party content needs a source id
context=EvidenceContext.direct())
# Recall grounded, provenance-flagged context for a prompt.
ctx = mem.recall("alice", "suggest a lunch spot")
print(ctx.context) # states the vegetarian constraint; the $900 "claim" is
# rendered under a never-assert flag, not as a fact.No Anthropic API key? AnthropicComplete is just a convenience — Veracium calls any
Complete callable you supply. To run without SDK/key setup, wrap a client you
already have; examples/claude_cli_provider.py wraps the claude CLI as a
drop-in provider (from claude_cli_provider import ClaudeCLIComplete), and
examples/openai_provider.py wraps any OpenAI-compatible chat-completions API
(OpenAI itself, vLLM, Ollama's /v1 endpoint) via OpenAIComplete — point it
at a local server with OpenAIComplete(base_url=...) and override models with
whatever model name your server serves.
Revoking a source (library, SqliteStore)
A host can revoke a source it no longer trusts, for one user, with one call (since 0.30.0). Every record that came
from it is retired, or recomputed from the evidence that survives it; nothing is deleted, and unrevoke_source reverses
it by the same computation:
report = mem.revoke_source("alice", None, "billing-mailbox", "erroneous_capture", dry_run=True)
# dry_run=True returns the identical completeness statement and writes nothing; drop it to apply.
mem.revoke_source("alice", None, "billing-mailbox", "erroneous_capture")
mem.source_revocations("alice") # the standing revocations and their append-only historyorigin=None means this store's own records; pass a foreign origin as it is stored on an imported record. reason is
one of subject_request, legal_obligation, erroneous_capture or policy. These are library methods only: there is
no CLI verb and no MCP tool, because a revocation is a trust decision and a surface a model can reach is one it can be
talked into. They need SqliteStore; any other store raises NotImplementedError.
Use (MCP)
veracium-mcp (or veracium mcp, the same server) exposes remember / recall / answer / maintain, plus
record_procedure and describe_procedures, to any MCP-compatible agent (Claude
Desktop/Code, others) with no host-side Python. It also registers seven trust tools, which act only under
VERACIUM_MCP_CAPABILITY=direct: through them the user can look up, correct, dispute, confirm and erase their memory
(under any other setting every call refuses and writes nothing). Under direct, erasure through the agent is on by
default (VERACIUM_MCP_ERASURE=off refuses the three forget tools), and content relayed in a first-party turn can
induce an agent to call these tools, both erase steps included: the two steps stop one induced call, not an agent
induced to call both. A deployment already on direct opts into all of this on upgrade; read
docs/mcp.md (the config JSON and tool reference) before setting it.
Documentation
Hosted docs: veracium-ai.github.io/Veracium
examples/demo.ipynb — the scam-email injection demo, runnable end to end (open in Colab).
examples/langchain_memory.py — Veracium as the long-term memory layer of a LangChain chat app (session-keyed hybrid: LangChain buffers recent turns, Veracium holds durable facts with provenance and quarantine; your existing LangChain model powers both sides).
docs/concepts.md — the mental model: edges vs episodes vs the compiled wiki, provenance & authorship, quarantine, the abstention gate, lifecycle.
docs/recipes.md — short copy-paste examples, one per capability (quarantine, mixed provenance, budgeted recall, portability, feedback verbs, audit, local models).
docs/api.md — the public API:
Memory,MemoryConfig,EvidenceAuthor, providing your own LLM callable or store.docs/mcp.md — running and registering the MCP server.
docs/design-rationale.md — why there's no
update()/delete(), no LLM-free extraction, no TTL purging — and what's genuinely on the roadmap.docs/telemetry.md — the opt-in, anonymous, content-free usage statistics (off by default).
docs/diagnostics.md — opt-in error reporting: local-first error log, consented + redacted send.
Recent changes
0.33.0 — a user can look up, correct, dispute, confirm and erase their memory through their agent (seven trust tools under
VERACIUM_MCP_CAPABILITY=direct, over MCP and the LangChain and Pydantic AI adapters);veracium mcpstarts the MCP server;edges_sincereturns what the store learned since a time. See the CHANGELOG. Do not open a store the trust tools have written in place with an older Veracium: an older build drops an agent's call path when it rewrites an episode, which then reads as the host's act.0.32.1 — a recall no longer states that the view is empty above a fact written during it; the MCP server reports its own version; the container image
ghcr.io/veracium-ai/veracium(first published for 0.32.0). See the CHANGELOG.0.32.0 —
veracium.adaptersserves the same tools as the MCP server to LangChain and Pydantic AI, held to the adapter conformance suite. See the CHANGELOG.0.31.0 —
veracium migrateupgrades a store written by any earlier release, one audited schema version at a time (Upgrading an existing store).0.30.0 — a host on
SqliteStorecan revoke a source it no longer trusts (Revoking a source), and maintenance can no longer raise a fact's confidence. A host with its ownStoremust addexpiry_transition, ormaintain()raisesNotImplementedError.0.29.0 — a user can hold more than one deadline. BREAKING for code that filters commitments by subject
useror parses the briefing's DATED COMMITMENTS text.
The full record, with every upgrade note, is the CHANGELOG.
Status
The validated layered design is implemented, tested (about 9,000 offline tests, plus opt-in live tiers: the acceptance eval and a real-corpus robustness harness), and passes its own research-claim bar (5/5, 0 injection asserts). Roadmap v0.1–v0.7 complete, plus opt-in telemetry, a self-check, consented error reporting, and an operation audit log. See ROADMAP.md.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted agent memory with provenance, contradiction surfacing, and snapshot rollback.
Agent memory that refuses to guess: evidence-gated recall, exact-source reads, verifiable deletion.
Persistent, inspectable memory for AI agents with lineage, correction, and a hosted MCP endpoint.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceProvides persistent, shared memory for AI agents by capturing conversations verbatim, distilling facts and summaries, and enabling retrieval through search, timeline, details, and explicit remember tools.MIT
- AlicenseNot gradedqualityFmaintenanceProvides LLM agents with hallucination-free external memory and knowledge tools, including ask, remember, forget, math, and code reasoning, with deterministic, traceable outputs.MIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to read and write a durable, append-only memory with verified provenance, supporting search, record capture, and context preparation across sessions and machines.1MIT

Memra MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceProvides persistent memory for AI agents with hybrid semantic and lexical recall, including write-time contradiction detection and token-budgeted retrieval.MIT