# Archboard MCP server

> Lets an AI assistant create, read, and edit architecture, flow, and ER diagrams on a live shared canvas.

- Repository: https://github.com/getarchboard/archboard-plugin
- Page: https://hostedmcp.org/servers/getarchboard/archboard-plugin
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.64.0

## Install

### Claude Code

```sh
claude mcp add --transport http archboard-plugin https://getarchboard.app/mcp
```

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

```json
{
  "mcpServers": {
    "archboard-plugin": {
      "url": "https://getarchboard.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "archboard-plugin": {
      "type": "http",
      "url": "https://getarchboard.app/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"archboard-plugin","type":"http","url":"https://getarchboard.app/mcp"}'
```

### Codex

```sh
codex mcp add archboard-plugin --url https://getarchboard.app/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.archboard-plugin]
url = "https://getarchboard.app/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http archboard-plugin https://getarchboard.app/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "archboard-plugin": {
      "url": "https://getarchboard.app/mcp",
      "type": "http"
    }
  }
}
```

## Tools (19)

- `read_me`
- `list_workspaces`
- `list_diagrams`
- `create_diagram`
- `get_canvas`
- `search_node_types`
- `get_node_type`
- `apply_ops`
- `compose_diagram`
- `add_image`
- `upload_image`
- `render_snapshot`
- `export_diagram`
- `get_selection`
- `set_status`
- `revert_change`
- `delete_diagram`
- `search_shapes`
- `show_diagram`

## FAQ

### How does the AI interact with my diagrams?

The assistant can read, create, and edit diagrams on the same live canvas your team uses, using structured node types rather than static pictures.

### Can I undo changes made by the AI?

Yes, changes made by an app are kept in the diagram's change log and can be undone for up to 7 days.

### Does Archboard provide its own AI model?

No, Archboard does not include an AI model; it connects to the assistant provided by the app you have connected.
