Tools

Everything Archboard exposes to your AI client: tools, resources and prompts.

19 capabilities19 tool

Automated heuristic

Tool docs quality: C — 19 tools graded

Average 58/100 for how clearly each description tells an AI client what the tool does, what it needs, and what it changes. It is not a security audit.

Grade A: 0
Grade B: 5
Grade C: 11
Grade D: 3
Grade F: 0

How grades work

add_imagetool
Add an image from a public https URL; Archboard's server downloads it once
Description quality grade B, 75/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
apply_opstool
Add, change or remove nodes, connections and images as one revertible change
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
compose_diagramtool
Draw a Mermaid flowchart or an infographic spec as one revertible change
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
create_diagramtool
Create a new diagram in a workspace
Description quality grade C, 60/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed10/20
  A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  The description says what the tool changes.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
delete_diagramtool
Move a diagram to the trash (it can be restored; no permanent delete)
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  The description says what the tool changes.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
export_diagramtool
PNG or SVG export with a download link (15 minutes, up to 5 downloads)
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_canvastool
Read a diagram: an outline, or full records page by page
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_node_typetool
Size, props, style keys and ports of one node type
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
get_selectiontool
What the person has selected in their open editor
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed10/20
  A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
list_diagramstool
Diagrams this connection can access, newest first, with their permission
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
list_workspacestool
Organizations and workspaces this connection can use, with role, plan and permission
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
read_metool
Usage guide: workflow, document format, layout rules, limits and error codes
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
render_snapshottool
PNG render of the diagram or a part of it, for checking the result
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
revert_changetool
Undo one change this app made in the last 7 days
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  The description says what the tool changes.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
search_node_typestool
Find node types across packs (Kubernetes, cloud, C4, BPMN, mind map and more)
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
search_shapestool
Find built-in and saved shapes and icons by keyword
Description quality grade B, 80/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed10/20
  A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
set_statustool
Short status next to the app's cursor on the canvas
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
show_diagramtool
Live view of the diagram inside the chat, in apps that support MCP Apps
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
upload_imagetool
One-time upload link for a local image file (apps that can run shell commands)
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: not passed0/15
  Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
  This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.