nodus

Get a compact summary of the graph: node count, edge count, node types, and most connected nodes. Use this first to understand the graph before fetching details.

List nodes in the current workspace. Returns compact node metadata (id, title, type). Use limit/offset for large graphs.

Get a specific node by ID, including its full content.

Get a node and all its direct connections. Returns the node, its neighbors, and the edges between them. Best way to explore graph structure.

Get a compact adjacency list showing how nodes connect. Returns {nodeId: {title, connections: [neighborTitles]}}. Best for understanding overall topology.

Search nodes by title or content.

Find nodes with no connections. Useful for finding isolated content.

Report how many separate groups the graph falls into, and which nodes are in each. Call this before claiming the graph is connected.

Find leaf nodes (nodes with no outgoing edges/children). These are endpoints in the graph.

Find root nodes (nodes with no incoming edges/parents). These are starting points in the graph.

Find nodes with most connections. Useful for finding central concepts.

Find all nodes with a specific color.

Get edges (connections) between nodes. Use limit/offset for large graphs, or filter by node_id.

List all workspaces; the current one (open in the app) is marked.

Scope this connection to a workspace by id or name. All further reads and writes target that workspace, independent of what is open in the app - multiple connections can work different workspaces in parallel.

Show which workspace this connection is scoped to, if any.

Create a new node in the workspace.

Update an existing node.

Resize a single node.

Resize multiple nodes at once. Useful for normalizing node sizes.

Move multiple nodes at once. Positions are absolute canvas coordinates, not offsets from where a node is now.

Update several nodes at once: title, content or position. Each entry names the node by id and carries only the fields to change.

List edges that connect the same pair of nodes more than once, grouped by pair. Reports only; removes nothing.

Remove duplicate edges, keeping one edge per connected pair. Use get_duplicate_edges first to see what would go.

Set the color theme of a node.

Set colors for multiple nodes at once.

Delete a node from the workspace.

Create an edge (connection) between two nodes.

Update an existing edge.

Delete an edge from the workspace.

Create multiple edges at once. Efficient for connecting many nodes.

Delete multiple edges at once.

Delete all edges connected to a node. Useful for breaking up hub nodes before reorganizing.

Arrange nodes in a circle around a center node. Great for creating category layouts.

List all frames in the workspace. Frames are visual containers for grouping related nodes spatially on the canvas (e.g., by topic, project, or category).

Get a specific frame by ID, including its position, size, and color.

Create a frame to visually group nodes. Frames are rectangular containers that help organize the canvas spatially. Use them to create topic areas, project sections, or category groups.

Update frame properties (title, position, size, or color).

Delete a frame. Nodes inside are not deleted, they just become unframed.

Get all nodes assigned to a frame.

Assign a node to a frame and move it inside the frame bounds. The node will move with the frame when dragged.

Remove a node from its frame. The node stays in place but is no longer grouped.

Assign multiple nodes to a frame at once. Nodes outside the frame are moved inside and stacked vertically.

Move multiple frames at once. Nodes assigned to each frame move with it.

Resize multiple frames at once. Nodes are pulled inside if they would be outside.

Resize a frame to fit all its assigned nodes with padding. Resolves overlaps with other frames.

Resize all frames to fit their contents and resolve overlaps.

Check if any frames overlap with each other. Returns pairs of overlapping frames.

Automatically resolve frame overlaps by pushing frames apart horizontally.

List all storylines. Storylines are ordered sequences of nodes that form a narrative path or reading order through the graph (e.g., argument flow, timeline, chapter order).

Get a storyline by ID, including its title, description, and color.

Get the ordered list of nodes in a storyline.

Create a storyline to define an ordered path through nodes. Use storylines for reading orders, argument progressions, timelines, or any linear narrative. Nodes are connected by edges automatically.

Update storyline properties (title, description, or color). Color changes apply to all edges in the storyline.

Delete a storyline. Nodes are not deleted, but the storyline edges are removed.

Add a node to a storyline. By default, adds to the end. Use position to insert at a specific index. Edges are created automatically.

Remove a node from a storyline. Adjacent nodes are reconnected automatically.

Reorder all nodes in a storyline. Provide the complete list in the desired order. Edges are recreated automatically.

Get the current canvas viewport position and zoom level.

Focus the canvas on a specific node.