imperal-mcp · The Cognitive Exoskeleton
Open Sourceimperalcloud/imperal-mcpSnap one Exoskeleton onto every AI agent you run.
Install imperal-mcp on Claude, GPT / Codex, and Gemini so they work with Webbee as one synchronized mechanism under the ICNLI protocol.
$ pipx install 'imperal-mcp[code]' && imperal-mcp setup
✓ Linked to Imperal Tenant Vault (AES-256-GCM · Ed25519)
✓ Wired 34 Exoskeleton tools (15 MCP tools · 4 namespaces) into Claude Code, Cursor & Codex CLIICNLI Protocol Orchestration · Multi-Model Super-Team
Claude + GPT + Gemini + Webbee: one Ultra-Brain under protocol.
Install imperal-mcp on Claude, wire it into GPT / Codex, and snap it onto Gemini. Because every agent communicates through the ICNLI protocol, they stop acting like disconnected bots: they share one live code graph, eliminate duplicate token burn, and form a single Super-Team where Webbee, Claude, or any brain you pick can command the entire orchestra.
ICNLI Exoskeleton OrchestraWebbee coordinates Claude, GPT & Gemini over one shared ICNLI state matrix.
live_sessions() -> synced 3 agents · 0 duplicate file reads34 Exoskeleton tools · 15 MCP tools · 6 core faculties
What your agent gains the second you plug it in.
In plain language: standalone coding agents forget context between sessions, burn tokens re-reading files blind, and cannot safely touch your servers. The Imperal Exoskeleton fixes all six layers at the protocol level (33 tools run $0 locally; 1 tool syncs your encrypted Cloud Vault).
Live AST Code Graph
orient · graph_slice · outline · read_symbol · impact_of_change
Stop burning context windows on blind file reads. The Exoskeleton maps every function, class, caller, and downstream dependency across multi-repo workspaces so your agent edits with surgical precision.
Shared Cross-Agent Vault Memory
recall · remember · scope_recall · vault_log_read
Cure AI amnesia across tools. Architectural rules, precedents, and findings discovered in Claude Code or Cursor are immediately available to Webbee in your Web Panel and Telegram.
300+ Cloud Apps & SSH Mesh
conn-ssh · load_app_tools · marketplace connectors
Give any local coding agent governed hands across your connected SSH servers, databases, Stripe, GitHub, analytics, and mail - brokered through Imperal Cloud without scattering raw API keys on disk.
Live Multi-Agent Session Mesh
live_sessions · message_session · state_lens
See every active AI session running across your terminals, IDEs, and cloud surfaces in real time. Agents can inspect sibling sessions and coordinate work so two agents never overwrite each other.
Defensive PII Scrubbing & Consent
defensive_scrub · Propose -> Confirm -> Execute
Sensitive secrets and PII are scrubbed locally before leaving your workspace. Read operations run fast; consequential writes and remote server commands raise an explicit confirmation gate.
Checkpoint & Blast-Radius Guard
impact_of_change · checkpoint · diff · rollback
Before modifying shared symbols, your agent verifies every downstream caller. Every mutation is backed by local reversibility checkpoints and a crypto-signed audit trail.
Open Source Core · Honest Economics
33 of 34 tools are free forever.
The code map, symbol reader, blast-radius analyzer, and checkpoints run locally on your machine for $0, offline and without an account. Only frame (shared Cloud Vault memory and the Kernel Referee) spends credits.
Local Exoskeleton (No Account Required)
Install pipx install 'imperal-mcp[code]' and use the local code graph, surgical symbol reader, blast-radius check, and rollback checkpoints free forever. Plus 10,000 free cloud credits when you run imperal-mcp login.
Cloud Vault + Kernel Referee + 300+ Connectors
Unlocks frame across every surface: shared encrypted memory between Claude Code, Cursor, Codex, Gemini CLI, Web Panel, and Telegram, real-time hallucination interception, and 300+ governed cloud extensions.
| Capability & Exoskeleton Tools | Free (Local & Open Source) | Paid (Cloud Vault & Referee) |
|---|---|---|
Live AST Code Graph & Surgical Reads orient · repo_profile · outline · read_symbol · search_code · graph_slice | Included ($0 · Local SQLite) | Included + Cross-Repo Cloud Sync |
Blast-Radius Check Before Edits impact_of_change | Included ($0 · Offline) | Included + Multi-Service Graph |
Invisible Checkpoints & 1-Call Undo checkpoint · diff · rollback | Included ($0 · Local History) | Included + Signed Audit Trail |
Visual Layout & Screen Inspector inspect_screen | Included ($0 · Local Browser) | Included |
Defensive PII & Secret Scrubber Local pre-flight scrubber | Included (Runs on your machine) | Included (Scrubbed before cloud) |
Cross-Agent Encrypted Vault Memory frame · recall · remember · scope_recall · state_lens | Local session only | Full Cloud Vault (AES-256-GCM) |
Kernel Referee & Hallucination Gate KERNEL FACTS · NAMED BUT NOT FOUND · Proof-of-Done | Local tool verification | Full Pre-Flight & Final Answer Referee |
Multi-Agent Team & Live Coordination live_sessions · message_session | Single local session | Real-Time Sibling Agent Mesh |
300+ Cloud Connectors & SSH Fleet conn-ssh · load_app_tools · Consent Gates | Local workspace tools | 300+ Governed Apps & SSH Broker |
imperal-mcp setup --removeZero boilerplate · 60-second setup
Three commands from isolated bots to one brain.
Install the package
Works with Python 3.7+, pipx, or uvx imperal-mcp.
Authenticate your Vault
Links your terminal to your encrypted Imperal Tenant Vault in one browser click.
Snap onto every agent
Auto-detects and configures Claude Code, Codex CLI, Antigravity CLI, and Gemini CLI.
FAQ · Imperal Exoskeleton
Questions engineers ask before plugging in.
- What is imperal-mcp (the Imperal Exoskeleton)?
- imperal-mcp is Imperal Cloud's open Model Context Protocol (MCP) server and cognitive exoskeleton. In one command, it snaps onto Claude Code, Cursor, OpenAI Codex CLI, Google Gemini CLI, Windsurf, or any MCP-compatible agent - giving that agent a live AST code graph, shared Tenant Vault memory, 300+ Imperal Cloud apps, and governed SSH server execution.
- Which AI coding agents and IDEs work with imperal-mcp?
- Out of the box, imperal-mcp supports Claude Code, Cursor, Windsurf, OpenAI Codex CLI, Google Gemini CLI, Webbee Code, and any desktop or custom agent that speaks the standard Model Context Protocol (stdio or SSE).
- How does the live code graph reduce token usage?
- Instead of reading entire 2,000-line files blind, your agent calls orient, repo_profile, search_code, graph_slice, outline, read_symbol, and impact_of_change. The Exoskeleton indexes symbols, call graphs, and downstream dependents so the agent reads only the exact functions that matter - cutting token consumption by 3-5x.
- How does shared memory work across different AI agents?
- Every fact, architectural rule, and session finding is synced to your isolated Imperal Tenant Vault (encrypted at rest with AES-256-GCM). When you switch from Claude Code in the terminal to Cursor, Telegram, or Webbee in the Imperal Panel, every agent recalls the exact same project context without re-prompting.
- Is my source code or private data exposed when using imperal-mcp?
- No. imperal-mcp runs a local defensive PII and secret scrubber before telemetry or memory leaves your machine, enforces Propose -> Confirm -> Execute on consequential cloud actions, and records every tool call in an Ed25519 + SHA-256 hash-linked audit ledger.
- How do I install and authenticate imperal-mcp?
- Run pipx install 'imperal-mcp[code]' (or uv tool install 'imperal-mcp[code]'), authenticate once with imperal-mcp login, and run imperal-mcp setup to automatically wire your local MCP configuration for Claude Code, Cursor, Windsurf, Codex, and Gemini CLI.
Ready to give your team a real superpower?
Every step is grounded in kernel facts, every write waits for your approval, and every change can be rolled back in one click. Inspect the full architecture or start free in seconds.
Launch your AI brain extension out of the box
Connect 300+ apps, servers, and databases in one click over encrypted channels - or seat your own Claude, GPT, or Gemini key.
33 of 34 Exoskeleton tools (local AST graph & shadow-git checkpoints) run $0 free forever on your machine; connect the cloud Vault whenever you want shared memory.
No black box. No lock-in. No action without your yes.