# Arc

> Arc is a free MCP server for design and media. Author, lay out, render and diff architecture diagrams as code from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API
- **Website:** https://hudsonkit.com/arc
- **Repository:** https://github.com/hudsonkit/arc/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.hudsonkit/arc
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Arc stores a system diagram as typed, diffable data, and this stdio server hands an AI agent the whole toolchain around it. An agent can validate a diagram and get coded diagnostics with supported fixes, run auto-layout, and compare two versions to get a structural delta that can drive a diff render.

Rendering covers deterministic SVG in eleven themes, PNG through a local Chrome or Chromium, GIF or MP4 flow animation (which also needs ffmpeg), embeddable React, iframe or standalone HTML, and Unicode box art for terminals. It can also emit a TypeScript module of the diagram.

A second set of tools supports live work: an agent opens a live view, declares the canvas, nodes or region it is working on, publishes complete revisions with stable node ids, and finishes. Architecture reviews can be saved with findings, evidence and decisions and shared by link. It needs Node.js 22 or newer and no account or API key.

## Features

- **Validate with fixes:** Returns coded diagnostics for a diagram and lists supported fixes to apply and re-check.
- **Auto layout:** Lays out a full diagram or minimal node and connector input.
- **Multi-format rendering:** Exports SVG, PNG, GIF, MP4, HTML embeds and ASCII box art.
- **Structural diff:** Computes a delta between two diagram versions for a diff render.
- **Live diagram view:** Streams validated revisions to a shared view while declaring the scope of the work.
- **Architecture reviews:** Saves a baseline plus findings, evidence and decisions, with a revocable share link.

## Good for

- Have an agent draw and update a system diagram as the code changes
- Check a diagram for errors before committing it
- Show a before and after of an architecture change
- Put a diagram in a terminal-friendly or README form
- Run a documented architecture review

## Install

### Claude Code (Terminal)

```sh
claude mcp add arc -- npx -y @hudsonkit/arc-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `validate_diagram`: Coded diagnostics for diagram data with supported fixes.
- `auto_layout`: Auto-layout a full diagram or minimal input.
- `diff_diagram`: Structural delta between two diagrams.
- `render_svg`: Deterministic SVG export in eleven themes.
- `render_png`: PNG raster via a local Chrome or Chromium.
- `render_animation`: GIF or MP4 flow animation to an output path.
- `render_html`: React snippet, iframe embed or standalone HTML page.
- `render_ascii`: Unicode or ASCII box-art rendering.
- `diagram_to_typescript`: Emit a typed diagram TypeScript module.
- `editor_handoff`: Build URLs that open the diagram in the Arc studio.
- `open_live_diagram`: Open a live architecture view and return its URL and session id.
- `begin_live_diagram_work`: Declare work with a summary and scope before starting it.
- `update_live_diagram`: Publish a complete validated revision to the view.
- `finish_live_diagram_work`: Finish the current work id and leave the view idle.
- `end_live_diagram`: Mark the diagram complete and keep the final view.
- `open_architecture_review`: Save a baseline and open a durable architecture review.
- `update_architecture_review`: Save findings, evidence, decisions, questions and summary.
- `resume_architecture_review`: Resume an interrupted review.
- `revoke_architecture_review_share`: Invalidate the old viewer link and return a new capability.

## FAQ

### What does it need installed?

Node.js 22 or newer; PNG export needs Chrome or Chromium, and animations also need ffmpeg.

### Do I need an account?

No account, API key or environment configuration is required, per the README.

### How do I run it?

Run npx -y @hudsonkit/arc-mcp, or add it to a client such as Claude Code with claude mcp add.

### Which export formats exist?

SVG, PNG, GIF, MP4, HTML, a React snippet, ASCII and a TypeScript module.

### Is Arc free?

Yes. Arc is free to use.

### How do I add Arc to Claude Code?

Run this command in your terminal: claude mcp add arc -- npx -y @hudsonkit/arc-mcp

### What are the best alternatives to Arc?

The closest alternatives to Arc are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## 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.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

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