# ArchSmith

ArchSmith lets an agent validate architecture data in JSON and render it as an SVG diagram. Use it when a coding agent needs to create or check an architecture view.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: ayeshLK
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ayeshLK/archsmith/tree/HEAD/packages/mcp-server
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/archsmith

## What it does

The server gives an agent tools to retrieve the JSON Schema and registries, validate a diagram description, and render an SVG. Validation runs before rendering. It communicates over stdio and calls the renderer functions directly rather than wrapping the CLI.

Font embedding is off by default. With `embedFonts` enabled, an SVG may exceed 25,000 bytes; the server then returns a resource link, which the host can read with `resources/read`. Render links live in memory, and older entries can be evicted after 20 newer renders. That matters if an agent needs to fetch a result later.

To connect it to Claude Code, run `claude mcp add archsmith -- npx -y @archsmith/mcp-server`. The server also supports Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add archsmith -- npx -y @archsmith/mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server -- npx -y @archsmith/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@archsmith/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@archsmith/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-server npx -y @archsmith/mcp-server
```

## When to use it
- validate an architecture diagram described in JSON
- render an architecture description as SVG
- retrieve the current JSON IR schema for an agent
- look up available governed registries

## Example prompts
- Check this JSON architecture description and report validation errors.
- Render an SVG diagram from this architecture description.
- Get the current JSON IR schema and draft an architecture description that follows it.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md