@kolivri/memoria-mcp — Deterministic AI Memory & Code Intelligence MCP for Claude Code, OpenCode, Cursor & Claude Desktop

@kolivri/memoria-mcp is the official zero-dependency Node.js ESM Model Context Protocol (MCP) connector (stdio & HTTP) for Memoria Cloud — giving AI coding and operator agents (Claude Code, OpenCode, Cursor, Windsurf, VS Code, Cline, Roo Code, Zed, Goose, and Claude Desktop) deterministic long-term memory, cross-session recall, and code intelligence powered by memoria.kolivri.com.

• Memoria Cloud Portal & API Keys: https://memoria.kolivri.com (Get API Key — includes 1,000 free API calls/memories; paid tiers: Developer $19/mo, Startup $79/mo, Business $299/mo)
• Documentation & Benchmarks: https://memoria.kolivri.com/docs (500/500 = 100.0% LongMemEval at 12.9 ms p50, 102/102 = 100.0% Hebrew LongMemEval across 15 languages)
• Support: stas@kolivri.com · WhatsApp 054-787-5670

---

Environment Variables

Variable	Required	Default	Description
MEMORIA_API_KEY	Yes	—	Your Memoria Cloud API key (mem_dev_..., mem_start_..., or mem_biz_...) from memoria.kolivri.com/register
MEMORIA_API_URL	Optional	https://memoria.kolivri.com	Memoria Cloud base URL
MEMORIA_NAMESPACE	Optional	default	Default project/workspace namespace when omitted from tool arguments

---

Installation

1. One-Line Auto-Installer (15 AI Clients + Claude Code Lifecycle Hooks)

Automatically configures Claude Code, Cursor, Windsurf, VS Code, Claude Desktop, OpenCode, Cline, Roo Code, Continue, Zed, Goose, PearAI, Trae, Void, and Melty:

# macOS / Linux / WSL
curl -fsSL --proto '=https' --tlsv1.2 https://memoria.kolivri.com/install.sh | bash -s -- --api-key YOUR_MEMORIA_API_KEY

# Windows PowerShell
$env:MEMORIA_API_KEY="YOUR_MEMORIA_API_KEY"; irm https://memoria.kolivri.com/downloads/install.ps1 | iex

2. Claude Code (claude mcp add)

claude mcp add memoria \
  -e MEMORIA_API_KEY="your-memoria-api-key" \
  -- npx -y github:kolivritech/memoria-mcp

3. Cursor (~/.cursor/mcp.json) & Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "memoria": {
      "command": "npx",
      "args": ["-y", "github:kolivritech/memoria-mcp"],
      "env": {
        "MEMORIA_API_KEY": "your-memoria-api-key",
        "MEMORIA_NAMESPACE": "my-project"
      }
    }
  }
}

4. OpenCode (~/.config/opencode/opencode.json)

{
  "mcp": {
    "memoria": {
      "type": "local",
      "command": ["npx", "-y", "github:kolivritech/memoria-mcp"],
      "environment": {
        "MEMORIA_API_KEY": "your-memoria-api-key",
        "MEMORIA_NAMESPACE": "my-project"
      },
      "enabled": true
    }
  }
}

5. Docker

docker build -t memoria-mcp .
docker run -i --rm \
  -e MEMORIA_API_KEY="your-memoria-api-key" \
  -e MEMORIA_NAMESPACE="my-project" \
  memoria-mcp

---

14 MCP Tools (https://memoria.kolivri.com/v1/mcp)

Tool	Required Args	Description
encode_memory	content	Store a new memory in Memoria Cloud with tier (episodic, semantic, buffer, core), salience (0.0–1.0), namespace, and context pairs.
batch_encode	memories	Atomically encode an array of memories in a single call.
recall_memories	query	Retrieve top memories ranked deterministically by Memoria Cloud within token_budget.
build_context	query	Assemble a token-budgeted <memory_context> block grouped into Core Rules, Established Facts, and Recent Context.
forget_memory	id	Delete a specific memory and its incident graph edges by ID.
delete_by_context	key, value	Delete all memories matching a specific [key, value] context metadata pair.
feedback	id, useful	Record positive/negative utility feedback on a memory and adjust its salience score.
consolidate	namespace	Deduplicate memories within a namespace and promote recurring high-salience episodic memories to Semantic tier.
health	(none)	Return Memoria Cloud engine health, active memory/edge counts, and tier distribution.
stats	namespace	Return per-namespace memory count, edge count, and tier distribution.
search_code	query	Search indexed code symbol definitions and references with file paths and line numbers.
explain_code	target	Explain a symbol: definitions, workspace references, related tests, and associated architectural memories.
list_agent_wings	(none)	List specialist multi-agent wings (architect, reviewer, qa, security, ops) and active memory counts.
handoff_to_agent	from_wing, to_wing, summary, task	Record a structured context handoff between specialist agent wings.

---

Running Connector Tests

npm test

License

Connector package licensed under MIT. Memoria Cloud (https://memoria.kolivri.com) is a commercial hosted service by Kolivri Ltd.