
Understanding Graph
Think git for AI cognition. Every mutation flows through `graph_batch` with a commit message, wrapped in SQLite transactions that roll back atomically on failure. Nodes are never deleted, only superseded via typed edges. The API exposes `graph_skeleton` for orientation, `graph_semantic_search` for retrieval, and `graph_history` to read what other agents did recently. Multiple agents coordinate through stigmergy: they read the graph, add reasoning nodes (tensions, surprises, decisions), and leave traces for the next session. Cross-project references via `graph_add_reference` let you build hierarchies across projects. Ships with Claude Code skills, optional embedding search via transformers, and a 3D web UI. Reach for this when you need agents to remember not just facts but how they arrived at conclusions.
- GitHub stars
- 1
- tools
- 63
- transport
- STDIO
- last updated
- Oct 29, 2026
Tools
63 toolsPublic tool metadata for what this MCP can expose to an agent.
graph_batchExecute multiple operations as an atomic commit with a required commit_message.
Execute multiple operations as an atomic commit with a required commit_message.
No parameter schema in public metadata yet.
graph_add_understandingAdd new concept with duplicate detection
Add new concept with duplicate detection
No parameter schema in public metadata yet.
graph_questionCreate question node for exploration
Create question node for exploration
No parameter schema in public metadata yet.
graph_reviseUpdate concept understanding
Update concept understanding
No parameter schema in public metadata yet.
graph_supersedeReplace outdated concept
Replace outdated concept
No parameter schema in public metadata yet.
graph_add_referenceAdd external/cross-project references
Add external/cross-project references
No parameter schema in public metadata yet.
graph_renameRename node (updates soft references)
Rename node (updates soft references)
No parameter schema in public metadata yet.
graph_archiveSoft-delete preserving history
Soft-delete preserving history
No parameter schema in public metadata yet.
node_set_metadataSet arbitrary metadata on nodes
Set arbitrary metadata on nodes
No parameter schema in public metadata yet.
node_get_metadataRetrieve node metadata
Retrieve node metadata
No parameter schema in public metadata yet.
node_set_triggerChange node classification
Change node classification
No parameter schema in public metadata yet.
node_get_revisionsGet understanding evolution history
Get understanding evolution history
No parameter schema in public metadata yet.
graph_connectCreate edges between concepts
Create edges between concepts
No parameter schema in public metadata yet.
graph_answerRecord answer to a question node
Record answer to a question node
No parameter schema in public metadata yet.
graph_disconnectRemove/archive edges
Remove/archive edges
No parameter schema in public metadata yet.
edge_updateUpdate edge type or explanation
Update edge type or explanation
No parameter schema in public metadata yet.
edge_get_revisionsGet relationship history
Get relationship history
No parameter schema in public metadata yet.
graph_understandCompose a workflow-specific re-entry packet with priors, resistance, evidence, and typed relations
Compose a workflow-specific re-entry packet with priors, resistance, evidence, and typed relations
No parameter schema in public metadata yet.
graph_skeletonStructural overview (~150 tokens)
Structural overview (~150 tokens)
No parameter schema in public metadata yet.
graph_contextFull graph XML, optionally focused on one node; auto-compacts above 50 nodes
Full graph XML, optionally focused on one node; auto-compacts above 50 nodes
No parameter schema in public metadata yet.
graph_context_regionFull details for one numbered region returned by context, skeleton, or search
Full details for one numbered region returned by context, skeleton, or search
No parameter schema in public metadata yet.
graph_semantic_searchFind nodes by meaning
Find nodes by meaning
No parameter schema in public metadata yet.
graph_similarFind conceptually similar nodes
Find conceptually similar nodes
No parameter schema in public metadata yet.
graph_find_by_triggerFind nodes by type
Find nodes by type
No parameter schema in public metadata yet.
graph_analyzeFind structural gaps, cycles, bridges, open questions, and serendipity nodes
Find structural gaps, cycles, bridges, open questions, and serendipity nodes
No parameter schema in public metadata yet.
graph_semantic_gapsFind disconnected concepts
Find disconnected concepts
No parameter schema in public metadata yet.
graph_scoreStructural proxy for chronology, revision, resolution, edge specificity, and connectivity—not semantic quality
Structural proxy for chronology, revision, resolution, edge specificity, and connectivity—not semantic quality
No parameter schema in public metadata yet.
graph_pathReasoning path between concepts
Reasoning path between concepts
No parameter schema in public metadata yet.
graph_centralityMost influential concepts
Most influential concepts
No parameter schema in public metadata yet.
graph_thermostatAdvisory entropy-style pulse for convergence, continuation, or divergence
Advisory entropy-style pulse for convergence, continuation, or divergence
No parameter schema in public metadata yet.
graph_historyCommit history and changes
Commit history and changes
No parameter schema in public metadata yet.
graph_bisociateSurface candidate cross-context pairs with spreading activation and information gain
Surface candidate cross-context pairs with spreading activation and information gain
No parameter schema in public metadata yet.
graph_discover_groundedDefault bounded comparison of distant graph material; no connection is valid
Default bounded comparison of distant graph material; no connection is valid
No parameter schema in public metadata yet.
graph_discover_grounded_chaosOptional dictionary perturbation after a genuine grounded bridge; requires a host-installed word list
Optional dictionary perturbation after a genuine grounded bridge; requires a host-installed word list
No parameter schema in public metadata yet.
graph_discoverExplicitly speculative blind ANI over graph material
Explicitly speculative blind ANI over graph material
No parameter schema in public metadata yet.
graph_randomConcrete random provocations, including optional scrutinized Physics What-If forcing
Concrete random provocations, including optional scrutinized Physics What-If forcing
No parameter schema in public metadata yet.
graph_serendipityBatch-only: record a synthesis with source edges
Batch-only: record a synthesis with source edges
No parameter schema in public metadata yet.
graph_validateBatch-only: record an authored validation judgment for a scrutinized serendipity
Batch-only: record an authored validation judgment for a scrutinized serendipity
No parameter schema in public metadata yet.
graph_chaosInject words from a machine-local dictionary or graph nodes into text
Inject words from a machine-local dictionary or graph nodes into text
No parameter schema in public metadata yet.
graph_decideBatch-only: record a typed decision over options
Batch-only: record a typed decision over options
No parameter schema in public metadata yet.
graph_evaluate_variationsRank alternatives with the experimental Novelty Score
Rank alternatives with the experimental Novelty Score
No parameter schema in public metadata yet.
doc_createCreate document with content
Create document with content
No parameter schema in public metadata yet.
doc_reviseModify document text
Modify document text
No parameter schema in public metadata yet.
doc_insert_thinkingsynthetic_reader only: insert a reconstructed Reader/CMP pretraining block
synthetic_reader only: insert a reconstructed Reader/CMP pretraining block
No parameter schema in public metadata yet.
doc_append_thinkingsynthetic_reader only: append a reconstructed Reader/CMP pretraining block
synthetic_reader only: append a reconstructed Reader/CMP pretraining block
No parameter schema in public metadata yet.
source_loadLoad text for staged reading
Load text for staged reading
No parameter schema in public metadata yet.
source_readRead next portion, auto-create nodes
Read next portion, auto-create nodes
No parameter schema in public metadata yet.
source_positionGet reading progress
Get reading progress
No parameter schema in public metadata yet.
source_listList loaded sources
List loaded sources
No parameter schema in public metadata yet.
source_exportReconstruct exact source text; synthetic_reader may additionally export its reserved Reader/CMP blocks
Reconstruct exact source text; synthetic_reader may additionally export its reserved Reader/CMP blocks
No parameter schema in public metadata yet.
project_switchSwitch active project
Switch active project
No parameter schema in public metadata yet.
project_listList available projects
List available projects
No parameter schema in public metadata yet.
graph_lookup_externalLook up node in another project
Look up node in another project
No parameter schema in public metadata yet.
graph_list_externalList accessible external projects
List accessible external projects
No parameter schema in public metadata yet.
graph_find_by_referenceFind nodes referencing a concept
Find nodes referencing a concept
No parameter schema in public metadata yet.
graph_resolve_referencesVerify cross-project references
Verify cross-project references
No parameter schema in public metadata yet.
graph_global_lookupSearch across all projects
Search across all projects
No parameter schema in public metadata yet.
solver_spawnRegister specialized solver agent
Register specialized solver agent
No parameter schema in public metadata yet.
solver_delegatePost task to solver queue
Post task to solver queue
No parameter schema in public metadata yet.
solver_claim_taskClaim pending task (worker mode)
Claim pending task (worker mode)
No parameter schema in public metadata yet.
solver_complete_taskSubmit task results
Submit task results
No parameter schema in public metadata yet.
solver_listList registered solvers
List registered solvers
No parameter schema in public metadata yet.
solver_queue_statusTask queue statistics
Task queue statistics
No parameter schema in public metadata yet.
Sponsors
Readme
Understanding Graph: A Persistent Medium for Recursive Understanding
A persistent medium for recursive, inspectable understanding.
Details
- Repository
- github.com/emergent-wisdom/understanding-graph
- Website
- github.com/emergent-wisdom/understanding-graph
- Category
- Automation & Workflows
- Package
understanding-graph- Transport
- STDIO
- Registry
- MCP registry, active