# Draughtsman

> Draughtsman is an open-source MCP server for developer tools. Self-hosted diagramming server whose diagrams AI agents can read, patch and render. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, Web, Linux, macOS, Windows, CLI, API
- **Website:** https://draughtsman.overpass.co.uk
- **Repository:** https://github.com/overpassapps/draughtsman
- **MCP Registry name:** io.github.overpassapps/draughtsman
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Diagrams here are stored as a typed graph of nodes and edges rather than as shapes on a canvas, and the graph prints to a lossless text form called the Draughtsman DSL. That text can be edited and parsed back with nothing lost, so a diagram can live in git beside the code and a diff command describes changes in plain sentences.

The built-in MCP server exposes eight tools over HTTP at /mcp, or over stdio. Agents patch diagrams with addressable operations such as updateNode, addNode and addEdge instead of replacing the whole document, and an unknown operation fails the call without writing anything. A checkpoint is taken before every agent write, and an open editor updates when the agent writes.

It runs from one container or executable with SQLite by default or Postgres, and the default setup makes no outbound connection. Access needs a bearer token created under Tokens in the web app. The code is under AGPL-3.0, and the README notes no image is published to a registry yet, so you build it from the repository.

## Features

- **Typed graph model:** Four document types (flowchart, architecture, freeform, sequence) with kind vocabularies agents can query.
- **Lossless text DSL:** Print a diagram as text, edit it and parse it back unchanged.
- **Patch operations:** Agents change diagrams with addressable operations, never whole-document replacement.
- **Plain-sentence diffs:** A diff command describes changes between two diagrams for pull requests.
- **Checkpoints before agent writes:** History can restore the diagram as it was before an agent edited it.
- **Self-hosted, no telemetry:** Runs with SQLite or Postgres and makes no outbound connection by default.

## Good for

- Let a coding agent keep an architecture diagram in sync with the code
- Review diagram changes in a pull request as text
- Run diagramming inside a network with no internet access
- Have an agent critique or compare two versions of a system diagram

## Install

### Claude Code (Terminal)

```sh
claude mcp add draughtsman -- docker run -i --rm docker.io/wroolie/draughtsman:0.1.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "draughtsman": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/wroolie/draughtsman:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "draughtsman": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/wroolie/draughtsman:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "draughtsman": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/wroolie/draughtsman:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "draughtsman": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/wroolie/draughtsman:0.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "draughtsman": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/wroolie/draughtsman:0.1.0"
      ]
    }
  }
}
```

## Tools

- `get_schema`: Returns the kind vocabularies for each document type so an agent knows which node and edge kinds to use.

## FAQ

### How does an agent authenticate?

With a bearer token created under Tokens in the web app, in the form dst_...

### Which transports are supported?

HTTP at /mcp and stdio via the draughtsman mcp --stdio command.

### Which databases can it use?

SQLite by default, or Postgres.

### What licence is it under?

AGPL-3.0.

### Is there a published Docker image?

The README says no image is published to a registry yet, so you build it from the repository.

### Is Draughtsman free?

Yes. Draughtsman is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add draughtsman -- docker run -i --rm docker.io/wroolie/draughtsman:0.1.0

### What are the best alternatives to Draughtsman?

The closest alternatives to Draughtsman are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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