KnowledgeMay 12, 2026·3 min read

yantrikdb-server — Memory DB with Contradiction Checks

YantrikDB adds persistent agent memory with contradiction checks. Use `yantrikdb-mcp` for Claude Code/Cursor, or scale with a server cluster.

Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Needs Confirmation · 62/100Policy: confirm
Agent surface
Any MCP/CLI agent
Kind
Mcp
Install
Pip
Trust
Trust: Established
Entrypoint
pip install yantrikdb-mcp && yantrikdb-mcp --help
Universal CLI install command
npx tokrepo install 84ec90f4-1f41-5595-ba10-fedfb0b8bc40
Intro

yantrikdb-server focuses on deployment and clustering for a cognitive memory database: it helps agents retain decisions, surface stale memories, and flag contradictions without being prompted every time.

Best for: Agents that need durable memory with governance (staleness + contradictions)

Works with: Local SQLite memory by default; optional cluster via server URL + token; MCP clients (Claude Code/Cursor/Windsurf)

Setup time: 10–25 minutes

Key facts (verified)

  • README quickstart says one pip install yantrikdb-mcp plus a config block to enable MCP.
  • README states the MCP server exposes 15 memory tools after restart.
  • GitHub: 142 stars · 9 forks; pushed 2026-05-12 (GitHub API verified).

Main

To keep memory helpful (not noisy):

  • Start with local SQLite memory to validate what your agents store, then move to a shared cluster once the schema and access policies are clear.
  • Use contradiction flags as prompts for clarification, not as “truth adjudication”.
  • Periodically review what gets remembered: prefer stable preferences, decisions, and constraints over raw transcripts.

README excerpt (verbatim)

YantrikDB

Correction notice (2026-04-19): Phase 3 benchmark writeups committed earlier today (docs/phase3a/, docs/phase3b/, docs/phase3c/, docs/phase3d/) used a Python simulator for the "structured memory" condition — NOT the actual yantrikdb engine. Rerun with real yantrikdb is in docs/phase3e/. Full audit trail in CORRECTIONS.md. Full corrected findings post coming 2026-04-20.

A memory database that forgets, consolidates, and detects contradictions.

Vector databases store memories. They don't manage them. After 10,000 memories, recall quality degrades because there's no consolidation, no forgetting, no conflict resolution. Your AI agent just gets noisier.

YantrikDB is different. It's a cognitive memory engine — embed it, run it as a server, or connect via MCP. It thinks about what it stores.

Shortest path to try it: MCP setup for Claude Code / Cursor / Windsurf → (one pip install, one config block).

The bigger picture: YantrikDB is the memory layer being built on the road to YantrikOS — an AI-native operating system where agents are first-class primitives, not apps on top. Memory was the bottleneck, so we're shipping it first.

Crates.io PyPI Docker DOI License: AGPL-3.0

📄 New paper (May 2026): Skill as Memory, Not Document — measuring three failure modes when agent skill catalogs scale to 5,000 skills. Code + raw CSVs reproducible in benchmarks/skill_recall/.

YantrikDB demo: storing three facts, recalling them, then think() flagging a contradiction between two memories

99.9% token savings vs file-based memory

Memories File-Based (CLAUDE.md) YantrikDB Token Savings Recall Precision
100 1,770 tokens 69 tokens 96% 66%
500 9,807 tokens 72 tokens 99.3% 77%

FAQ

Q: Is the MCP server separate? A: README points to yantrikdb-mcp as the recommended starting point for Claude Code/Cursor/Windsurf.

Q: Where is memory stored by default? A: README says it uses a local SQLite file under ~/.yantrikdb/memory.db.

Q: How do I share memory? A: README shows configuring YANTRIKDB_SERVER_URL and YANTRIKDB_TOKEN for cluster mode.

🙏

Source & Thanks

Source: https://github.com/yantrikos/yantrikdb-server > License: AGPL-3.0 > GitHub stars: 142 · forks: 9

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets