nodeslate

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.

Parameters
source stringrequired
The diagram, in the chosen format.
title string
Its name in the list of diagrams.
format string
lines, mermaid or sql. Default mermaid. See Diagram source.
type string
auto (default), flowchart, mind_map, architecture, entity_relationship, org_chart, journey or sequence. Set it whenever you know it: with lines, auto draws a flowchart.
folder string
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.

Parameters
id stringrequired
The diagram's id or link.
source stringrequired
The diagram to add.
title string
Its name on the canvas.
format string
lines, mermaid or sql. Default mermaid. See Diagram source.
type string
auto (default), flowchart, mind_map, architecture, entity_relationship, org_chart, journey or sequence. Set it whenever you know it: with lines, auto draws a flowchart.

read_diagram

Reads what's on a canvas as text: each diagram's title, boxes, connections, components and tables (with columns).

Parameters
id stringrequired
The diagram's id or link.

list_diagrams

Lists diagrams where the key works, newest first, optionally matching words in titles and box text.

Parameters
query string
Words to match.
limit integer
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.

Parameters
diagrams string[]
Ids or links of the diagrams this code is drawn in.
folder string
A folder whose diagrams belong to this code, and where new ones go.
current string
.nodeslate/config.json as 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.

Parameters
config string
.nodeslate/config.json as it is. Pulls every diagram it lists.
diagrams string[]
Only these, by title in .nodeslate/config.json, id or link.
have object
Diagram id → the revision the repository holds, from each file's nodeslate header.

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.

Parameters
id stringrequired
The diagram's id or link.
title stringrequired
One line, such as “Add a session cache”.
source stringrequired
The change (edit), the whole diagram (replace), or a new diagram (add).
mode string
edit (default, small changes), replace or add.
format string
lines, mermaid or sql. Default lines. See Diagram source.
description string
Why, and what changes. Mention the pull request.
diagram string
Which diagram on the canvas, by title. The first if left out; the new one's name for add.
type string
For add: the new diagram's type.
reviewers string[]
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.

Parameters
id stringrequired
The diagram's id or link.
number integerrequired
The change request's number.
source string
More changes.
title / description string
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.

Parameters
id stringrequired
The diagram's id or link.
number integerrequired
The change request's number.
body stringrequired
The comment.
reply_to string
A thread's id from read_change_request.
box string
A box's name to pin the comment to.

Stuck, or missing something? Contact us.