Start here. Returns whether hive is running, the open project (name, folder), object counts, the camera and the visible board area (board units) and the current selection. When hive is closed the result has offline:true and only read tools work.

Every node kind hive supports (note, beacon, list, tierlist, goal, calendar, …) with a description, default width, whether it has a Markdown body, and its kind-specific data fields; plus the allowed values for importance, purposes, moods, link kinds and shapes, and the Markdown syntax hive renders. Call before creating anything other than plain notes. Needs hive running.

List nodes with filters (kind, zone, task state, text query, rectangle, linked to a node) and paging. Returns short summaries with a 160-character text preview; use get_nodes for full text. Coordinates are board units, x/y = top-left, y grows downward.

Full data of up to 50 nodes by id or exact name: every stored field, the complete Markdown text, effective size, links (with the other node's name) and zone.

Search node names, kinds and text with hive's own Search ranking (name matches first). Returns ids, names and a snippet around the match.

Create one or many nodes (any kind) and optionally link them, in ONE undoable step (Ctrl+Z in hive removes the whole batch). Nodes get the same defaults as hive's Q menu. Placement: explicit x/y, else near another node, else automatic placement from origin (default: centre of the visible area) using layout, never overlapping existing nodes. Use ref to link nodes created in the same call (e.g. a mind map: layout "tree" + links from the root). Returns the final ids, names and positions.

Change existing nodes in ONE undoable step: rename, replace or precisely edit the Markdown text (find/replace that must match exactly once, append, prepend), move/resize, colours, glow, header, task state, importance, purposes, moods, zone, kind-specific data. Only the fields you pass change.

Delete nodes exactly like the Delete key in hive: they go to the Trash (restorable with restore_from_trash) together with their links. mode "archive" archives instead. One undoable step.

Set exact top-left positions (board units) of nodes. One undoable step.

Lay out existing nodes as a row, column, grid, tree (by their links) or circle starting at origin (default: their current top-left). One undoable step.

All lines between nodes, or only those touching nodeId, with both node names.

Draw lines between existing nodes (strong = arrow from → to, weak = dashed). hive's linking rules apply (e.g. beacons only have outgoing links); a refused link explains why. One undoable step.

Change kind or shape of existing links. One undoable step.

Remove links by id (nodes stay). One undoable step.

Zones (coloured areas that group nodes) with their rectangles and member node ids.

Create a zone either from an explicit rectangle or around a set of nodes with padding. One undoable step.

Rename, recolour or move/resize a zone. One undoable step.

Delete zones; their nodes stay on the board. One undoable step.

Add a file from disk to the project exactly like dropping it on the board: it is copied into the project folder (big videos above the user's threshold are linked instead) and becomes an image, GIF, PDF, audio, video, text/code (format) or source node. Use an absolute path.

Entries in the project's Trash (deleted nodes) that restore_from_trash can bring back.

Archived nodes of the project.

Restore Trash entries by id (as listed by list_trash) to their old place, with their links. One undoable step.

Move hive's camera so the given nodes (or rectangle) are visible — use after creating something so the user sees it. Not an undo step.

Undo the most recent change in hive. By default only undoes changes made through this MCP server (entries labelled "MCP: …") and refuses if the user changed something since.

Write all pending changes to the project folder immediately (hive also saves automatically).