# Archform

> Archform is an open-source MCP server for design and media. MCP server that renders and validates diagrams as code, from Mermaid to BPMN. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/himanshu-mamgain/archform/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.himanshu-mamgain/archform
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add archform -- npx -y @archform/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "archform": {
      "command": "npx",
      "args": [
        "-y",
        "@archform/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "archform": {
      "command": "npx",
      "args": [
        "-y",
        "@archform/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "archform": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@archform/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "archform": {
      "command": "npx",
      "args": [
        "-y",
        "@archform/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "archform": {
      "command": "npx",
      "args": [
        "-y",
        "@archform/mcp"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/archform
