Skip to main content
ClawQL

Session cache (cache)

The cache MCP tool is ClawQL Core — always registered (no opt-out). It stores temporary key/value data in the ClawQL server process. It is not durable and not the Obsidian vault.

  • Storage: A single Map in this Node process — no disk, no memory.db, no Markdown.
  • Eviction: LRU when CLAWQL_CACHE_MAX_ENTRIES is reached (default 10_000). get and set refresh recency; set may return evicted when keys were dropped to make room.
  • Per-value limit: CLAWQL_CACHE_MAX_VALUE_BYTES (default 1 MiB, max 16 MiB).

For anything that must survive restarts or be shared across replicas, use memory_ingest and memory_recall with a configured vault path — not cache.

Canonical reference (operations, semantics, multi-replica, issue table): cache-tool.md · mcp-tools.md. #75 is closed (Core cache shipped); #29 is open (unrelated: index negative-cache discovery).

See also Tools for how cache fits alongside other MCP tools.