MCP tools
The ideagraphs MCP server: eight tools that let Claude and ChatGPT read and write a typed graph of your notes, files and conversations.
There are no type-specific tools, because the types are yours to invent. These eight read and write everything. Every tool declares its effect through MCP annotations, so a client can tell a read from a write before it calls one.
Two habits make the difference between a cheap session and an expensive one: walk the graph with neighborhood rather than reading one object at a time, and stay at stub detail until you have decided what is worth reading in full.
The tools
- Find objects and list a space
queryFind objects: entry points into the graph, and the contents of a space. - Read objects in one batch
readRead specific objects from the graph by URN, in one batch. - Walk the graph outward
neighborhoodWalk the graph outward from one object and get the subgraph back in a single call. - Find the space a person is working in
whereWhere this person is working, and which views are in that space right now. - Write datoms as one changeset
writeWrite to the graph: a list of assert and retract datoms applied as ONE changeset. - Show where you are about to write
place_cursorSay where you are about to write, so a person editing the same document can see you. - List unresolved conflicts
conflictsList the unresolved conflicts on objects in a space. - Settle one conflict
resolveSettle one conflict, naming it explicitly.