Create a new cloud architecture diagram from a natural-language prompt. Returns the diagram id, its draw.io XML, Well-Architected warnings, score, and credits used. Costs credits.

Apply a natural-language change to an existing diagram (e.g. 'add a Redis cache'). Creates a new version and returns the updated XML. Costs credits. Confirm with the user before calling — it mutates the diagram.

Resolve a single Well-Architected warning (from get_warnings), leaving the rest of the diagram untouched. Creates a new version. Costs credits.

Automatically re-arrange a diagram's layout for readability (async). Starts the job and waits for it to finish, returning the re-laid XML + fresh warnings/score. Every re-layout costs credits based on the tokens it uses (like edit/fix) and requires confirm=true. If the job is still running when the wait elapses, returns a job_id you can poll with get_relayout_status.

Import an existing draw.io (mxGraphModel/mxfile) XML document as a new diagram in your account. Validated and sanitized. Free (no AI).

Update a diagram's metadata or XML: rename it, change visibility (public/private — paid plans for private), or replace its XML. Pass only the fields you want to change. Free (no AI).

Delete (soft-delete) a diagram you own. It stops appearing in list_diagrams and can no longer be fetched. Confirm with the user before calling — this is destructive.

Revert a diagram to an earlier version (from list_versions). Pass either version_id or version_number. Free (no AI).

Fetch a diagram by id — returns its title, draw.io XML, and Well-Architected score.

List your diagrams (newest first, cursor-paginated). Returns id, title, cloud, type.

List the Well-Architected findings for a diagram (each has type, component, message). Free.

Export a diagram as a raw file: drawio (open at app.diagrams.net) or svg. Returns the file content directly. Exports are free on every plan. Free-plan SVG exports carry a watermark.

List a diagram's version history (ascending; is_current marks the live one). Use with revert_diagram / get_version.

Fetch a specific version's XML + Well-Architected score (e.g. to inspect before reverting). Free.

Check the status of an async re-layout job started by relayout_diagram. Returns pending/done/failed; when done+applied it includes the re-laid XML + fresh warnings/score. Free.

Search public community diagrams and curated library templates to reuse as a starting point. Returns id, title, and source (community/library). Fork one with fork_template.

Copy a PUBLIC gallery diagram or curated library template into your own account (private) so you can edit it. Returns the new diagram id.

Turn a rough idea into a detailed generation prompt. Free.

Get 1–3 clarifying questions (and a suggested diagram type) for a vague prompt, before generating. Free.

Show your current plan, credits remaining, and per-action cost estimates. Free.

List how much credit each past task (generate/edit/fix/relayout) charged — newest first, with the diagram it touched and the surface (api/sdk/mcp) that ran it. Use this to answer 'how much did each task cost?'. Also shows a running tally of tasks performed in THIS session. Free (read-only).

Show the account, plan, scopes, and live/test mode of the configured API key. Free.

Discover the valid diagram types, cloud providers, and export formats the API supports — so you pass valid values to generate_diagram / export_diagram. Free.