# draw.io (remote · mcp.draw.io)

Create diagrams in chat, rendered as live interactive draw.io diagrams. 10,000+ searchable shapes.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-07

## Components

- remote · `mcp.draw.io`: 65/100 (this document), [markdown](https://verifymcp.io/servers/io-draw-mcp/mcp.md), [page](https://verifymcp.io/servers/io-draw-mcp/mcp)

## Channel facts

- Endpoint: `https://mcp.draw.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-07.

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 26/100
  - 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 5339 tokens (~1779/item across 3 items; 2 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http io-draw-mcp https://mcp.draw.io/mcp
```

### Codex

```toml
[mcp_servers.io-draw-mcp]
url = "https://mcp.draw.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-draw-mcp": {
      "type": "remote",
      "url": "https://mcp.draw.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-draw-mcp --url https://mcp.draw.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-draw-mcp:
    url: "https://mcp.draw.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-draw-mcp": {
      "type": "http",
      "url": "https://mcp.draw.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-06 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-04 (score 64, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-03 (score 63)

First indexed and scored.

## MCP tools (2)

### `create_diagram` (~5077 tokens)

Create Diagram

Creates and displays an interactive draw.io diagram. Accepts either draw.io XML or Mermaid.js syntax — provide exactly one.

\**Format decision — this is the first thing to settle before you write anything:** if the diagram type appears on the Mermaid list below, use `mermaid`. Only use `xml` when the diagram type isn't on that list (UI mockups, floorplans, cloud/network/electrical architecture with stencils, hand-placed UML, etc.) or when the user has explicitly asked for draw.io XML.

\**Use Mermaid** for the following diagram types (all rendered natively, no upstream mermaid runtime):
  \- flowchart / graph (TD, LR, …)
  \- sequenceDiagram
  \- classDiagram
  \- stateDiagram / stateDiagram-v2
  \- erDiagram
  \- gantt
  \- pie
  \- journey (user-journey)
  \- gitGraph
  \- mindmap
  \- timeline
  \- quadrantChart
  \- xychart-beta
  \- sankey-beta
  \- requirementDiagram
  \- C4Context / C4Container / C4Component
  \- block-beta
  \- architecture-beta
  \- packet-beta
  \- kanban
  \- radar-beta
  \- treemap-beta
  \- treeview-beta (draw.io-specific)
  \- venn (draw.io-specific) — syntax: `venn` then `set A ["Label"]` for each set, `union A,B` for declared overlaps (informational), and `text A` / `text A,B` followed by `["Region label"]` for text inside a region. Do NOT use `A AND B[...]` or `A["..."]` shorthand — those lines are ignored.
  \- ishikawa (draw.io-specific)
  \- zenuml
\**Strong default: use Mermaid for every diagram type on that list above.** Mermaid is simpler, more reliable, and the native Mermaid layout handles positioning and routing for you. For a flowchart, state diagram, sequence, ER, class, gantt, gitGraph, mindmap, etc. — reach for the `mermaid` parameter, not `xml`. Do not default to XML for flowcharts.

\**Use XML** when the diagram type isn't on the Mermaid list above OR when the user explicitly asks for XML / draw.io format. Typical cases where XML is the right choice:
\- **UI mockups / wireframes / screen designs** — buttons, form fields, sidebars, modal dialogs (…

Input parameters:

- `direction` (string): **XML only** — the flow direction for `postLayout: "elk"` on XML diagrams: `vertical` (top-down) or `horizontal` (left-to-right). Defaults to `vertical`. **Ignored for Mermaid**, where direction is r…
- `mermaid` (string): Mermaid.js diagram definition (e.g. 'graph TD\n  A-->B'). Supports 26 diagram types — see the tool description for the full list. The diagram is parsed and laid out natively (no upstream mermaid runt…
- `postLayout` (string): Optional client-side ELK (Eclipse Layout Kernel) layered-flow pass applied after the diagram renders. The only value is `"elk"`. Vertices animate (morph) from the positions you supplied to the layere…
- `routing` (string): **XML only** — optional obstacle-avoiding orthogonal **edge-routing** pass (libavoid). The only value is `"libavoid"`. Unlike `postLayout`, this does **not** move any vertices — it keeps your hand-pl…
- `xml` (string): draw.io XML content in mxGraphModel format. Must be well-formed XML: no XML comments (<!-- -->), no unescaped special characters in attribute values. Mutually exclusive with 'mermaid'.

### `search_shapes` (~255 tokens)

Search Shapes

Search the draw.io shape library by keywords. Returns matching shapes with their exact style strings, dimensions, and titles. Covers ~10,000 built-in stencils (cloud architecture, network topology, P&ID, electrical, Cisco, Kubernetes, BPMN) and, when those are sparse, supplements results with the draw.io icon service (brand/product logos and general-purpose concept icons, e.g. 'react', 'slack', 'shopping cart', 'solar panel'). Use ONLY for diagrams that need industry-specific, branded, or pictorial icons. Do NOT use for standard diagram types like flowcharts, UML, ERD, org charts, or mind maps — these use basic geometric shapes (rectangles, diamonds, circles, cylinders) that are already covered in the XML reference. Also skip if the user asks to use basic/simple shapes or says not to search. The style string from the results can be used directly in mxCell style attributes.

Input parameters:

- `limit` (number): Maximum number of results to return (default: 10, max: 50)
- `query` (string, required): Space-separated search keywords (e.g. 'pid globe valve', 'aws lambda', 'cisco router', 'kubernetes pod')

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-draw-mcp/mcp#diagnostics

## Score history

- 2026-08-07: 65
- 2026-08-06: 65
- 2026-08-05: 64
- 2026-08-04: 64
- 2026-08-03: 63

## Links

- Remote endpoint: https://mcp.draw.io/mcp
- Repository: https://github.com/jgraph/drawio-mcp
- Website: https://www.drawio.com/
- Changelog RSS feed: https://verifymcp.io/servers/io-draw-mcp/mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-draw-mcp/mcp.json
- HTML version of this page: https://verifymcp.io/servers/io-draw-mcp/mcp