Skip to main content

Neruva MCP -- proprietary memory + grounding substrate for AI assistants (Claude Desktop / Claude Code / any MCP client). Typed Records store, document knowledge graph with exact multi-hop traversal (ownership/relationship tracing), semantic + structural recall, deterministic corrections, provenance/citations, GDPR/Law-25 atomic forget, snapshot/replay audit. Thin client: all algorithms run server-side. For Neruva integration clients only -- NOT open source. Bring your own LLM.

Project description

neruva-mcp

Reliability for AI agents — and for multi-agent operations. The Python MCP server for Neruva. Your agents stop repeating mistakes, stop spinning in circles, remember across every session, and get more reliable the longer they run. Every run is replayable bit-for-bit for audit. Bring your own LLM. Free tier, no card.

neruva.io · get a key at app.neruva.io

It just works — that's the point

Neruva is push, not pull. It runs silently in the background — no tools to learn, no glue code. Before each action it surfaces the past mistake (and the fix that worked) so the agent does it right; it breaks loops before they burn your budget; it records everything for replay. The agent never spends a token deciding to "use memory." The automatic operation is the moat — pull-based memory tools can't match it because they require the agent to stop and ask.

What you get

  • Stops repeating mistakes — past mistake + working fix surfaced automatically; a known-destructive repeat is blocked so the agent self-corrects.
  • Stops spinning — detects loops/stalls on a failing approach and breaks them.
  • Remembers across sessions and projects — persistent memory that builds itself from what your agents do.
  • Provable + replayable — deterministic from a seed; reproduce any run bit-for-bit for audit. Export the whole memory as one portable .neruva file.
  • Gets more reliable over time — learns from your agents' own history, no retraining, no weight changes.
  • Built for multi-agent operations — keeps shared memory consistent and catches an agent that's wrong or lying before it poisons the others. In a swarm, one unreliable agent compounds at every handoff; Neruva is the reliability layer underneath.

Install

pip install neruva-mcp

This installs the Neruva MCP server. Point your MCP host at it with your key:

{
  "mcpServers": {
    "neruva": {
      "command": "neruva-mcp",
      "env": { "NERUVA_API_KEY": "nv_..." }
    }
  }
}

For the silent auto-pilot hook (background mistake-recall, loop-break, recording) in Claude Code, install the companion: pip install neruva-record && neruva-record-install. Get a free key at app.neruva.io (no card).

The tool surface

A small, focused set: typed Records (ingest/query/timeline/get/update/delete, GDPR forget, compact, export/import), federated recall (agent_recall), the memory knowledge graph (hd_kg_*), snapshot/restore for replay, multi-agent consensus, and op stats. Bring your own LLM — the substrate stays deterministic and $0/call server-side.

Proof (cited honestly on neruva.io/benchmarks)

Test Result Plain meaning
Learns from mistakes +34 pts Same model, no retraining: 84%→93% over 2000 tasks vs flat 59% without.
Long-history memory (LongMemEval) 93.3% Top-tier on the standard agent-memory benchmark.
Replay determinism + accuracy (DFAH) 100% / 88% First to hit both at once.
Recall latency (p95, cache hit) ~80ms Answers from memory in well under a tenth of a second.

Config

Set NERUVA_API_KEY. NERUVA_URL defaults to https://api.neruva.io.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neruva_mcp-0.56.0.tar.gz (31.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

neruva_mcp-0.56.0-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

Details for the file neruva_mcp-0.56.0.tar.gz.

File metadata

  • Download URL: neruva_mcp-0.56.0.tar.gz
  • Upload date:
  • Size: 31.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for neruva_mcp-0.56.0.tar.gz
Algorithm Hash digest
SHA256 ab7f9cfd7b586e6335ddd20216bab12b39c7ba7efe2a453df925cac896735c7c
MD5 2b2a1295d63d28a8f05c8043d0694838
BLAKE2b-256 895d74861021621a1eb1e052aea193b35a16d093d48b8e817994b9e0ed01fd93

See more details on using hashes here.

File details

Details for the file neruva_mcp-0.56.0-py3-none-any.whl.

File metadata

  • Download URL: neruva_mcp-0.56.0-py3-none-any.whl
  • Upload date:
  • Size: 29.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for neruva_mcp-0.56.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e24f189d19d4a0b28710e8b45f90d0ca6596614d218ef04e7729a8de4020720f
MD5 212035b4f808c631d9421af66217e0f3
BLAKE2b-256 d56d13e988d8c8806377d9fd6e4bcac5ecaea25b11d97d6c0bc26f3f02e7a2b4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page