Archform
MCP server that renders and validates diagrams as code, from Mermaid to BPMN
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.2.2
- Listing updated
- today
Similar MCP servers
About Archform
Archform is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
Archform gives an assistant three read-only tools: list the supported formats, render a diagram and validate its source. Eight formats are covered: Mermaid, PlantUML, C4-PlantUML, Graphviz, D2, Structurizr, BPMN and Excalidraw. Rendering returns SVG or PNG plus a shareable link; invalid source returns the parser message and line.
Rendering is done by Kroki, and by default diagram source is sent to the public kroki.io service. The README advises self-hosting Kroki and setting KROKI_URL if diagrams are sensitive, and includes a docker-compose example.
It runs locally over stdio for Claude Desktop, Claude Code, Cursor and VS Code, or as a stateless Streamable HTTP endpoint for ChatGPT developer mode. The HTTP mode binds to localhost by default, has DNS-rebinding protection and rate limits tool calls; source is capped at 100 KB. It needs Node.js 22 or later and is MIT-licensed.
Install
Run in a terminal
claude mcp add archform -- npx -y @archform/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"archform": {
"command": "npx",
"args": [
"-y",
"@archform/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"archform": {
"command": "npx",
"args": [
"-y",
"@archform/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"archform": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@archform/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"archform": {
"command": "npx",
"args": [
"-y",
"@archform/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"archform": {
"command": "npx",
"args": [
"-y",
"@archform/mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
KROKI_URLKroki server used for rendering. Defaults to the public https://kroki.io; set it to a self-hosted instance to keep diagram source private.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- list_formats
- Lists supported formats with aliases, outputs and examples
- render_diagram
- Renders diagram source to SVG or PNG with a share link
- validate_diagram
- Checks source and returns errors with line numbers
What it does
- Eight diagram formats
- Mermaid, PlantUML, C4, Graphviz, D2, Structurizr, BPMN and Excalidraw.
- Render to image
- Produces SVG or PNG and a shareable link.
- Validate source
- Returns whether a diagram is valid with line-level errors.
- Self-hostable rendering
- Point KROKI_URL at your own Kroki instance.
- Stdio or HTTP
- Runs locally or as a stateless remote endpoint.
- Rate limits
- Configurable overall and per-client limits on tool calls.
Good for
- Draw a C4 context diagram from a prompt
- Turn a Prisma schema into an ER diagram
- Check diagram source for syntax errors
- Keep diagram source private by self-hosting Kroki
Pricing
Open source
MIT licence
Archform FAQ
Is my diagram source sent anywhere?
By default to the public kroki.io; set KROKI_URL to a self-hosted Kroki to avoid that.
Which formats are supported?
Mermaid, PlantUML, C4-PlantUML, Graphviz, D2, Structurizr, BPMN and Excalidraw.
What are the requirements?
Node.js 22 or later.
Can ChatGPT use it?
Yes, via the HTTP mode as a connector in developer mode with no authentication.
Is Archform free?
Yes. Archform is open source, so you can use and self-host it for free.
How do I add Archform to Claude Code?
Run this command in your terminal: claude mcp add archform -- npx -y @archform/mcp
What are the best alternatives to Archform?
The closest alternatives to Archform are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


