AI tools (MCP)
MCP tools
Every tool the Nodeslate MCP server offers, what it's for and what it takes. Your AI tool picks them; this page is for knowing what it can do.
Diagrams
create_diagram
Makes a diagram from Mermaid, SQL or plain lines and returns its link. It's drawn the first time someone opens it.
sourcestringrequired- The diagram, in the chosen format.
titlestring- Its name in the list of diagrams.
formatstringlines,mermaidorsql. Defaultmermaid. See Diagram source.typestringauto(default),flowchart,mind_map,architecture,entity_relationship,org_chart,journeyorsequence. Set it whenever you know it: withlines,autodraws a flowchart.folderstring- A folder's name or id from
list_folders.
add_to_diagram
Adds another diagram beside what's on a canvas, such as a database next to a flow. On a protected main, people who can't edit it get a change request that adds it instead.
idstringrequired- The diagram's id or link.
sourcestringrequired- The diagram to add.
titlestring- Its name on the canvas.
formatstringlines,mermaidorsql. Defaultmermaid. See Diagram source.typestringauto(default),flowchart,mind_map,architecture,entity_relationship,org_chart,journeyorsequence. Set it whenever you know it: withlines,autodraws a flowchart.
read_diagram
Reads what's on a canvas as text: each diagram's title, boxes, connections, components and tables (with columns).
idstringrequired- The diagram's id or link.
list_diagrams
Lists diagrams where the key works, newest first, optionally matching words in titles and box text.
querystring- Words to match.
limitinteger- 1 to 50, default 20.
list_folders
Shows the workspace the key works in, its folders, and which one new diagrams go to.
Codebases
connect_codebase
Links the codebase to its diagrams. Returns the contents of .nodeslate/config.json (workspace, folder, and each diagram's title and link; no secrets), for the tool to write and the person to commit. See Diagrams in your repo.
diagramsstring[]- Ids or links of the diagrams this code is drawn in.
folderstring- A folder whose diagrams belong to this code, and where new ones go.
currentstring.nodeslate/config.jsonas it is now, to add to it.
pull_diagrams
Gets the latest version of the codebase's diagrams as read-only files: .nodeslate/<name>.json (the exact diagram) and .nodeslate/<name>.md (Mermaid). Diagrams whose revision the repository already has are skipped. Nothing changes in Nodeslate.
configstring.nodeslate/config.jsonas it is. Pulls every diagram it lists.diagramsstring[]- Only these, by title in .nodeslate/config.json, id or link.
haveobject- Diagram id → the revision the repository holds, from each file's
nodeslateheader.
Change requests
propose_change
Proposes a change for review instead of editing: Nodeslate copies the diagram, applies the change and opens a change request. Use it when code changes the design. Read the diagram first and reuse its names, so boxes match.
idstringrequired- The diagram's id or link.
titlestringrequired- One line, such as “Add a session cache”.
sourcestringrequired- The change (edit), the whole diagram (replace), or a new diagram (add).
modestringedit(default, small changes),replaceoradd.formatstringlines,mermaidorsql. Defaultlines. See Diagram source.descriptionstring- Why, and what changes. Mention the pull request.
diagramstring- Which diagram on the canvas, by title. The first if left out; the new one's name for add.
typestring- For
add: the new diagram's type. reviewersstring[]- Email addresses of reviewers with a Nodeslate account.
In edit mode, lines describe only what changed: A -> B: label adds or labels a connection (new names become boxes), a plain name adds a box, remove: Name, remove: A -> B and rename: Old -> New. For a database, send sql with the new or changed tables.
update_change_request
Adds more to an open change request (after review, or to change several diagrams on one canvas in one review). Same mode, format, source and diagram as propose_change; can also change the title and description. Approvals may need giving again.
idstringrequired- The diagram's id or link.
numberintegerrequired- The change request's number.
sourcestring- More changes.
title / descriptionstring- New wording.
list_change_requests
The change requests on a diagram, newest first, with where each review stands.
read_change_request
One change request: what it changes and why, its reviewers and verdicts, whether it can merge, and its comment threads with their ids.
comment_on_change_request
Comments on a change request. With reply_to, answers a reviewer's thread and emails its people; with box, pins a new comment to a box. AI tools can comment and update, but only people approve, merge and resolve.
idstringrequired- The diagram's id or link.
numberintegerrequired- The change request's number.
bodystringrequired- The comment.
reply_tostring- A thread's id from read_change_request.
boxstring- A box's name to pin the comment to.
Stuck, or missing something? Contact us.