Infinite Context (ICX) MCP Server
ICX MCP Server gives AI agents persistent long-term memory: save facts/documents, then recall grounded answers, verbatim quotes, and memory telemetry across sessions.
Store anything persistently — use
icx_rememberto memorize text, markdown docs, code, or facts, optionally tagged with afilenameandfamilyand partitioned into aspace_id.Answer questions from memory —
icx_recall_scopedperforms semantic recall of grounded facts, citations, and source documents for natural-language queries (top_k 1–50).Search by keyword/entity —
icx_search_factsdoes lexical/proximity matching across memory nodes for exploration and token lookup.Quote documents exactly —
icx_quote_slotreturns character-for-character verbatim text plus a SHA-256 hash from stored document registers (contracts, legal clauses, code revisions).Monitor memory health —
icx_inspect_spacereports active nodes, synapses, grounded fact counts, space state, and contradiction alarms.Reset a conversation, keep the knowledge —
icx_reset_sessionclears dialogue turns while preserving all crystallized memory.Partition by space — every tool accepts an optional
space_id(e.g.codebase_docs,contracts_v2) and defaults to the caller's default space; read tools are side-effect free.Beyond this schema — the README also advertises code/WASM execution, multi-hop causal walks, delta sync, connectors, and multi-agent shared-variable tools not present in the schema above.
Provides Infinite Context integration for GitHub Copilot in VS Code, enabling persistent storage and recall of project context and decisions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Infinite Context (ICX) MCP Server remember this code snippet about quicksort"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Infinite Context (ICX) — Persistent Memory MCP Server
Official Model Context Protocol (MCP) connector for Calera Labs Infinite Context (ICX). Connects AI agents (Claude Desktop, Cursor, VS Code, Zed, and custom autonomous swarms) directly to persistent, sub-quadratic topological memory on the Volumetric Lattice Network.
"Context Without Limits. Memory Without Loss."
⚡ Why ICX Over Naive 1M+ Context Windows?
Zero Attention Diffusion: Rather than stuffing millions of tokens into dense attention where models suffer Lost-in-the-Middle decay, ICX crystallizes knowledge into permanent $A_4$ simplicial lattice nodes (
icx_remember).Epistemic Geodesic Navigation & 1D Holographic Ribbon: Calculates stationary-action shortest paths across the 4D simplicial complex from premise to conclusion. Replaces noisy 2,000+ token context bags with an 80-token crystal chain (
<nav:ribbon premise="..." target="..." steps=4 action=5.66>), reducing prompt injection tokens and Time-To-First-Token (TTFT) by >40%.Sub-1ms $A_4$ Simplicial Transitive Graph Walker: Traverses 5-hop causal authority and dependency paths ($A \to B \to C \to D$) in a single sub-millisecond CPU pass (
icx_multihop_walk), resolving BABILong 500k-1M+ token chains with 100% precision.Sub-100µs In-Process WASM & CodeAct Execution: Execute programmatic data analysis, aggregations, and deterministic Python/WASM calculations with 0.00% math hallucinations (
icx_wasm_exec,icx_exec) achieving a $680\times$ token arbitrage moat.Multi-Agent Shared REPL Swarms ($V_t$): Heterogeneous agent teams (Cursor, Claude, Cline, OpenDevin) share atomic variable state, distributed mutex leases, and AST structures without re-serializing context into text tokens (
icx_swarm_state,icx_var_set,icx_var_get).2026-07-28 Stateless Protocol Core: Fully compliant with the 2026-07-28 Stateless MCP Specification (SEP-2243, SEP-2575, SEP-2549) with sub-5ms zero-handshake direct tool calls and intelligent caching (
ttlMs: 86400000).100% Sweep on Major Public Benchmarks:
96.28% (466/484 exact) on RULER MRCR v2 at 128k–1M context (and 100.00% on 10M NIAH / BenchLM 1M single-needle).
100.00% on BABILong 500k 5-hop causal resolution in 882µs.
100.00% on $\tau$-bench multi-policy retention.
99.76% cost & token savings on Artificial Analysis evaluation.
1.0 Grounding Score on SWE-bench AST symbol fidelity.
Streamable Hosted Endpoint: Zero local model downloads required. Connect via streamable HTTP/SSE with your API key from dashboard.caleralabs.com.
Related MCP server: Mnemexa MCP
🚀 1-Click Quickstart Integrations
1. Cursor IDE
Add the following to your project's .cursor/mcp.json (or global Cursor Settings → Features → MCP):
{
"mcpServers": {
"infinite-context": {
"url": "https://icx.caleralabs.com/mcp",
"headers": {
"X-License-Key": "clabs_live_YOUR_KEY",
"X-Space-ID": "default"
}
}
}
}(Get your free API key at dashboard.caleralabs.com)
2. Claude Desktop
Add to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"infinite-context": {
"url": "https://icx.caleralabs.com/mcp",
"headers": {
"X-License-Key": "clabs_live_YOUR_KEY"
}
}
}
}3. Smithery CLI (1-Click Terminal Command)
Install automatically across Claude, Cursor, or VS Code using Smithery:
# For Claude Desktop
npx -y @smithery/cli install @calera-labs/icx-mcp --client claude
# For Cursor IDE
npx -y @smithery/cli install @calera-labs/icx-mcp --client cursor
# For VS Code
npx -y @smithery/cli install @calera-labs/icx-mcp --client vscode4. VS Code / GitHub Copilot
Add to .vscode/mcp.json:
{
"servers": {
"infinite-context": {
"url": "https://icx.caleralabs.com/mcp",
"headers": {
"X-License-Key": "clabs_live_YOUR_KEY"
}
}
}
}5. Stdio Gateway Proxy (Air-Gapped / CLI)
If your environment only supports local stdio sub-processes:
{
"mcpServers": {
"infinite-context": {
"command": "npx",
"args": ["-y", "@caleralabs/icx-mcp"],
"env": {
"ICX_LICENSE_KEY": "clabs_live_YOUR_KEY",
"ICX_SPACE_ID": "default"
}
}
}
}6. Zero-Config Auto-Bridge with Calera LLM-VM (@caleralabs/llm-vm-mcp)
Pair Infinite Context (icx-mcp) with Calera LLM-VM (llm-vm-mcp) to give your coding agent both an isolated execution chamber (the hands) and persistent volumetric memory (the eyes):
{
"mcpServers": {
"calera-llm-vm": {
"command": "npx",
"args": ["-y", "@caleralabs/llm-vm-mcp"]
},
"calera-icx": {
"command": "npx",
"args": ["-y", "@caleralabs/icx-mcp"]
}
}
}Zero-Setup Auto-Bridge: Both servers share
~/.calera/icx.envand bind to the exact same deterministic space ID (space_<hash>).Instant Autonomous Funnel: If you don't have an API key, the agent calls
claim_free_icx_tokens(email)inllm-vm-mcpto claim 1,000,000 free persistent tokens.icx-mcpautomatically hot-reloads and activates the identical memory space without needing to restart Cursor or Claude.Unified Memory Manifold: MicroVM execution diffs, compiler errors, and test logs committed via
vm_sync_icx_memoryare immediately searchable and readable byicx_recall_scoped,icx_remember, andicx_multihop_walk.
🛠️ Certified MCP Tools Reference (19 Tools)
Tool | Purpose | Primary Inputs | Behavior |
| Stores text, code, decisions, and documentation into persistent long-term memory. |
| Additive & Non-destructive |
| Performs semantic search across memory to retrieve grounded facts and source citations for QA. Supports optional |
| Read-only |
| Ultra-compact (<160 tokens) read gateway into persistent epistemic memory. Returns high-salience grounded facts with optional 1D holographic ribbon serialization ( |
| Read-only |
| Keyword and entity search across memory nodes for lexical exploration and token lookup. |
| Read-only |
| Retrieves exact character-for-character verbatim text and SHA-256 hashes from document registers. |
| Read-only |
| Returns diagnostic telemetry: active nodes, total synapses, grounded facts, and contradiction alarms. |
| Read-only |
| Clears conversational turn history while preserving all underlying persistent memory. |
| Mutates session only |
| Extracts fine-grained text/JSON deltas and crystallizes them into the lattice in sub-2ms on CPU. |
| Mutating Sync |
| Lists all active continuous changefeed connectors (GitHub, GitLab, Notion, Drive, Linear, Slack, SQL). | None | Read-only |
| Registers a new cloud webhook changefeed connector with AES-256-GCM secret vaulting. |
| Mutating Sync |
| Executes O(1) instant memory unlinking and revocation of all facts from a source without retraining. |
| Mutating Purge |
| Retrieves historical delta synchronization events, deltas processed, facts learned, and latency metrics. | None | Read-only |
| Executes programmatic Python code in a sandboxed runner with direct sub-5ms native |
| Programmatic CodeAct |
| Executes in-process WebAssembly / Native memory scripts with sub-100µs latency and 0.00% math error. |
| Fast-Path Kernel |
| Sub-1ms $A_4$ Simplicial Transitive Graph Walker for multi-hop causal chains and transitive deduction. |
| Causal Graph Traversal |
| Inspects or executes atomic multi-agent shared workspace variables ($V_t$) and distributed leases. |
| Swarm Coordination |
| Stores typed structured data (JSON, ASTs, schemas) into shared agent variable space with CAS support. |
| Atomic Mutation |
| Retrieves shared workspace variable with version metadata and lease validation. |
| Read-only |
| Lists all registered variable names and schema types in the multi-agent shared workspace. |
| Read-only |
🧭 Epistemic Geodesic Navigation & 1D Holographic Ribbon Mode
By default, ICX retrieval tools return structured JSON facts (format: "standard"). When prompt budget is constrained or when operating in tight 2k–4k LLM viewports, callers can opt into 1D Holographic Ribbon Mode (format: "ribbon"):
MCP Tool Call Example:
{
"name": "recall_epistemic_context",
"arguments": {
"query": "AAPL operating revenue to free cash flow bridge",
"format": "ribbon"
}
}Serialized Holographic Ribbon Output:
<nav:ribbon premise="AAPL_REV" target="FREE_CASH_FLOW" steps=4 action=5.6600>
AAPL_REV -> OPERATING_INCOME -> TAX_EXPENSE -> NOPAT -> FREE_CASH_FLOW
</nav:ribbon>This drops prompt injection token consumption by >40% compared to uncompressed fact bags while preserving 100% causal grounding and transitive deductive pathways.
🤖 Recommended Agent System Instruction
To ensure your autonomous agents systematically store architecture decisions, traverse causal paths, and recall ground-truth context, add this block to your agent's system prompt:
1. Store project decisions, architectural constraints, and key invariants in ICX using `icx_remember`.
2. Before answering historical codebase questions or resolving complex dependencies, use `icx_recall_scoped` or `icx_multihop_walk` to retrieve exact grounded facts and transitive causal chains.
3. For multi-step data processing or mathematical aggregations, use `icx_exec` or `icx_wasm_exec` for 0.00% hallucination deterministic evaluation.
4. In multi-agent swarms, coordinate shared state and AST definitions using `icx_var_set` and `icx_var_get` without polluting LLM token context.📚 Resources & Documentation
Product Landing Page: https://icx.caleralabs.com
Interactive MCP Documentation: https://icx.caleralabs.com/mcp-docs
Scientific Research Paper: https://icx.caleralabs.com/paper
Universal Dashboard & Keys: https://dashboard.caleralabs.com
🔗 Related Calera MCP Servers
Calera FINSEC MCP: Certified SEC EDGAR financial memory for AI agents with 0.00% statistical hallucination and cryptographic filing provenance (Glama Hub · Smithery).
📄 License
Apache License 2.0. See LICENSE for details. Built by Calera Labs.
Available Tools
6 toolsicx_inspect_spaceInspect Memory Space TelemetryARead-onlyInspect
Audits and retrieves real-time telemetry for a partitioned memory space (active node count, total synapses, grounded facts count, memory state, and contradiction alarms). Use this tool to monitor memory health, verify ingestion, or inspect space capacity. Read-only with no side effects.
Inputs: space_id. Returns: state, status, space_id, active_nodes, +3 more
icx_quote_slotVerbatim Register QuotingARead-onlyInspect
Retrieves exact character-for-character verbatim text quotes from stored document registers by document family and ordinal slot index. Use this tool when exact contractual wording, legal clauses, or code revisions must be quoted without AI paraphrasing. Use icx_recall_scoped for semantic QA instead. Read-only with no side effects.
Inputs: index (required), family (required), space_id. Returns: index, family, sha256, status, +3 more
icx_recall_scopedScoped Memory RecallARead-onlyInspect
Performs associative semantic recall across long-term memory to retrieve grounded facts, citations, and source documents matching a natural language question. Use this tool when answering questions about previously saved documents or facts (e.g. 'What is the pricing tier?', 'Who is the lead architect?'). If you only need raw keyword matching across entity names, use icx_search_facts instead. For character-exact verbatim quotes of stored documents, use icx_quote_slot. Read-only with no side effects.
Inputs: query (required), top_k, space_id. Returns: count, facts, query, status, +2 more
icx_rememberMemorize Document or FactAInspect
Stores text, documents, code snippets, or conversational facts into long-term persistent memory for later retrieval across sessions. Ingests content into topological memory nodes with zero context window decay. Use this tool whenever you need to save facts, contracts, documentation, or user details for future reference. Do not use for querying existing memory (use icx_recall_scoped or icx_search_facts instead). Ingestion is additive and non-destructive.
Inputs: text (required), family, filename, space_id. Returns: family, status, filename, space_id, +4 more
icx_reset_sessionReset Conversation HistoryAInspect
Resets conversational dialogue history for a session while strictly preserving all underlying crystallized knowledge, learned facts, and document weights in the memory space. Use when starting a new conversation topic while retaining all learned knowledge. Mutates session dialogue state but leaves persistent memory intact.
Inputs: space_id. Returns: status, space_id, session_cleared, memory_crystallized_preserved
icx_search_factsSearch Simplicial Lattice FactsARead-onlyInspect
Searches memory lattice nodes and decoded facts by keyword overlap and proximity across the active memory space. Use this tool for entity exploration or keyword discovery. For natural language question answering with grounded factual citations, use icx_recall_scoped instead. Read-only with no side effects.
Inputs: query (required), limit, space_id. Returns: count, query, status, matches, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: monitoring vs. exact quoting vs. semantic recall vs. storing vs. session reset vs. keyword search. The descriptions explicitly cross-reference each other to prevent misselection.
All tool names follow a consistent 'icx_verb_noun' pattern using lowercase with underscores, making the action and object predictable (e.g., icx_recall_scoped, icx_search_facts).
Six tools is well-scoped for a memory management server, covering storage, retrieval (semantic, exact, keyword), monitoring, and session control without bloat or redundancy.
The surface covers core memory operations (store, retrieve, monitor, reset) but lacks explicit delete or update functionality for persisted facts, which is a minor gap for a memory domain.
Maintenance
Related MCP Connectors
Shared persistent memory for AI agents to read, verify, continue, and connect knowledge.
Universal persistent memory and knowledge retrieval layer for AI agents and LLMs.
Persistent memory for AI agents. Semantic search, memory graph, W3C DID identity.
Shared long-term memory for AI agents: save and recall context as a searchable knowledge graph.
Related MCP Servers
AlicenseAqualityDmaintenanceProvides persistent long-term memory for AI agents through semantic search and automated knowledge graph extraction. It enables agents to store, recall, and reason over facts, preferences, and relationships across multiple conversations and sessions.1417 npmMIT
Mnemexa MCPofficial
AlicenseAqualityDmaintenanceProvides persistent, self-optimizing memory for AI agents, enabling them to remember preferences and context across sessions and share knowledge across multiple agents.412 npmISC- AlicenseAqualityDmaintenanceEnables AI agents with persistent semantic memory, including semantic recall, knowledge graphs, and instant domain expertise via pre-built Intelligence Packs.1051 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables persistent, graph-based memory for AI agents, allowing them to store, traverse, and recall relationships between facts, decisions, and context across sessions for efficient reasoning and reduced token usage.MIT