excalix
Generates architecture diagrams as editable Excalidraw files with automatic layout, hand-drawn styling, labeled and bound arrows, plus SVG and PNG exports.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
excalix
Architecture diagrams from a topology spec, in Excalidraw's hand-drawn style. You write what exists and what talks to what; excalix does the layout, the shapes and colours, the text measurement and the arrow bindings, and the same spec always produces the same bytes.

{
"title": "order pipeline",
"direction": "lr",
"groups": [
{ "id": "aws", "label": "AWS eu-north-1" },
{ "id": "k8s", "label": "EKS", "parent": "aws" }
],
"nodes": [
{ "id": "web", "label": "Web app", "kind": "client" },
{ "id": "api", "label": "Order API", "kind": "service", "group": "k8s" },
{ "id": "worker", "label": "Fulfilment", "kind": "service", "group": "k8s" },
{ "id": "q", "label": "orders.created", "kind": "queue", "group": "aws" },
{ "id": "pg", "label": "Postgres", "kind": "datastore", "group": "aws" },
{ "id": "redis", "label": "Redis", "kind": "cache", "group": "aws" },
{ "id": "stripe", "label": "Stripe", "kind": "external" }
],
"edges": [
{ "from": "web", "to": "api", "label": "POST /orders" },
{ "from": "api", "to": "pg" },
{ "from": "api", "to": "redis", "arrows": "both" },
{ "from": "api", "to": "q", "style": "async" },
{ "from": "q", "to": "worker", "style": "async" },
{ "from": "worker", "to": "stripe", "label": "charge" }
]
}Out come an .excalidraw, an SVG and a PNG. The .excalidraw opens on excalidraw.com with every label and arrow binding intact, so you can keep editing by hand. The SVG and PNG carry the same scene, so either one dropped on excalidraw.com opens as the drawing too. An image optimiser such as SVGO or a PNG crusher strips that scene, so the .excalidraw stays the source of truth.
Install
Node 22 or newer. Export and text measurement run in headless Chromium, which is a separate download:
npx -y playwright@1.63.0 install chromiumRelated MCP server: Excalidraw Architect MCP
Use
npx -y excalix render spec.json -o out/spec writes out/spec.excalidraw, .svg and .png
--theme dark draws the .svg and .png in Excalidraw's dark mode
--theme both adds out/spec.dark.svg and .dark.png beside the light pair
--animate story adds out/spec.animated.svg, the diagram drawing itself edge by edge
--animate layers the same, one layer of the layout at a time
npx -y excalix validate spec.json every problem at once, or ok: 7 nodes, 6 edges, 2 groups
npx -y excalix schema JSON Schema of the specWith an agent, register the MCP server once. Its sketch tool takes the spec, writes the three files and returns the PNG in the same turn, along with a markdown line that shows the SVG in a README:
claude mcp add excalix --scope user -- npx -y excalix mcpThe skill tells the agent when to reach for it and how to write a spec that lays out well:
mkdir -p ~/.claude/skills/excalix
curl -fsSL https://raw.githubusercontent.com/yasinmiran/excalix/main/skills/excalix/SKILL.md -o ~/.claude/skills/excalix/SKILL.mdThe spec
nodes, edges, an optional title, direction (lr or tb) and groups, which nest through parent. A node sits in at most one group.
kind | draws as |
| whoever initiates requests: people, browsers, mobile apps |
| anything you run or configure yourself, an app or a load balancer alike |
| database or durable storage |
| queue, topic or stream |
| cache or in-memory store |
| a system another company operates and you only call |
A node can also name an icon from a fixed catalog of 32, such as database, gateway, lock or payment; excalix schema lists them all. Like kind, it says what the node is, and excalix draws it, a small line icon left of the label in the label's colour:
![]()
edge.style is sync (solid, default) or async (dashed). edge.arrows is forward (default), both or none. A \n in any label starts a new line, and an edge label past about twenty characters wraps onto more lines. The breaks are written into the file, so a label keeps its lines when you drag things around in Excalidraw.
List nodes in reading order, keep edge labels to a few words, and split anything past about twenty nodes into an overview and a detail diagram. skills/excalix/SKILL.md has the rest. Validation names every problem in one go:
edges[0].to: unknown node "apy", did you mean "api"?
nodes[2].kind: got "db", expected one of "client", "service", "datastore", "queue", "cache", "external"Why
An .excalidraw file is nothing but coordinates, and an agent asked to draw one has to invent all of them. excalix takes the geometry away, so two diagrams made a year apart look like one set, and a change to the spec shows up as a reviewable diff.
The docs have the full spec reference, the sketch tool's contract and more examples. pnpm test and pnpm typecheck run the checks; the tests draw in Chromium and WebKit, so install both once with npx -y playwright@1.63.0 install chromium webkit. MIT, and not affiliated with Excalidraw. The fallback fonts in fonts/ keep their own licences: DejaVu Sans the Bitstream Vera and Arev ones, Twemoji the SIL OFL 1.1 for the font and CC BY 4.0 for the art. The icons in icons/ are Lucide's, under the ISC licence.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Generate cloud architecture diagrams, flowcharts, and sequence diagrams.
Polished system design diagrams (SVG/PNG) from a tiny YAML spec, ~18x fewer tokens than raw SVG.
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceGenerates editable Excalidraw diagram files from natural language descriptions of systems and architectures.1MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to turn plain-language descriptions of systems, flows, and data into 25 kinds of fully laid-out, hand-drawn Excalidraw diagrams — architecture, sequence, ER, swimlane, Gantt, charts and more — with auto-styling for 50+ technologies and revision in natural language. Runs fully offline, exports to SVG and PNG without a browser or Node.js, and can optionally persist the architecture as a queryable knowledge graph.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to generate auto-laid-out, hand-drawn-style Excalidraw diagrams across 25 diagram types from natural-language structure descriptions, with SVG/PNG export and natural-language revision. Runs fully offline without API keys and can persist the described system as a queryable architecture knowledge graph.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to turn natural-language descriptions of systems, flows, and data into 25 types of hand-drawn Excalidraw diagrams with automatic layout and architecture-aware styling, then revise them conversationally and export to SVG or PNG. It can also persist a system as a version-controlled, queryable architecture knowledge graph, running fully offline without API keys.-