Draughtsman
Self-hosted diagramming server whose diagrams AI agents can read, patch and render
- 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.0Add to claude_desktop_config.json
{
"mcpServers": {
"draughtsman": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/wroolie/draughtsman:0.1.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"draughtsman": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/wroolie/draughtsman:0.1.0"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools