Skip to main content
Glama
Infinite Context (ICX) MCP Server

Infinite Context (ICX) MCP Server

Infinite Context (ICX) — Persistent Memory MCP Server

MCP Registry Smithery Glama MCP Glama MCP Score License RULER Score Latency

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.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.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 vscode

4. 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.env and 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) in llm-vm-mcp to claim 1,000,000 free persistent tokens. icx-mcp automatically 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_memory are immediately searchable and readable by icx_recall_scoped, icx_remember, and icx_multihop_walk.


🛠️ Certified MCP Tools Reference (19 Tools)

Tool

Purpose

Primary Inputs

Behavior

icx_remember

Stores text, code, decisions, and documentation into persistent long-term memory.

text (required), space_id, filename, family

Additive & Non-destructive

icx_recall_scoped

Performs semantic search across memory to retrieve grounded facts and source citations for QA. Supports optional format: "ribbon" for 1D Geodesic Ribbon prompt injection.

query (required), space_id, top_k, format (optional: standard | ribbon)

Read-only

recall_epistemic_context

Ultra-compact (<160 tokens) read gateway into persistent epistemic memory. Returns high-salience grounded facts with optional 1D holographic ribbon serialization (format: "ribbon").

query (required), space_id, top_k, format (optional: standard | ribbon)

Read-only

icx_search_facts

Keyword and entity search across memory nodes for lexical exploration and token lookup.

query (required), space_id, limit

Read-only

icx_quote_slot

Retrieves exact character-for-character verbatim text and SHA-256 hashes from document registers.

family (required), index (required), space_id

Read-only

icx_inspect_space

Returns diagnostic telemetry: active nodes, total synapses, grounded facts, and contradiction alarms.

space_id (optional)

Read-only

icx_reset_session

Clears conversational turn history while preserving all underlying persistent memory.

space_id (optional)

Mutates session only

icx_sync_delta

Extracts fine-grained text/JSON deltas and crystallizes them into the lattice in sub-2ms on CPU.

new_text (required), old_text, uri, source_id, space_id

Mutating Sync

icx_list_connectors

Lists all active continuous changefeed connectors (GitHub, GitLab, Notion, Drive, Linear, Slack, SQL).

None

Read-only

icx_register_connector

Registers a new cloud webhook changefeed connector with AES-256-GCM secret vaulting.

type (required), name (required), target_uri (required), webhook_secret

Mutating Sync

icx_purge_source

Executes O(1) instant memory unlinking and revocation of all facts from a source without retraining.

source_id (required), space_id

Mutating Purge

icx_sync_audit

Retrieves historical delta synchronization events, deltas processed, facts learned, and latency metrics.

None

Read-only

icx_exec

Executes programmatic Python code in a sandboxed runner with direct sub-5ms native icx memory bindings.

code (required), space_id, timeout_ms

Programmatic CodeAct

icx_wasm_exec

Executes in-process WebAssembly / Native memory scripts with sub-100µs latency and 0.00% math error.

wasm_base64 or wat_text (required), space_id

Fast-Path Kernel

icx_multihop_walk

Sub-1ms $A_4$ Simplicial Transitive Graph Walker for multi-hop causal chains and transitive deduction.

start_entity (or root_entity), target_entity, max_hops, space_id

Causal Graph Traversal

icx_swarm_state

Inspects or executes atomic multi-agent shared workspace variables ($V_t$) and distributed leases.

action (required: get/set/list/lease), var_name, space_id

Swarm Coordination

icx_var_set

Stores typed structured data (JSON, ASTs, schemas) into shared agent variable space with CAS support.

name (required), value (required), expected_version, space_id

Atomic Mutation

icx_var_get

Retrieves shared workspace variable with version metadata and lease validation.

name (required), space_id

Read-only

icx_var_list

Lists all registered variable names and schema types in the multi-agent shared workspace.

space_id (optional)

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.


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



📄 License

Apache License 2.0. See LICENSE for details. Built by Calera Labs.

Available Tools

6 tools
icx_inspect_spaceInspect Memory Space TelemetryA
Read-only
Inspect

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 QuotingA
Read-only
Inspect

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 RecallA
Read-only
Inspect

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 FactsA
Read-only
Inspect

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

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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).

    Tool Count5/5

    Six tools is well-scoped for a memory management server, covering storage, retrieval (semantic, exact, keyword), monitoring, and session control without bloat or redundancy.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      14
      17 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides persistent, self-optimizing memory for AI agents, enabling them to remember preferences and context across sessions and share knowledge across multiple agents.
      4
      12 npm
      ISC
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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