mcpField
D
DrillFlow

DrillFlow

Local
drillflow.deMedia & Design0Updated 2d ago
RepositoryVisit website

About DrillFlow

DrillFlow is an MCP server for turning Mermaid flowcharts into navigable hierarchical diagrams and publishing them as read-only links. It is intended for agents that create, share, or retrieve DrillFlow diagrams.

Key features

  1. 01Publish DrillFlow documents
  2. 02Convert and publish Mermaid flowcharts
  3. 03Turn subgraphs into navigable subflows
  4. 04Read published diagrams

Use cases

  1. 01Publish a Mermaid flowchart as a hierarchical diagram
  2. 02Share a read-only diagram link
  3. 03Retrieve an existing DrillFlow diagram

MCP support

It exposes tools for publishing DrillFlow documents, converting and publishing Mermaid diagrams, and reading published diagrams to MCP clients. Publishing requires host confirmation and creates a public read-only link.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "de-drillflow": {
      "command": "npx",
      "args": [
        "-y",
        "drillflow-mcp"
      ],
      "env": {
        "DRILLFLOW_TOKEN": "<DRILLFLOW_TOKEN>",
        "DRILLFLOW_API_URL": "<DRILLFLOW_API_URL>"
      }
    }
  }
}
Run commandnpx -y drillflow-mcp
Environment variables to set
DRILLFLOW_TOKENSecretA DrillFlow API token (Pro). Without it the server still publishes, but anonymously: the link is unowned, unlistable and expires after 72 hours, and every result says when.
DRILLFLOW_API_URLOverride the API origin. Defaults to https://api.drillflow.de; only useful against staging.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmdrillflow-mcp1.0.94

Tools

3

Saved tool list · updated 2d ago

ParameterTypeRequiredDescription
documentobjectYesA complete DrillFlow document object (id, title, rootDiagramId, diagrams).

Details

From the project README

drillflow-mcp

Generated. Do not edit here. Every file in this repository is copied from the DrillFlow source repository on each release; changes made here are overwritten by the next sync. Please open issues rather than pull requests.

An MCP server for DrillFlow — the diagram editor built around drill-down, where a node can own a whole sub-diagram you navigate into.

With this server an agent can turn a Mermaid flowchart into a real hierarchical diagram, publish it to a shareable read-only link, and read published diagrams back. Every subgraph becomes a subflow a reader can actually open, which is what a flat picture cannot do.

Install

Claude Desktop (claude_desktop_config.json) or any MCP host:

{
  "mcpServers": {
    "drillflow": {
      "command": "npx",
      "args": ["-y", "drillflow-mcp"],
      "env": { "DRILLFLOW_TOKEN": "dfp_…" }
    }
  }
}

Claude Code:

claude mcp add drillflow --env DRILLFLOW_TOKEN=dfp_… -- npx -y drillflow-mcp

Node 20 or newer.

Tools

ToolWhat it does
publish_diagramPublishes a DrillFlow document, returns the share URL.
publish_mermaidConverts a Mermaid flowchart (subgraphs → subflows) and publishes it.
read_diagramReads a published diagram back as its document — share URL, @handle/name address or slug.

Publishing puts the diagram on a public read-only URL that anyone holding the link can open. Nothing is published without the host asking you first.

Configuration

VariableMeaning
DRILLFLOW_TOKENAn API token from Your account → API tokens at app.drillflow.de. Optional.
DRILLFLOW_API_URLDefaults to https://api.drillflow.de.

Without a token the server publishes anonymously, and says so in every result: nobody owns the link, it cannot be listed or revoked, and it stops working after 72 hours (the result names the exact time). With a token the link belongs to your account — listed under My shared links, renameable, revocable, no expiry.

Format

The document format is documented at https://drillflow.de/en/format/, with a JSON Schema at https://drillflow.de/schema/drillflow-document.schema.json. There is also a Claude Skill for generating DrillFlow diagrams: capydev42/drillflow-skill.

Building

This repository holds the server's own sources, which is what the MIT licence below covers. It is not a standalone build: the package bundles a few modules from the (closed-source) DrillFlow editor — the Mermaid importer and the document validator — so the published drillflow-mcp on npm is built from the DrillFlow repository, not from here. Install it with npx; read it here.

Licence

MIT — see LICENSE. This covers the MCP server in this repository, not the DrillFlow application.

Issues

Bug reports are welcome in this repository's issue tracker, or by mail to [email protected].

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.