Persistent reasoning memory for AI agents via typed cognitive nodes and supersedes edges.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"understanding-graph": {
"env": {
"PROJECT_DIR": "/path/to/your/projects"
},
"args": [
"-y",
"understanding-graph",
"mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Persistent memory for AI agents. Shared cognition through stigmergy.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'understanding-graph' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked understanding-graph against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in ai-ml
Dynamic problem-solving through sequential thought chains
Persistent memory using a knowledge graph
An autonomous agent that conducts deep research on any data using any LLM providers
🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code / Codex Integration
MCP Security Weekly
Get CVE alerts and security updates for io.github.emergent-wisdom/understanding-graph and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Persistent memory for AI agents. Shared cognition through stigmergy.
Understanding Graph is an MCP server that gives AI agents structured, persistent memory. Unlike knowledge bases that store facts, it stores the reasoning process -- tensions, surprises, decisions, and how beliefs evolved over time. Multiple agents coordinate through the graph itself: each agent reads what others have written, builds on it, and leaves traces for the next -- stigmergy.
| Traditional Memory | Understanding Graph |
|---|---|
| Stores facts | Stores comprehension |
| "User prefers dark mode" | "User switched to dark mode after eye strain -- tension between aesthetics and comfort resolved toward comfort" |
| Flat retrieval | Reasoning trails |
| Forgets context | Preserves the why |
| Single agent | Multi-agent coordination through shared graph |
Core insight: AI agents don't just need to remember facts -- they need to remember how they arrived at conclusions so they can build on previous reasoning. When multiple agents share a graph, they coordinate without direct communication.
Add understanding-graph to Claude Code with one command -- no global install, nothing to clone:
claude mcp add ug -- npx -y understanding-graph mcp
npx -y downloads, caches, and runs the package on first invocation. After this, ug is available as an MCP server in every Claude Code session.
The npm package also ships as a Claude Code plugin — the MCP server plus skills that teach the agent how to use the graph effectively:
# One-time: add the Emergent Wisdom marketplace
claude plugin marketplace add emergent-wisdom/marketplace
# Install the plugin
claude plugin install understanding-graph
For local development:
claude --plugin-dir /path/to/understanding-graph
This gives you the MCP server and 7 skills:
| Skill | Invoke | What it teaches |
|---|---|---|
| orient | /understanding-graph:orient | Read graph state at conversation start |
| quality-check | /understanding-graph:quality-check | Score, analyze, thermostat |
| reading-mode | /understanding-graph:reading-mode | Deep source reading with source_read |
| serendipity | /understanding-graph:serendipity | Inject novelty via grounded/pure serendipity |
| web-ui | /understanding-graph:web-ui | Launch 3D visualization at :3030 |
| graph-workflow | (auto-loaded) | Five laws, batches, edges, triggers, API reference |
| creative-work | (auto-loaded) | Two surfaces: concepts + doc trees |
The MCP server works with any client. The skills are a Claude Code bonus — use whichever fits your setup.
For projects where you want agent teams to share the graph automatically, run the init flow inside the project directory:
cd your-project
npx -y understanding-graph init
This creates:
.claude/settings.local.json -- MCP server config (with agent teams enabled)CLAUDE.md -- Instructions that all agents and teammates follow automaticallyprojects/default/ -- Graph storage directoryNow open Claude Code. Every session (and every agent team