Skip to content
MCP server

Draughtsman

Self-hosted diagramming server whose diagrams AI agents can read, patch and render

Install
Pricing
Open source
Platforms
self-hosted, Web, Linux
Runs
Remotely
Version
0.1.0
Listing updated
2 days ago

About Draughtsman

Draughtsman is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "draughtsman": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/wroolie/draughtsman:0.1.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "draughtsman": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/wroolie/draughtsman:0.1.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free, AGPL-3.0

Prices change. Check draughtsman.overpass.co.uk before you buy.

Draughtsman 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 to Draughtsman

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools