How do I install DrillFlow?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does DrillFlow need an API key?

The publisher lists these environment variables: DRILLFLOW_TOKEN, DRILLFLOW_API_URL.

What transport does DrillFlow use?

DrillFlow runs locally over stdio.

When was DrillFlow last checked?

Last checked 2026-11-08. Publish drill-down diagrams from an agent; every Mermaid subgraph becomes a level you enter.

DrillFlow MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

DRILLFLOW_TOKEN — A 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_URL — Override the API origin. Defaults to https://api.drillflow.de; only useful against staging.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1DRILLFLOW_TOKEN=<secret> DRILLFLOW_API_URL=<value> claude mcp add de.drillflow-mcp -- npx -y drillflow-mcp@1.0.96

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "de.drillflow-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "DRILLFLOW_TOKEN": "<secret>",11        "DRILLFLOW_API_URL": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.96

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

Tool	What it does
`publish_diagram`	Publishes a DrillFlow document, returns the share URL.
`publish_mermaid`	Converts a Mermaid flowchart (subgraphs → subflows) and publishes it.
`read_diagram`	Reads 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

Variable	Meaning
`DRILLFLOW_TOKEN`	An API token from Your account → API tokens at app.drillflow.de. Optional.
`DRILLFLOW_API_URL`	Defaults 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].

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install DrillFlow?

Does DrillFlow need an API key?

What transport does DrillFlow use?

When was DrillFlow last checked?

Documentation

drillflow-mcp

Install

Tools

Configuration

Format

Building

Licence

Issues