List every Mapache board (mind maps and whiteboards). Start here: it returns one line per board with its title, id, folder, number of nodes, items and open comments, last change, and which board is open in the app, plus the list of folders. Read-only. Use read_board next to see a board's content, or search_boards to find text across boards.

Read a whole board. Returns its mind maps as indented outlines, then its notes, shapes, tables, charts, connectors, images and open comments, each with the id the editing tools need (to see what the images show, use view_images). Read-only. Call it before changing a board you have not read in this conversation; use list_comments for the full comment threads.

See the images placed on a board (screenshots, slides, photos, diagrams), so you can read and describe what they show; read_board only lists them. Returns each image as image content, preceded by its id, position and size, in reading order (top to bottom, then left to right). Read-only. Pass item ids from read_board to see specific ones; without ids it returns the first ones up to the limit, and tells you which ids remain so you can ask for them in the next call.

Search text across all boards: titles, mind map nodes, notes, shapes, tables, sections, connector labels and comments. Case and accents are ignored. Returns, for each board with matches, its title and id and up to 30 hits with their ids. Read-only. Use it to find which board talks about something; use read_board to see one board in full.

Create a new board with a mind map. Give an outline to fill it: if the outline has one top line it becomes the central idea; otherwise the title is the central idea and each top line a branch. Always creates a new board (calling it twice makes two). Returns the board id, the central idea id and the address to open it. To add to an existing board use add_nodes, add_mindmap or add_items instead.

Rename a board, move it to a folder, or change its color or icon in the sidebar. Only the fields you pass change; the content of the board is untouched (to edit content use update_nodes or update_items). Returns a confirmation and the board address.

Move a whole board to the trash. It disappears from the app; it can be restored with mapache restore <id>, which the result tells you. Only do this when the person asks. To remove part of a board use delete_nodes or delete_items instead.

Create a folder in the sidebar to organize boards, optionally inside another folder. Always creates a new folder, even if one with the same name exists; returns its id. You rarely need it: create_board and update_board create missing folders by themselves when you pass a folder path.

Add child nodes under an existing node of a mind map, from an indented outline (nested branches) or a flat list of texts. It is saved at once as a new revision of the board and appears live in any browser that has it open (the person can undo it with Ctrl+Z). Returns each new node with its id. Use it to grow a map; use add_mindmap for a separate new map and create_board for a new board.

Change existing mind map nodes: text, branch color, icon, folded state or checkbox. Several nodes in one call; in each update only the fields you pass change. It is saved at once as a new revision of the board and appears live in any browser that has it open (the person can undo it with Ctrl+Z). Returns how many nodes changed. To add nodes use add_nodes, to move them move_node, to remove them delete_nodes.

Move a node, with its whole branch, under another parent (in the same board), or reorder it among its siblings by giving its current parent and a new position. A node cannot go under itself or its own children. It is saved at once as a new revision of the board and appears live in any browser that has it open (the person can undo it with Ctrl+Z). Returns a confirmation.

Delete mind map nodes and every node under them, plus the connectors attached to them (comments pinned to them stay, unpinned). The central idea of the main map cannot be deleted. Only when the person asks; they can undo it in the app with Ctrl+Z. Returns how many nodes were removed. To change a node instead use update_nodes.

Add another, separate mind map to an existing board (a board can hold several). The first line of the outline is its central idea and the indented lines its branches. It is placed in free space unless you give x and y. It is saved at once as a new revision of the board and appears live in any browser that has it open (the person can undo it with Ctrl+Z). Returns the id of its central idea. To grow a map that already exists use add_nodes.

Add sticky notes, text, shapes, sections, stickers, tables, charts or video embeds to a board. They are laid out together in free space unless each has x and y. To chart data, add a table first, then a chart with its id. It is saved at once as a new revision of the board and appears live in any browser that has it open (the person can undo it with Ctrl+Z). Returns each new item with its type and id (use the ids with connect, update_items or a chart's table). For mind map branches use add_nodes instead.

Change existing items (notes, text, shapes, sections, tables, charts, connectors): text, color, position, size, table cells, chart type and more. Several items in one call; in each update only the fields you pass change, and fields that do not apply to that item type are ignored. A wrong color for the type returns an error listing the valid ones. It is saved at once as a new revision of the board and appears live in any browser that has it open (the person can undo it with Ctrl+Z). Returns how many items changed. For mind map nodes use update_nodes.

Delete notes, shapes, tables, charts, connectors or other items, plus the connectors attached to them (comments pinned to them stay, unpinned). Only when the person asks; they can undo it in the app with Ctrl+Z. Returns how many items were removed. For mind map nodes use delete_nodes.

Draw connectors (arrows) between nodes and/or items, optionally with a label, for flowcharts and relations. Several in one call; each call adds new connectors (it does not replace existing ones). The path routes itself around other objects. It is saved at once as a new revision of the board and appears live in any browser that has it open (the person can undo it with Ctrl+Z). Returns how many connectors were added. To change a connector later use update_items with its id.

List the comment threads on a board. Returns, for each thread, its id, author, date, what it is pinned to, its text and its replies, oldest first. Read-only. Use it when the person asks you to review a board or answer comments; then reply_comment and resolve_comment.

Leave a comment on a board, pinned to a node or item ("on", by id or text) or at a point. Write @Name to mention someone from the team. Comments are for talking about the board, not content: they never appear in exports. The comment is signed with your agent name and shows up live for everyone. Returns the comment id and who was mentioned. Use it to ask or suggest instead of changing the person's work; to answer an existing thread use reply_comment.

Reply in an existing comment thread (find it with list_comments). The reply is signed with your agent name and shows up live. Replying to a resolved comment reopens it. Write @Name to mention someone. Returns which thread you replied to and who was mentioned. To start a new thread use add_comment.

Mark a comment thread as resolved once you have done what it asked, or reopen it with reopen: true. Resolved threads stay on the board, hidden from the open list; nothing is deleted. Returns the comment id. To answer before resolving use reply_comment.

Save a board as a file the person can share: "html" is a single web page anyone can open in a browser (with zoom, no install), "pdf", "png" or "svg". The Mapache app renders it, so it opens in the browser if it is not open yet (and switches to that board). The board itself is not changed; the file never overwrites an existing one (a number is added to the name). Returns where the file was saved and its size.

Open a board in Mapache in the person's browser (starting Mapache if needed), so they can see it; it does not change the board. Returns its address. Offer it after a big change; set launch to false to only get the link.