{"id":"6832899b-d638-4e98-8b1c-2eb6890db087","slug":"icx-mcp","kind":"mcp","name":"icx-mcp","summary":"","owner":"Calera-Labs","repoUrl":"https://github.com/Calera-Labs/icx-mcp","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-08-20T15:44:13.000Z","addedAt":"2026-10-26T21:08:46.786Z","logoUrl":"https://avatars.githubusercontent.com/u/318276579?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["utilities"],"tags":[],"runtime":"remote","local":false,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-26T21:08:58.676Z","sample":false,"url":"https://conduits.dev/tools/icx-mcp","language":"Python","transports":["http"],"install":{"remoteUrl":"https://icx.caleralabs.com/mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Infinite Context (ICX) — Persistent Memory MCP Server\n\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry_Indexed-blue.svg)](https://registry.modelcontextprotocol.io)\n[![Smithery](https://img.shields.io/badge/Smithery-calera--labs%2Ficx--mcp-orange.svg)](https://smithery.ai/servers/calera-labs/icx-mcp)\n[![Glama MCP](https://glama.ai/mcp/servers/Calera-Labs/icx-mcp/badge)](https://glama.ai/mcp/servers/Calera-Labs/icx-mcp)\n[![Glama MCP Score](https://glama.ai/mcp/servers/Calera-Labs/icx-mcp/badges/score.svg)](https://glama.ai/mcp/servers/Calera-Labs/icx-mcp)\n[![License](https://img.shields.io/badge/License-Apache_2.0-green.svg)](LICENSE)\n[![RULER Score](https://img.shields.io/badge/RULER_MRCR_v2-96.28%25_(466%2F484)-emerald.svg)](https://icx.caleralabs.com/paper)\n[![Latency](https://img.shields.io/badge/Recall_Latency-Sub--5ms_Topological-purple.svg)](https://icx.caleralabs.com)\n\nOfficial **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**.\n\n> **\"Context Without Limits. Memory Without Loss.\"**\n\n---\n\n## ⚡ Why ICX Over Naive 1M+ Context Windows?\n\n* **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`).\n* **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%.\n* **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.\n* **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**.\n* **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`).\n* **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`).\n* **100% Sweep on Major Public Benchmarks:**\n  * **96.28% (466/484 exact)** on RULER MRCR v2 at 128k–1M context (and **100.00%** on 10M NIAH / BenchLM 1M single-needle).\n  * **100.00%** on BABILong 500k 5-hop causal resolution in 882µs.\n  * **100.00%** on $\\tau$-bench multi-policy retention.\n  * **99.76% cost & token savings** on Artificial Analysis evaluation.\n  * **1.0 Grounding Score** on SWE-bench AST symbol fidelity.\n* **Streamable Hosted Endpoint:** Zero local model downloads required. Connect via streamable HTTP/SSE with your API key from [dashboard.caleralabs.com](https://dashboard.caleralabs.com).\n\n---\n\n## 🚀 1-Click Quickstart Integrations\n\n### 1. Cursor IDE\n\nAdd the following to your project's `.cursor/mcp.json` (or global Cursor Settings → Features → MCP):\n\n```json\n{\n  \"mcpServers\": {\n    \"infinite-context\": {\n      \"url\": \"https://icx.caleralabs.com/mcp\",\n      \"headers\": {\n        \"X-License-Key\": \"clabs_live_YOUR_KEY\",\n        \"X-Space-ID\": \"default\"\n      }\n    }\n  }\n}\n```\n*(Get your free API key at [dashboard.caleralabs.com](https://dashboard.caleralabs.com))*\n\n---\n\n### 2. Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n* **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n* **Linux:** `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"infinite-context\": {\n      \"url\": \"https://icx.caleralabs.com/mcp\",\n      \"headers\": {\n        \"X-License-Key\": \"clabs_live_YOUR_KEY\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### 3. Smithery CLI (1-Click Terminal Command)\n\nInstall automatically across Claude, Cursor, or VS Code using Smithery:\n\n```bash\n# For Claude Desktop\nnpx -y @smithery/cli install @calera-labs/icx-mcp --client claude\n\n# For Cursor IDE\nnpx -y @smithery/cli install @calera-labs/icx-mcp --client cursor\n\n# For VS Code\nnpx -y @smithery/cli install @calera-labs/icx-mcp --client vscode\n```\n\n---\n\n### 4. VS Code / GitHub Copilot\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"infinite-context\": {\n      \"url\": \"https://icx.caleralabs.com/mcp\",\n      \"headers\": {\n        \"X-License-Key\": \"clabs_live_YOUR_KEY\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### 5. Stdio Gateway Proxy (Air-Gapped / CLI)\n\nIf your environment only supports local `stdio` sub-processes:\n\n```json\n{\n  \"mcpServers\": {\n    \"infinite-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@caleralabs/icx-mcp\"],\n      \"env\": {\n        \"ICX_LICENSE_KEY\": \"clabs_live_YOUR_KEY\",\n        \"ICX_SPACE_ID\": \"default\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### 6. Zero-Config Auto-Bridge with Calera LLM-VM (`@caleralabs/llm-vm-mcp`)\n\nPair **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):\n\n```json\n{\n  \"mcpServers\": {\n    \"calera-llm-vm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@caleralabs/llm-vm-mcp\"]\n    },\n    \"calera-icx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@caleralabs/icx-mcp\"]\n    }\n  }\n}\n```\n\n* **Zero-Setup Auto-Bridge:** Both servers share `~/.calera/icx.env` and bind to the exact same deterministic space ID (`space_<hash>`).\n* **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.\n* **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`.\n\n---\n\n## 🛠️ Certified MCP Tools Reference (19 Tools)\n\n| Tool | Purpose | Primary Inputs | Behavior |\n| :--- | :--- | :--- | :--- |\n| **`icx_remember`** | Stores text, code, decisions, and documentation into persistent long-term memory. | `text` (required), `space_id`, `filename`, `family` | Additive & Non-destructive |\n| **`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 |\n| **`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 |\n| **`icx_search_facts`** | Keyword and entity search across memory nodes for lexical exploration and token lookup. | `query` (required), `space_id`, `limit` | Read-only |\n| **`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 |\n| **`icx_inspect_space`** | Returns diagnostic telemetry: active nodes, total synapses, grounded facts, and contradiction alarms. | `space_id` (optional) | Read-only |\n| **`icx_reset_session`** | Clears conversational turn history while preserving all underlying persistent memory. | `space_id` (optional) | Mutates session only |\n| **`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 |\n| **`icx_list_connectors`** | Lists all active continuous changefeed connectors (GitHub, GitLab, Notion, Drive, Linear, Slack, SQL). | *None* | Read-only |\n| **`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 |\n| **`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 |\n| **`icx_sync_audit`** | Retrieves historical delta synchronization events, deltas processed, facts learned, and latency metrics. | *None* | Read-only |\n| **`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 |\n| **`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 |\n| **`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 |\n| **`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 |\n| **`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 |\n| **`icx_var_get`** | Retrieves shared workspace variable with version metadata and lease validation. | `name` (required), `space_id` | Read-only |\n| **`icx_var_list`** | Lists all registered variable names and schema types in the multi-agent shared workspace. | `space_id` (optional) | Read-only |\n\n---\n\n## 🧭 Epistemic Geodesic Navigation & 1D Holographic Ribbon Mode\n\nBy 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\"`):\n\n### MCP Tool Call Example:\n```json\n{\n  \"name\": \"recall_epistemic_context\",\n  \"arguments\": {\n    \"query\": \"AAPL operating revenue to free cash flow bridge\",\n    \"format\": \"ribbon\"\n  }\n}\n```\n\n### Serialized Holographic Ribbon Output:\n```xml\n<nav:ribbon premise=\"AAPL_REV\" target=\"FREE_CASH_FLOW\" steps=4 action=5.6600>\nAAPL_REV -> OPERATING_INCOME -> TAX_EXPENSE -> NOPAT -> FREE_CASH_FLOW\n</nav:ribbon>\n```\n\nThis drops prompt injection token consumption by **>40%** compared to uncompressed fact bags while preserving 100% causal grounding and transitive deductive pathways.\n\n---\n\n## 🤖 Recommended Agent System Instruction\n\nTo 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:\n\n```markdown\n1. Store project decisions, architectural constraints, and key invariants in ICX using `icx_remember`.\n2. 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.\n3. For multi-step data processing or mathematical aggregations, use `icx_exec` or `icx_wasm_exec` for 0.00% hallucination deterministic evaluation.\n4. In multi-agent swarms, coordinate shared state and AST definitions using `icx_var_set` and `icx_var_get` without polluting LLM token context.\n```\n\n---\n\n## 📚 Resources & Documentation\n\n* **Product Landing Page:** [https://icx.caleralabs.com](https://icx.caleralabs.com)\n* **Interactive MCP Documentation:** [https://icx.caleralabs.com/mcp-docs](https://icx.caleralabs.com/mcp-docs)\n* **Scientific Research Paper:** [https://icx.caleralabs.com/paper](https://icx.caleralabs.com/paper)\n* **Universal Dashboard & Keys:** [https://dashboard.caleralabs.com](https://dashboard.caleralabs.com)\n\n---\n\n## 🔗 Related Calera MCP Servers\n\n* **[Calera FINSEC MCP](https://github.com/Calera-Labs/finsec-mcp):** Certified SEC EDGAR financial memory for AI agents with 0.00% statistical hallucination and cryptographic filing provenance ([Glama Hub](https://glama.ai/mcp/servers/Calera-Labs/finsec-mcp) · [Smithery](https://smithery.ai/servers/calera-labs/finsec)).\n\n---\n\n## 📄 License\n\nApache License 2.0. See [LICENSE](LICENSE) for details. Built by [Calera Labs](https://caleralabs.com).\n\n"}