universal-context-mcp
The universal-context-mcp server is a context preservation engine that enables lossless AI agent session handoffs by saving and restoring project state, architectural intent, and work focus.
Export Session Context (
export_session_context): Aggregates your current project state — including environment metadata, directory structure, git diffs, commit history, and core project files — into a snapshot saved to a local ledger (.session_checkpoints.jsonl) and copied to your clipboard. Optionally include a handoff message describing your current intent or blockers, and optionally sync to the cloud via a private GitHub Gist for cross-machine portability.Bootstrap Session Context (
bootstrap_session_context): Loads the latest saved "Shadow Context" from the local ledger, allowing a new AI agent session to instantly resume exactly where the previous session left off — with full awareness of prior architectural decisions, focus areas, and blockers — eliminating the need for re-discovery or re-explanation.
Allows secure upload of context to private GitHub Gists for cloud portability between machines
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., "@universal-context-mcp save my current project context to clipboard"
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.
📦 Universal Context MCP
The God-Tier Context Preservation Engine for AI Agents
Zero knowledge loss when transitioning between sessions, environments, or agents.
🎯 The Problem
You start a new session with an AI agent (Claude, Gemini, etc.). It spends the first 20 minutes reading files, guessing your architecture, and asking questions you already answered yesterday.
Related MCP server: promem-mcp
⚡ The Solution
Universal Context MCP creates a lossless context bridge. It bundles your project state, uncommitted changes, and architectural intent into a high-density package that "re-animates" any new agent instantly.
✨ Features
🏎️ Zero-Touch Setup: One command auto-configures your global Claude/CLI environment.
🧠 Auto-Bootstrapping: Agents automatically load the previous session's exact focus and blockers.
🕰️ Session Time Machine: A local
.session_checkpoints.jsonlledger tracks the evolution of your project decisions.⚖️ Precision Token Budgeting: Calculates exact context pressure to prevent agent degradation.
☁️ Cloud Sync: Securely upload context to private GitHub Gists for global cross-machine portability.
📦 Installation
# 1. Install the engine globally
npm install -g universal-context-mcp
# 2. Auto-configure your CLI/Agent environment
context-save --setup(The setup command automatically injects the MCP server into your global .claude.json or equivalent).
🛠 Usage
1. Manual Export (The "Save State")
Run this in any project root to grab a high-density snapshot and copy it directly to your clipboard:
context-save "Brief description of current focus or blockers"2. Cloud Export (Cross-Machine)
Moving from your desktop to your laptop? Use a secure GitHub Gist:
context-save "Moving to home laptop" --cloud3. Agentic Handoff (The "Auto-Bootstrap")
Add this Ironclad Mandate to your project's CLAUDE.md or GEMINI.md:
## Core Mandates
- **Auto-Bootstrap:** At the start of EVERY new session, you MUST immediately call `bootstrap_session_context` to load the previous architectural intent and focus.When a new agent boots up, it will read this rule, call the MCP tool, and instantly resume your work exactly where you left off.
4. The Autopilot Hook (Zero-Effort Background Sync)
Never forget to save context again. Run this once per project to install a Git hook that silently updates your context in the background every time you commit:
context-save --install-hook5. Debug Mode
If you need to trace execution speed, path resolution, or token count math, use the debug flag:
context-save --debug🏗 How It Works Under The Hood
When invoked, the exporter intelligently bundles:
Environment: OS and Path.
Shadow Context: The manual intent or handoff note.
Active Changes: A lightweight
git diff --stat.Structure: A depth-limited, noise-filtered directory tree.
History: The last 5
git logentries.Core Files: Automatic injection of
README.md,CLAUDE.md,package.json, etc.
Available Tools
2 toolsbootstrap_session_contextA
LOAD context: Fetches the latest 'Shadow Context' from the ledger to resume work perfectly.
Inputs: no named parameters.
export_session_contextB
SAVE context: Aggregates project metadata, tree, diffs, and mental model to clipboard and ledger.
Inputs: handoff_message, cloud_sync.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one loads context, the other saves context. There is no functional overlap.
Both tools follow a consistent verb_noun pattern using snake_case, with 'bootstrap' and 'export' as clear verbs and 'session_context' as the common noun.
With only two tools, the server feels minimal. While it covers the core load/save operations, a broader scope might include additional tools for listing or managing contexts.
The tool set provides basic load and save capabilities, but lacks operations for initializing, deleting, or listing contexts, leaving minor gaps in lifecycle coverage.
Maintenance
Related MCP Connectors
Shared project context for AI agents and teams: docs, tasks, and messages that stay current.
Universal memory for AI agents and tools. Save, organize and search context anywhere.
Project memory for every AI. Pick up where you left off in Claude, ChatGPT or Cursor, with a team.
The context platform for AI agents: code search, team decisions, and grounded project context.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI coding agents to persist structured long-term memory (gotchas, architecture, API notes) in a .context folder and sync across devices and agents via Git.413 npm20MIT
- AlicenseBqualityCmaintenanceEnables AI coding agents to maintain persistent project context, including rules, decisions, environment intelligence, and Git history, using a local-first MCP server with automatic project detection and token-efficient retrieval.13MIT
- AlicenseBqualityCmaintenanceEnables AI coding agents to persist, share, and retrieve project context locally via plain-text files, with support for capturing, packing, searching, and importing transcripts without external services.4MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI coding agents to retain and recall project context across sessions through local Markdown storage and hybrid keyword/semantic retrieval, including reusable knowledge cards. It runs offline as a daemon and integrates with MCP-compatible IDEs to continue long-running work without re-explaining decisions or architecture.326 npm12MIT