emergent-wisdom avatar

Understanding Graph

emergent-wisdom/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 tools

Public 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.

Paper DOI npm version MCP Registry License: MIT


View the full README on GitHub

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

More from emergent-wisdom

Related Automation & Workflows MCP servers

View all
1geniuskey avatarMcp Server Xlwingsgeniuskey/mcp-server-xlwingsExcel automation via xlwings COM. DRM-protected files, live sessions, VBA macros. Windows only.1stars
2helbertparanhos avatarPost for Me MCP Prohelbertparanhos/postforme-mcp-proPublish, schedule and analyze social posts across 9 platforms via the Post for Me API.1stars
3polynode-co avatarAntworkpolynode-co/antworkDraft, schedule, and publish social posts for your workspace straight from your AI.1stars
4aruxojuyu665 avatar2Captcha MCParuxojuyu665/2captcha-mcpFull 2Captcha API (43 tools) for Claude Code: 31 captcha solvers + management + webhook.1stars
5orbiads avatarOrbiAds — Google Ad Managerorbiads/orbiads-gam-mcpAutomate Google Ad Manager: campaigns, line items, creatives, inventory, reporting — 51 tools.1stars
6provartesting avatarProvar MCP Serverprovartesting/provardx-cliProvar MCP: AI-powered Salesforce test automation. Generate, validate, migrate, and run tests.1stars