Create and edit collaborative architecture diagrams with any AI assistant using the Trident 2D DSL.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Adds a text annotation to a live Trident document. Two visual styles: style:stickyNote (default — post-it card with colored background, good for notes/callouts) or style:textBody (plain transparent text, good for diagram titles and section labels). Ideal for architectural notes, decision records, section labels, or TODO markers. Appears immediately for all collaborators. Requires a valid editor access token.
Editor access token for this document.
YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot.
Annotation definition
First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]".
Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Adds a text annotation to a live Trident document. Two visual styles: style:stickyNote (default — post-it card with colored background, good for notes/callouts) or style:textBody (plain transparent text, good for diagram titles and section labels). Ideal for architectural notes, decision records, section labels, or TODO markers. Appears immediately for all collaborators. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| annotation* | object | Annotation definition |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
{
"type": "object",
"required": [
"token",
"agentId",
"annotation"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"annotation": {
"type": "object",
"required": [
"id",
"content",
"x",
"y"
],
"properties": {
"x": {
"type": "number",
"description": "X position in diagram units"
},
"y": {
"type": "number",
"description": "Y position in diagram units"
},
"id": {
"type": "string",
"description": "Unique ID (no spaces, e.g. \"note_observability\")"
},
"bold": {
"type": "boolean",
"description": "Optional: bold text"
},
"align": {
"type": "string",
"description": "Optional: text alignment — \"left\", \"center\", or \"right\""
},
"color": {
"type": "string",
"description": "Optional: background color (hex or color name)"
},
"style": {
"type": "string",
"description": "Optional: \"stickyNote\" (default, post-it card look) or \"textBody\" (plain transparent text, good for titles/labels)"
},
"width": {
"type": "number",
"description": "Optional: width in diagram units (default auto)"
},
"height": {
"type": "number",
"description": "Optional: height in diagram units (default auto)"
},
"italic": {
"type": "boolean",
"description": "Optional: italic text"
},
"content": {
"type": "string",
"description": "Text content. Use \\n for line breaks."
},
"fontSize": {
"type": "number",
"description": "Optional: font size in points"
},
"textColor": {
"type": "string",
"description": "Optional: text color"
},
"underline": {
"type": "boolean",
"description": "Optional: underlined text"
},
"outlineColor": {
"type": "string",
"description": "Optional: border color"
},
"strikethrough": {
"type": "boolean",
"description": "Optional: strikethrough text"
}
},
"description": "Annotation definition"
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}Adds a connection (arrow/edge) between two nodes or containers in a live Trident document. Use get_document_summary to get valid source and target IDs before calling this. Requires a valid editor access token. For ERD relationships, connect the two TABLE containers (field rows are rejected as endpoints) and set type to an ERD pair such as "one_to_many".
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| connection* | object | |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
{
"type": "object",
"required": [
"token",
"agentId",
"connection"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"connection": {
"type": "object",
"required": [
"source",
"target"
],
"properties": {
"id": {
"type": "string",
"description": "Optional: unique ID; auto-generated if omitted"
},
"type": {
"type": "string",
"description": "Optional: connection type. Line styles: \"arrow\" (default), \"line\", \"thick_arrow\", \"dashed_arrow\", \"dotted_arrow\", \"wave\" (avoid unless the user asks for it: renders as a thick ribbon that hides labels). ERD relationship pairs \"<source>_to_<target>\", each end one of one | many | zero_or_one | zero_or_many | one_or_many — e.g. \"one_to_many\", \"one_to_zero_or_many\", \"many_to_many\", \"one_to_one\". ERD pairs are solid lines with crow's-foot markers at each end."
},
"label": {
"type": "string",
"description": "Optional: label shown on the connection"
},
"source": {
"type": "string",
"description": "ID of the source node"
},
"target": {
"type": "string",
"description": "ID of the target node"
},
"routingMode": {
"type": "string",
"description": "Optional: routing algorithm: \"straight\" (default), \"bezier\", or \"orthogonal\". Avoid \"orthogonal\" unless the user asks for it: edges on one side of a node share a single port, so right-angle paths overlap."
}
}
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}Adds a new container (group/swimlane) to a live Trident document. Containers visually group related nodes. Use get_document_summary to check existing container IDs before adding to avoid duplicates. Requires a valid editor access token. To build an ERD (entity-relationship diagram), add one container per table with kind:"erd" and an x/y position, then add each field with add_node (container:<table id>, no x/y) — rows are stacked and the table sized automatically — and join TABLES (never rows) with add_connection using an ERD pair type such as "one_to_many".
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| container* | object | |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
{
"type": "object",
"required": [
"token",
"agentId",
"container"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"container": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"x": {
"type": "number",
"description": "Optional: X position (required for kind:\"erd\" — the centre of the table)"
},
"y": {
"type": "number",
"description": "Optional: Y position (required for kind:\"erd\" — the centre of the table)"
},
"id": {
"type": "string",
"description": "Unique ID for the container (no spaces)"
},
"kind": {
"enum": [
"erd"
],
"type": "string",
"description": "Optional: \"erd\" makes this container an ERD table (flat table: the label is the table name, child nodes are its field rows). Omit for a regular container."
},
"color": {
"type": "string",
"description": "Optional: background color (hex or color name)"
},
"label": {
"type": "string",
"description": "Display label for the container header"
},
"width": {
"type": "number",
"description": "Optional: fixed width. Omit width/height to let the container auto-size around its nodes. ERD tables default to 220; their height is managed automatically (28 header + 24 per row), so do not set it."
},
"height": {
"type": "number",
"description": "Optional: fixed height (use with width). Not for ERD tables. If you give a container a fixed size, make sure every node you add to it fits inside, or enlarge it with update_container."
},
"outlineColor": {
"type": "string",
"description": "Optional: border/outline color (hex or color name), e.g. \"#5B7A99\" for a C4 system boundary."
}
}
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}Adds a new node (entity) to a live Trident document. The node appears immediately for all collaborators. Requires a valid editor access token. Before adding nodes: call open_document to understand the diagram layout and pick sensible positions; call get_document_summary to get all existing entity IDs so you can avoid duplicates. IMPORTANT: if this node belongs inside a container, pass node.container on THIS call — do NOT create the node without a container and reparent it later via update_node. Orphaned nodes appear immediately to all live collaborators and create unnecessary visual churn.
| Argument | Type | Description |
|---|---|---|
| node* | object | Node definition. ERD field rows: when node.container is an ERD table (a container with kind:"erd"), the node becomes that table's next row — give only id, label (e.g. "🔑 id", "🔗 user_id", "email") and container, and do NOT pass x/y: the row is placed and the table resized for you. |
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
Removes a text annotation from a live Trident document. Use get_document_summary to get all annotation IDs before calling this. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| annotationId* | string | ID of the annotation to delete |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
{
"type": "object",
"required": [
"token",
"agentId",
"annotationId"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"annotationId": {
"type": "string",
"description": "ID of the annotation to delete"
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}Removes a connection from a live Trident document. Provide either the connectionId, or both source and target node IDs to find and remove the matching connection. Use get_document_summary to get all connection IDs before calling this. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| source | string | Source node ID (use with target if connectionId unknown) |
| target | string | Target node ID (use with source if connectionId unknown) |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| connectionId | string | ID of the connection to delete (preferred) |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
Removes a container from a live Trident document. By default, nodes inside are detached (kept on the diagram without a container). Pass deleteNodes: true to remove the container's nodes as well. Use get_document_summary to get all container IDs before calling this. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| containerId* | string | ID of the container to delete |
| deleteNodes | boolean | If true, also delete all nodes inside the container (default false) |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
Removes a node from a live Trident document. All connections to/from this node are also removed automatically. Use get_document_summary to get all node IDs before calling this. This action is reversible via Ctrl+Z in the Trident editor. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| nodeId* | string | ID of the node to delete |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
{
"type": "object",
"required": [
"token",
"agentId",
"nodeId"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"nodeId": {
"type": "string",
"description": "ID of the node to delete"
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}Delivers an explanation payload to human collaborators watching the document, optionally anchored to a specific node or container. Use this when you want to explain what a diagram element represents, why it exists, or how it relates to other parts of the system — without suggesting a change. The explanation appears in the UI attributed to you. Does NOT mutate the diagram. Requires a valid viewer or editor access token. IMPORTANT: this tool automatically pauses (3–15 s, proportional to explanation length) before returning, so the human has time to read. Do NOT add your own artificial delays between explain calls — the pacing is built in.
| Argument | Type | Description |
|---|---|---|
| token* | string | Viewer or editor access token for this document. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| entityId | string | ID of the node or container being explained. Always provide this when explaining a specific element — it moves the AI cursor to that element so collaborators can follow along. |
| userName* | string | First name of the human you are assisting. |
| explanation* | string | The explanation text to deliver to human collaborators (max 1000 chars). |
Returns a comprehensive Trident example demonstrating all syntax features including containers, nodes (traditional and bracket-style syntax), diamond/rectangle shapes, icons, connections with labels, routing modes, cards, and text annotations. Use this to see all features in action.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Renders the current state of a live Trident document as a PNG image directly from the Yjs collaborative session — bypassing Firestore, which may be stale. Returns a base64-encoded PNG. Use this to visually verify that diagram edits look correct before or after making changes.
| Argument | Type | Description |
|---|---|---|
| token* | string | Access token for this document. The document ID is embedded in the token. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "Access token for this document. The document ID is embedded in the token."
}
}
}Returns a complete structured summary of a Trident document as JSON: all node IDs, container IDs, connection IDs, annotation IDs, labels, and entity counts. Use this for PROGRAMMATIC OPERATIONS — it is never truncated regardless of diagram size, so you always get every entity ID. Use this before any bulk update, delete, or enumeration task. To read and understand the diagram as a human-readable diagram, use open_document instead. Requires a valid access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Access token for this document. The document ID is embedded in the token. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "Access token for this document. The document ID is embedded in the token."
}
}
}Returns LLM-optimized instructions for generating Trident diagrams, including quick reference, critical rules (especially Y-axis!), spacing guidelines, common patterns, color conventions, and error prevention checklist. Use this before generating Trident markup (a whole diagram as text). Not needed up front in a live session that edits a document with add_node / add_connection — load it there only for domain conventions (BPMN/UML/flowchart layout, ERD, C4).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Returns a condensed 2-minute quick-start guide with minimal working examples, core syntax reference, and key concepts. Use this for rapid learning when you need to generate simple diagrams quickly.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Returns the recent change history for a live Trident document. Each entry shows who made the change, what was changed, and when. Useful for understanding what edits have been made by AI agents or human collaborators. Requires a valid access token.
| Argument | Type | Description |
|---|---|---|
| limit | number | Optional: Maximum number of entries to return (default 100, max 500) |
| since | number | Optional: Unix timestamp in milliseconds — only return changes after this time |
| token* | string | Access token for this document. The document ID is embedded in the token. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"limit": {
"type": "number",
"description": "Optional: Maximum number of entries to return (default 100, max 500)"
},
"since": {
"type": "number",
"description": "Optional: Unix timestamp in milliseconds — only return changes after this time"
},
"token": {
"type": "string",
"description": "Access token for this document. The document ID is embedded in the token."
}
}
}Returns the complete Trident 2D specification including grammar, syntax rules, coordinate system, containers, nodes, connections, shapes, and icon reference. Use this when you need deep understanding of the Trident DSL.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Posts a visible suggestion to human collaborators watching the document WITHOUT making any changes to the diagram. Use this when you observe something worth flagging — a potential mistake, an improvement, or a question — but want the human to decide. The suggestion appears as a bold "SUGGESTION:" callout in the UI with a radar pulse animation on your presence dot for 10 seconds. Does NOT mutate the diagram. Requires a valid viewer or editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Viewer or editor access token for this document. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| entityId | string | ID of the node or container this suggestion relates to. Always provide this when the suggestion concerns a specific element — it moves the AI cursor to that element so collaborators know exactly what you are referring to. |
| userName* | string | First name of the human you are assisting. |
| suggestion* | string | The suggestion text to show to human collaborators (max 500 chars). Be concise and actionable. |
{
"type": "object",
"required": [
"token",
"agentId",
"userName",
"suggestion"
],
"properties": {
"token": {
"type": "string",
"description": "Viewer or editor access token for this document."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"entityId": {
"type": "string",
"description": "ID of the node or container this suggestion relates to. Always provide this when the suggestion concerns a specific element — it moves the AI cursor to that element so collaborators know exactly what you are referring to."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting."
},
"suggestion": {
"type": "string",
"description": "The suggestion text to show to human collaborators (max 500 chars). Be concise and actionable."
}
}
}Opens a live Trident document and returns its full contents as Trident markup DSL — the human-readable text format used to author diagrams. Use this to READ and UNDERSTAND the diagram: its structure, labels, connections, and layout. Do NOT rely on this to enumerate entity IDs for programmatic use — the DSL can be very large and the output may be truncated. To get a complete, structured list of all entity IDs and counts, use get_document_summary instead. Requires a valid access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Access token for this document. The document ID is embedded in the token. |
| agentId | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
{
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "Access token for this document. The document ID is embedded in the token."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
}
}
}Updates an existing text annotation in a live Trident document. Only the fields you provide are changed. Use get_document_summary to get all annotation IDs before calling this. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| changes* | object | Fields to update. Only provided fields are changed. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| annotationId* | string | ID of the annotation to update |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
{
"type": "object",
"required": [
"token",
"agentId",
"annotationId",
"changes"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"changes": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"bold": {
"type": "boolean"
},
"align": {
"type": "string"
},
"color": {
"type": "string"
},
"style": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"italic": {
"type": "boolean"
},
"content": {
"type": "string"
},
"fontSize": {
"type": "number"
},
"textColor": {
"type": "string"
},
"underline": {
"type": "boolean"
},
"outlineColor": {
"type": "string"
},
"strikethrough": {
"type": "boolean"
}
},
"description": "Fields to update. Only provided fields are changed."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"annotationId": {
"type": "string",
"description": "ID of the annotation to update"
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}Repositions or resizes a background image (canvas graphic) in a live Trident document. Use open_document to get the canvas graphic ID and current dimensions — it appears as: image <id> "<url>" at (x, y) width:W height:H. The position at (x, y) is the TOP-LEFT corner. USE THIS BEFORE placing many geographically-positioned nodes: if the background map is small (e.g. width < 700), scale it up so nodes have room to breathe and do not overlap. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). |
| changes* | object | Geometry fields to update. Only provided fields are changed; all others are preserved. |
| userName | string | First name of the human you are assisting. |
| canvasGraphicId* | string | ID of the canvas graphic to update (from open_document output). |
| action_explanation | string | Optional: brief explanation shown live to human collaborators (max 250 chars). |
{
"type": "object",
"required": [
"token",
"agentId",
"canvasGraphicId",
"changes"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\")."
},
"changes": {
"type": "object",
"required": [],
"properties": {
"x": {
"type": "number",
"description": "New top-left X position in canvas units."
},
"y": {
"type": "number",
"description": "New top-left Y position in canvas units."
},
"width": {
"type": "number",
"description": "New width in canvas units. Increase this to scale the map up."
},
"height": {
"type": "number",
"description": "New height in canvas units. Increase this to scale the map up."
},
"aspectLock": {
"type": "boolean",
"description": "Lock aspect ratio on resize (default true)."
}
},
"description": "Geometry fields to update. Only provided fields are changed; all others are preserved."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting."
},
"canvasGraphicId": {
"type": "string",
"description": "ID of the canvas graphic to update (from open_document output)."
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation shown live to human collaborators (max 250 chars)."
}
}
}Updates properties of an existing container in a live Trident document. Only provided fields are changed. Use get_document_summary to get all container IDs before calling this. Requires a valid editor access token. This is also how you RESIZE a container: set width/height (and x/y to keep it centred over its nodes) — do this whenever you add or move nodes outside a fixed-size container.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| changes* | object | |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| containerId* | string | ID of the container to update |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
Updates properties of an existing node in a live Trident document. Only the fields you provide are changed; others are preserved. Use get_document_summary to get all node IDs before calling this. Requires a valid editor access token.
| Argument | Type | Description |
|---|---|---|
| token* | string | Editor access token for this document. The document ID is embedded in the token. |
| nodeId* | string | ID of the node to update |
| agentId* | string | YOUR AI assistant name (e.g. "Claude.ai", "GitHub Copilot"). Shown as "[agentId] working with [userName]" in the collaboration presence dot. |
| changes* | object | Fields to update. Only provided fields are changed. |
| userName | string | First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as "[agentId] working with [userName]". |
| action_explanation | string | Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip. |
{
"type": "object",
"required": [
"token",
"agentId",
"nodeId",
"changes"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"nodeId": {
"type": "string",
"description": "ID of the node to update"
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"changes": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"card": {
"type": "string",
"description": "Set to empty string \"\" to remove card"
},
"icon": {
"type": "string"
},
"color": {
"type": "string",
"description": "Background color (hex or color name)"
},
"label": {
"type": "string"
},
"container": {
"type": "string",
"description": "Set to a container ID to move this node into that container; set to empty string \"\" to remove from its current container"
},
"shapeType": {
"type": "string",
"description": "Optional: shape type. \"rectangle\", \"diamond\", or a collection shape: Flowchart (\"flowchart-*\"), BPMN (\"bpmn-*\"), UML (\"uml-*\"), General primitives (\"circle\", \"cylinder\", \"hexagon\", \"rounded-rect\", etc.), or Organic (\"cloud\", \"star\", etc.)."
},
"textColor": {
"type": "string"
},
"outlineColor": {
"type": "string"
}
},
"description": "Fields to update. Only provided fields are changed."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}Returns a comprehensive validation checklist for Trident diagrams covering syntax rules, semantic rules, best practices, and common mistakes to avoid. Use this after generating a diagram to verify correctness.
| Argument | Type | Description |
|---|---|---|
| diagram | string | Optional: The Trident diagram code to include context-specific validation tips |
{
"type": "object",
"properties": {
"diagram": {
"type": "string",
"description": "Optional: The Trident diagram code to include context-specific validation tips"
}
}
}{
"type": "object",
"required": [
"token",
"agentId",
"node"
],
"properties": {
"node": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"x": {
"type": "number",
"description": "Optional: X position in diagram units"
},
"y": {
"type": "number",
"description": "Optional: Y position (screen coords — larger Y is lower on screen)"
},
"id": {
"type": "string",
"description": "Unique ID for the node (no spaces, e.g. \"api_server\")"
},
"card": {
"type": "string",
"description": "Optional: markdown content for an expandable info card"
},
"icon": {
"type": "string",
"description": "Optional: icon name from the Trident icon library"
},
"color": {
"type": "string",
"description": "Optional: background/fill color (hex like \"#438DD5\" or a color name). Set on THIS call — do not add the node and recolor it later with update_node."
},
"label": {
"type": "string",
"description": "Display label shown on the diagram"
},
"container": {
"type": "string",
"description": "ID of the container this node belongs in. Set this NOW if you know the parent — do not create the node orphaned and reparent later with update_node. Treat this as required whenever the node has a logical parent container. If that container has an explicit width/height (a fixed size) and this node's position falls outside it, ALSO call update_container to enlarge the container (width/height, and x/y if needed) so the node fits — containers are centred on x/y, so their edges are at x ± width/2 and y ± height/2; leave ~40 units of padding. (The canvas grows the container on screen anyway, but the document keeps the old size until you resize it.)"
},
"shapeType": {
"type": "string",
"description": "Optional: shape type. Default \"rectangle\"; \"diamond\" for decisions. Registered collections: Flowchart (\"flowchart-process\", \"flowchart-rounded\", \"flowchart-stadium\", \"flowchart-cylinder\", \"flowchart-circle\", \"flowchart-double-circle\", \"flowchart-decision\", \"flowchart-hexagon\", \"flowchart-parallelogram\", \"flowchart-trapezoid\", etc.), BPMN (\"bpmn-start-event\", \"bpmn-end-event\", \"bpmn-gateway\", \"bpmn-task\", \"bpmn-user-task\", \"bpmn-subprocess\", etc.; labels render under events/gateways), UML (\"uml-class\", \"uml-interface\", \"uml-package\", \"uml-component\", \"uml-database\", \"uml-actor\", \"uml-state\", \"uml-action\", etc.), General primitives (\"circle\", \"cylinder\", \"hexagon\", \"rounded-rect\", \"parallelogram\", \"trapezoid\", etc.), or Organic (\"cloud\", \"star\", \"heart\", etc.). Unknown values fall back to rectangle."
},
"textColor": {
"type": "string",
"description": "Optional: label text color (hex or color name), e.g. \"#FFFFFF\"."
},
"outlineColor": {
"type": "string",
"description": "Optional: border/outline color (hex or color name)."
}
},
"description": "Node definition. ERD field rows: when node.container is an ERD table (a container with kind:\"erd\"), the node becomes that table's next row — give only id, label (e.g. \"🔑 id\", \"🔗 user_id\", \"email\") and container, and do NOT pass x/y: the row is placed and the table resized for you."
},
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}{
"type": "object",
"required": [
"token",
"agentId"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"source": {
"type": "string",
"description": "Source node ID (use with target if connectionId unknown)"
},
"target": {
"type": "string",
"description": "Target node ID (use with source if connectionId unknown)"
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"connectionId": {
"type": "string",
"description": "ID of the connection to delete (preferred)"
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}{
"type": "object",
"required": [
"token",
"agentId",
"containerId"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"containerId": {
"type": "string",
"description": "ID of the container to delete"
},
"deleteNodes": {
"type": "boolean",
"description": "If true, also delete all nodes inside the container (default false)"
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}{
"type": "object",
"required": [
"token",
"agentId",
"userName",
"explanation"
],
"properties": {
"token": {
"type": "string",
"description": "Viewer or editor access token for this document."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"entityId": {
"type": "string",
"description": "ID of the node or container being explained. Always provide this when explaining a specific element — it moves the AI cursor to that element so collaborators can follow along."
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting."
},
"explanation": {
"type": "string",
"description": "The explanation text to deliver to human collaborators (max 1000 chars)."
}
}
}{
"type": "object",
"required": [
"token",
"agentId",
"containerId",
"changes"
],
"properties": {
"token": {
"type": "string",
"description": "Editor access token for this document. The document ID is embedded in the token."
},
"agentId": {
"type": "string",
"description": "YOUR AI assistant name (e.g. \"Claude.ai\", \"GitHub Copilot\"). Shown as \"[agentId] working with [userName]\" in the collaboration presence dot."
},
"changes": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "Centre X"
},
"y": {
"type": "number",
"description": "Centre Y"
},
"color": {
"type": "string"
},
"label": {
"type": "string"
},
"width": {
"type": "number",
"description": "Fixed width — enlarge so every member node fits (edges at x ± width/2)"
},
"height": {
"type": "number",
"description": "Fixed height — enlarge so every member node fits (edges at y ± height/2)"
}
}
},
"userName": {
"type": "string",
"description": "First name of the human you are assisting (ask them at session start if you do not know). Shown in the collaboration presence dot as \"[agentId] working with [userName]\"."
},
"containerId": {
"type": "string",
"description": "ID of the container to update"
},
"action_explanation": {
"type": "string",
"description": "Optional: brief explanation of what this action does and why (max 250 chars). Shown live to human collaborators in the AI cursor tooltip."
}
}
}