UML-MCP
This MCP server lets AI assistants render, validate, preview, and export many kinds of diagrams directly in chat.
Discover supported diagram types and their renderers/formats with
list_diagram_types.Generate single diagrams with
generate_uml/generate_uml_image, returning inline previews, render URLs, playground links, and saved-file metadata.Validate diagram source before rendering with
validate_uml, including syntax diagnostics, warnings, and suggestions.Render up to 20 diagrams in one call with
generate_uml_batch, tolerating individual failures.Re-render diagrams in the interactive viewer with selected theme and format via
rerender_diagram.Download or chunk-export source, SVG, PNG, PDF, or standalone HTML via
download_diagram.Use 52 diagram types: 37 Kroki-backed types plus 15 interactive plugins such as D3, stack diagrams, architecture workflows, LLM visualizations, DB schemas, dependency graphs, statecharts, agent traces, C4 models, and timelines.
In MCP Apps clients, open diagrams in an interactive viewer with zoom, source editing, theme/format switching, re-render, batch tabs, and SVG/PNG/HTML/PDF export.
Generates Excalidraw diagrams as part of the supported specialized diagram types, rendered via Kroki.
Generates Mermaid diagrams as part of the supported diagram types, rendered via Kroki.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@UML-MCP Draw a UML sequence diagram for user registration"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
UML-MCP
Diagrams for AI assistants. A Model Context Protocol server that turns a description or diagram source into a rendered diagram, inside the chat.
Docs · Quick start · Kroki diagrams · Interactive diagrams · Changelog · Contributing
It works as an MCP App
In clients that support MCP Apps, diagrams open in a viewer inside the chat
(ui://uml-mcp/diagram-viewer): zoom, edit the source, switch theme and format, re-render, step
through a batch, and export SVG, PNG, HTML or PDF. Clients without MCP Apps get the same diagram
as an inline PNG and SVG.
Related MCP server: Draw.io MCP Server
Why UML-MCP
52 diagram types. 37 through Kroki (UML, Mermaid, D2, Graphviz, C4, BPMN, ERD, TikZ...) and 15 interactive ones, including cloud and stack diagrams with real logos, architecture, workflow and sequence diagrams, 2D/3D LLM visualisations, database schemas, dependency graphs, statecharts, agent traces, C4 models and timelines.
Shows up in the chat. Every client gets an inline image plus links to the rendered file and an editable playground. Clients with MCP Apps also get an interactive viewer.
Ready to run. Hosted endpoints, or local with Docker or Helm; optional Entra ID / OAuth 2.1 SSO, audit logs and metrics. It scores 95/100 on the Manufact publishing checklist.
Quick start
Add the hosted server to your MCP client:
"uml-mcp": {
"transport": "http",
"url": "https://uml-mcp.vercel.app/mcp"
}Then ask, for example, "Draw a sequence diagram of a user logging in through an API gateway."
Endpoint | URL |
Primary (Vercel) |
|
Mirror (Manufact) |
|
Ready-made configs: Cursor · VS Code / Copilot · Codex · Claude Desktop · Open WebUI · all clients. To run it yourself:
uv tool install uml-mcp && uml-mcp setupThe installation guide covers Docker, Helm and running from source.
To explore all 15 interactive types from a checkout, use the local viewer preview. Its compact example picker changes diagrams automatically and keeps export controls in the viewer.
Kroki diagrams
37 types through Kroki: UML (PlantUML), Mermaid, D2, Graphviz, C4, BPMN,
ERD, TikZ and more. Call generate_uml / generate_uml_image with the diagram_type under
each thumbnail. Source examples live in examples/ and at uml://examples;
notation guides are in Diagram types. Regenerate this gallery with
uv run python scripts/build_kroki_gallery.py.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Interactive diagrams
The plugins below ship with UML-MCP and are on by default. Each type renders to an interactive HTML page in the viewer and to a static SVG and PNG everywhere else.
Plugin | Types | What you get |
| Force graphs and cloud diagrams with real provider and brand logos, routed with A* | |
| Icon tiles, nested vendor and region groups, numbered request steps | |
| Colour-coded groups, legend, three presets, click to focus and trace the shortest path | |
| Layer maps, autoencoder and GAN shapes, | |
| ER diagrams from SQL DDL or JSON: column cards, crow's-foot keys at the column rows, search | |
| A project's dependency tree from | |
| XState-like machines as statecharts, and a simulator that fires events, with a step log and Undo | |
| An agent run as a waterfall and a flow: LLM, tool and retrieval steps with tokens, cost, retries and the critical path | |
| One model, three C4 levels: click a system to open its containers, a container for its components | |
| Roadmaps with swimlanes, phases, milestones, releases and dependency arrows; zoom from quarters to days |
Each image links to the plugin guide. The complete smoke-test prompt covers every type, both themes, browser interactions and file exports.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
{
"title": "SaaS stack",
"groups": [{"id": "vercel", "name": "Vercel", "icon": "vercel"}],
"nodes": [
{"id": "user", "name": "User", "icon": "user"},
{"id": "web", "name": "Next.js", "icon": "browser", "group": "vercel"},
{"id": "db", "name": "Neon", "icon": "database"},
{"id": "ci", "name": "GitHub Actions"}
],
"edges": [
{"from": "user", "to": "web", "label": "HTTPS", "step": 1},
{"from": "web", "to": "db", "label": "SQL", "step": 2},
{"from": "ci", "to": "web", "label": "deploy", "style": "dashed"}
]
}Send that as stack_diagram and you get the GitHub and Vercel logos, two numbered steps and a
dashed deploy edge. The plugins guide has example prompts for every type
and shows how to write your own.
Tools
Tool | Purpose |
| Render one diagram: image, URL and playground link |
| The same as an inline chat image (PNG by default) |
| Check source before rendering; errors say how to fix it |
| The live catalog, including plugin types |
| Many diagrams in one call |
Resources (uml://types, uml://examples, uml://templates...), prompts and skills
(skill://uml-mcp-diagrams/SKILL.md plus focused guides) are listed in the
reference.
Documentation
Topic | Where |
Getting started and tutorials | |
Diagram types and notation | |
Clients, Docker, Helm, Vercel | |
MCP App viewer and publishing | |
Configuration ( | |
Enterprise SSO, audit, metrics | |
Plugins | |
Admin console |
Development
uv sync --all-groups
uv run pytest
uv run ruff check . && uv run ty check
uv run uml-mcp lint --strict --min-grade AAbout 1,800 tests, including browser tests of every interactive page inside the MCP App viewer. See Testing and CONTRIBUTING.md.
License
MIT. Maintained by Antoine Boucher. Built on PlantUML, Kroki, Mermaid, D2 and D3. Brand logos come from LobeHub Icons (MIT) and remain trademarks of their owners.
Available Tools
7 toolsdownload_diagramDownload DiagramCRead-onlyIdempotent
Download source, SVG, PNG, PDF or HTML chunks. Repeat sha256 on follow-ups.
Inputs: code (required), diagram_type (required), theme, offset, +2 more. Returns: chunk, total, offset, sha256, +3 more
generate_umlGenerate DiagramAIdempotent
Render diagram source into an image. Returns url (render link), playground (source editor), display_markdown (chat embed), content_base64/mime_type when bytes are fetched and local_path for a saved file. Prefer SVG in MCP Apps.
Inputs: code (required), diagram_type (required), scale, theme, +2 more. Returns: Diagram render result.
generate_uml_batchGenerate Diagram BatchAIdempotent
Render several diagrams in one call; a failed item does not stop the others. Inline previews share one 48k budget; later items load when opened.
Inputs: items (required), output_dir. Returns: Structured output for generate_uml_batch.
generate_uml_imageGenerate Diagram ImageBIdempotent
Render a diagram as MCP ImageContent for chat with a bounded inline preview. Returns content_base64, mime_type, render and playground links. Fetches bytes even under URL-only. Large images use a PNG thumbnail in MCP Apps.
Inputs: code (required), diagram_type (required), scale, theme, +1 more. Returns: Diagram render result.
list_diagram_typesList Diagram TypesARead-onlyIdempotent
Find types by text, backend or format. Returns diagram_type keys with backend, description and formats.
Inputs: limit, query, backend, output_format. Returns: Dynamic diagram type map returned by list_diagram_types.
rerender_diagramRe-render DiagramARead-onlyIdempotent
Render the viewer’s diagram source again with the selected theme and format. Returns content_base64, mime_type, url, playground, and display_markdown. Hidden from the model; callable from ui://uml-mcp/diagram-viewer via tools/call.
Inputs: code (required), diagram_type (required), scale, theme, +1 more. Returns: Diagram render result.
validate_umlCheck Diagram SourceARead-onlyIdempotent
Validate diagram type, format, and syntax locally (no render). Returns valid, errors, warnings, suggestions, and diagnostics; prepared_code is normalized source and changes explains normalization. Set strict=true for extra Mermaid/D2 checks.
Inputs: code (required), diagram_type (required), strict, output_format. Returns: Structured output for validate_uml.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
generate_uml, generate_uml_image, and generate_uml_batch all render diagrams, distinguished mainly by return channel and batching rather than a clearly separate purpose. Descriptions help, but an agent could easily choose the wrong rendering variant.
Names are consistently snake_case verb_noun and follow a readable pattern. Minor inconsistency between 'uml' and 'diagram' as the noun, plus the compound generate_uml_image/batch names, but no chaotic mixing.
Seven tools is well-scoped for a UML rendering server, covering discovery, validation, rendering, and download without bloat. Each tool has a plausible place in the workflow.
The set covers type discovery, local validation, single/batch/inline rendering, and download, so the core render lifecycle is complete. It lacks persistent diagram management or a source-editing/update operation, though that may be outside the server's scope.
Maintenance
Related MCP Connectors
Generate cloud architecture diagrams, flowcharts, and sequence diagrams.
Render, validate, encode/decode PlantUML diagram-as-code; 22 diagram types. Free, no auth.
Manage SysML2 projects; check, evaluate, verify, query, document and diagram models.
SysML v2 systems engineering: generate, verify, simulate and export system models from text.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables AI-driven graphical diagram creation and manipulation using natural language, with support for BPMN workflows, analysis, and manual editing via the Model Context Protocol.1MIT
- AlicenseCqualityDmaintenanceEnables AI models to create and manage various types of diagrams (flowcharts, UML, network diagrams, etc.) via the Model Context Protocol.266MIT
- AlicenseNot gradedqualityDmaintenanceGenerates technical documentation and diagrams (C4, UML, flowcharts, Gantt, etc.) using MCP protocol, with Docker-based tooling and optional AI image generation via DALL-E 3.2MIT
- AlicenseAqualityDmaintenanceModel Context Protocol server that lets AI agents drive StarUML programmatically — generate UML diagrams, execute commands, and manage elements and projects via HTTP.21141 npm1MIT



















































