Tools reference

Every tool maps to an API endpoint. Reads are free; the billable tools are marked. You rarely call these by name: describe what you want and the agent picks the right tools. Each id is passed between tools automatically.

Create and change (billable)

Tool	What it does
`generate_diagram`	Create a diagram from a prompt.
`edit_diagram`	Apply a natural-language edit to a diagram.
`fix_warning`	Apply a fix for a specific Well-Architected finding.
`relayout_diagram`	Re-arrange a diagram for readability (async).
`fork_template`	Copy a gallery template into your account.
`import_diagram`	Import an existing draw.io file (import itself is free; edits bill).

Read (free)

Tool	What it does
`get_diagram`	Read a diagram by id.
`list_diagrams`	List your diagrams, newest first.
`update_diagram`	Update metadata such as the title.
`delete_diagram`	Delete a diagram you own.
`get_warnings`	Read the current Well-Architected findings.
`get_relayout_status`	Poll an async re-layout job.
`list_versions`	List a diagram’s versions.
`get_version`	Read a specific version.
`revert_diagram`	Revert a diagram to a prior version.
`search_gallery`	Search public templates.

Export (free)

Tool	What it does
`export_diagram`	Export as native draw.io XML or SVG.

Prompt helpers (free)

Tool	What it does
`enhance_prompt`	Turn a rough idea into a detailed prompt.
`clarify_prompt`	Get clarifying questions for a vague prompt.

Usage and account (free)

Tool	What it does
`get_usage`	Plan, credits, and cost estimates.
`get_usage_history`	Itemized per-task credit history for this session and account.
`whoami`	Account, plan, scopes, and live/test mode.
`list_capabilities`	Valid diagram types, providers, and export formats.

Example prompts

Describe what you want in plain language. Expand any example to see a prompt that works well.

Generate and review

“Generate an AWS 3-tier web app with an ALB, EC2 Auto Scaling, and RDS Postgres, then list any Well-Architected warnings.”

Iterate

“Add a CloudFront distribution in front of the ALB, then fix the top reliability warning.”

Export

“Export the current diagram as SVG so I can drop it in the README.”

Start from a template

“Search the gallery for a serverless pipeline, fork the best match, and adapt it for GCP.”

Track spend

“How many credits did this session use, and on which tasks?”

Getting started

Model Context Protocol (MCP)

SDKs

Guides

Billing

Resources

Create and change (billable)

Read (free)

Export (free)

Prompt helpers (free)

Usage and account (free)

Example prompts

​Create and change (billable)

​Read (free)

​Export (free)

​Prompt helpers (free)

​Usage and account (free)

​Example prompts

Create and change (billable)

Read (free)

Export (free)

Prompt helpers (free)

Usage and account (free)

Example prompts