# Check a diagram parses and reads cleanly before publishing

> Check a diagram parses and reads cleanly before publishing: 2 companies fully do it, 7 with a limit, 16 carry the tag. Every listing in Diagramming with the reason and a source.

- Canonical: https://www.anchorterminal.com/niches/diagramming.validate-diagram/
- Markdown: https://www.anchorterminal.com/niches/diagramming.validate-diagram/index.md (~1,350 tokens)
- Slim: https://www.anchorterminal.com/niches/diagramming.validate-diagram/index.min.md (~330 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/niches/diagramming.validate-diagram/index.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (the key docs and every listing in one file, at most 16 MB, about 4 million tokens: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- MCP: https://www.anchorterminal.com/mcp (the whole catalogue as tools, no key)
- DNS: dig +short TXT <slug>.grade.anchorterminal.com (the grade as a DNS TXT record, for a sandbox with no HTTP where names still resolve; also top., best.<category>. and <a>.vs.<b>. under the zone, and the same under grade.letme.dev)
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)
- Updated: 2026-11-15

Two or three companies' docs show a full fit.

| Companies, full fit | With a limit | Carry the tag | Share of the category's work | First-hand accounts |
| --- | --- | --- | --- | --- |
| 2 | 7 | 16 | 14 | 8 |

## What counts as done

A pass or fail with a nonzero exit or error object on failure, naming the line or element at fault, and for layout checks a list of overlapping boxes, overflowing labels and dangling edges, all without publishing anything.

Measured, for our own tests: under 2 seconds per diagram.

How agents ask for it: check this Mermaid is valid; lint the diagram; does this render; validate the C4 workspace in CI

## Does the job

The docs show it meets the test above, and nothing we read says otherwise.

- **ExcaliClaw (ExcaliClaw)**: validate_design dry-runs a write with nothing saved, every write is rejected whole when it fails the gate and the response lists each error, and lint_design lists overlaps, arrows crossing boxes, text overflow and unbound arrows. Speed bar not stated.
- **PlantUML (No legal entity found. Copyright Arnaud Roques)**: --check-syntax checks without generating images, exit is above 0 on error, and -stdrpt prints errors as single lines naming the line and file, suitable for CI. No overlap or dangling-edge check, which only matters for layout lint. Speed bar not stated.

## Does the job, with a limit

It does the job, but something in the docs or a user's account will get in an agent's way. The limit is named in each row.

- **D2 (The Hack Foundation (Hack Club), fiscal sponsor of the D2 project)**: d2 validate checks a file and the CLI's exit status reports failure, but there is no layout check for overlaps or dangling edges, and the maintainer declined a linter for models (acc-29).
- **Diagrams.so API + MCP (RedHold LLC)**: get_warnings returns Well-Architected findings and fix_warning applies one, but there is no syntax check, no overlap or dangling-edge list, and no exit code.
- **draw.io + MCP (draw.io Ltd)**: Diagrams are auto-repaired, and a layout check (overflowing labels, overlapping shapes, lines through shapes) is on staging per the maintainer on acc-19, not yet on mcp.draw.io. No syntax check with a nonzero exit or line number.
- **Excalidraw (Excalidraw s.r.o.)**: check_scene_layout reports text sticking out and overlaps as layoutIssues without rendering, and writes return warnings. This is an MCP call on a workspace scene, not a CLI with an exit status for CI.
- **Kroki (Yuzu tech, a French software firm. No registered legal form found)**: A bad diagram fails the request, with JSON errors on request; error type and line number in the JSON are unreleased on main. No layout check for overlaps or dangling edges.
- **Mermaid Chart MCP (Mermaid Chart Inc.)**: A validation tool exists, but the docs don't show the error shape or whether it names the failing line, and there is no layout check. acc-30 shows Mermaid parse traps (parentheses in labels).
- **Structurizr + MCP (Structurizr Limited)**: validate returns OK or an error message, inspect lists violations, and inspect's exit-0-on-violations bug (acc-26) was fixed in 2026.10.26. The docs don't say whether validate's error names the line.

- not this job: AI Diagram Maker MCP (AI Diagram Maker (Rajasekar Elango)): No validation tool.
- not this job: Cloudviz API (SIA Cloudviz Solutions): No diagram validation.
- not this job: Eraser API + MCP (Eraser Labs, Inc.): No validation or lint tool is listed.
- not this job: Lucid API + MCP (Lucid Software Inc.): No validation endpoint; a bad request returns a 400 without naming the line, and nothing checks layout.
- not this job: Mumble (tiny space): A canvas with unresolved references is refused with the reason and tool errors come back as values, but there is no validator or lint for diagram source in CI.
- not this job: Mural MCP (Tactivos, Inc. (d/b/a Mural)): No validation of diagram text, which it doesn't use.
- not this job: tldraw SDK + MCP (tldraw, Inc.): No syntax or layout check.
- not this job: Whimsical MCP (Whimsical, Inc.): No syntax or layout check tool.

## What stops agents finishing

- validator exits 0 on failures
- no linter, so the model iterates blind

## Around it

Before: diagramming.render-as-code, diagramming.editable-diagram. After: code.open-pr.

## Where this comes from

Weight 14 of 100 in Diagramming: 8 of 37 accounts (Kroki, D2, Structurizr, Excalidraw, draw.io lint scripts) plus Mermaid Chart's validate tool

As data: https://www.anchorterminal.com/api/v1/use-cases/diagramming.validate-diagram.json, or the MCP tool get_use_case with id diagramming.validate-diagram. Draft, read 2026-11-15 from public docs and first-hand accounts, not yet reviewed by a person.

---

Query this catalogue directly over MCP: https://www.anchorterminal.com/mcp (Streamable HTTP, no key). How: https://www.anchorterminal.com/agents/#mcp
