Drawx Mcp Server

io.github.SaharshPamechaPublished by GitHub account SaharshPamechav0.1.1Updated Oct 24, 2026

Generate draw.io diagrams and architecture designs from natural language, via the DrawX API.

VerifiedSTDIODesktop onlyDeveloper ToolsMedia & Design

Overview

AI-generated overview

A local MCP server that lets an assistant generate draw.io diagrams and architecture designs from natural-language prompts through the DrawX API.

What you can do
Generate draw.io XML from a natural-language prompt, optionally modifying existing diagram XML and choosing a speed/quality mode (flash, pro, ultra). Produce architecture designs from a brief, with high-level design, optional low-level design and design document, and a cloud style such as cloud-agnostic, AWS, Azure or GCP. Check the API key's account, plan, API tier and remaining monthly quota.
When to use it
Useful when you want an assistant to draft draw.io diagrams or architecture design documents inside Claude Desktop, Cursor or VS Code without drawing them by hand. Best suited to users with a paid DrawX plan who already work with diagrams.net or .drawio files.
Requirements
Runs locally over stdio via the npm package @drawx/mcp-server (Node.js 18+), or through npx without installing. Requires a DrawX API key in the DRAWX_API_KEY environment variable; the optional DRAWX_API_BASE variable overrides the API base URL. Network access to the DrawX API is needed.
Before you install
The DrawX API key (DRAWX_API_KEY) is a paid credential stored in the MCP client configuration. API access is a paid feature on a separate metered tier with a monthly call quota and a per-minute rate limit, so usage consumes quota. Prompts and diagram briefs are sent to the DrawX API.

Installation

In SourceWeft

  1. Open Drawx Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@drawx/mcp-server

[npm version] [CI] [license: MIT]

Generate draw.io diagrams and architecture designs from inside Claude, Cursor, or VS Code.

DrawX MCP is a Model Context Protocol server that gives your AI assistant three tools:

  • generate_diagram — one-shot: natural-language prompt → complete draw.io XML.
  • architect_design — from a brief, produce a High-Level Design diagram (optionally an LLD + design doc).
  • whoami — verify your API key + see remaining quota.

Behind the scenes it calls the DrawX public API, so output matches the DrawX web app exactly.


Requirements

  • Node.js 18+
  • A DrawX API key — create one in DrawX → Settings → API keys. Keys start with drawx_live_. API access is a paid feature (bundled with the DrawX Pro plan).

Install

bash
npm install -g @drawx/mcp-server

Or, if your MCP client supports npx, no install is needed — reference npx @drawx/mcp-server directly.

Configure your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "drawx": {      "command": "npx",      "args": ["-y", "@drawx/mcp-server"],      "env": {        "DRAWX_API_KEY": "drawx_live_..."      }    }  }}

Restart Claude Desktop. In a new chat, ask "Draw me a microservices checkout flow" — Claude will call generate_diagram and show the resulting XML.

Cursor

Edit ~/.cursor/mcp.json:

json
{  "mcpServers": {    "drawx": {      "command": "npx",      "args": ["-y", "@drawx/mcp-server"],      "env": { "DRAWX_API_KEY": "drawx_live_..." }    }  }}

VS Code (Copilot MCP)

Add to your workspace or user settings.json:

json
{  "mcp": {    "servers": {      "drawx": {        "command": "npx",        "args": ["-y", "@drawx/mcp-server"],        "env": { "DRAWX_API_KEY": "drawx_live_..." }      }    }  }}

Environment variables

VariableRequiredPurpose
DRAWX_API_KEYyesYour DrawX API key (drawx_live_...).
DRAWX_API_BASEnoOverride the API base URL (default https://getdrawx.com/api/v1). Useful for staging.

Tools reference

generate_diagram

Turn a description into draw.io XML.

Inputs

  • prompt (string, required) — what to draw.
  • mode — "flash" (default), "pro", or "ultra". Trades speed for quality.
  • previousXml — an existing mxfile to modify.

Output — assistant text: a summary line (model, tokens, cost) followed by the full <mxfile>...</mxfile> XML in a fenced code block. Paste the XML into diagrams.net or save as .drawio.

architect_design

Run the DrawX Architect Co-Pilot on a brief. Streams intermediate progress; returns a JSON payload with hld (and optional lld, doc).

Inputs

  • brief (string, required, ≥ 20 chars) — what to design.
  • depth — "hld", "hld_lld" (default), or "hld_lld_doc".
  • style — "cloud_agnostic" (default), "aws", "azure", or "gcp".
  • mode — "flash" (default), "pro", or "ultra".

whoami

No inputs. Returns your email, plan, API tier, and remaining monthly API quota.

Quota + rate limits

API usage is metered on a separate tier from your in-app usage. Pro subscribers get 200 API calls / month. The rate limit is 60 requests / minute. On the free plan, API access is not enabled — upgrade at getdrawx.com.

Local development

bash
git clone https://github.com/SaharshPamecha/drawx-mcp-servercd drawx-mcp-servernpm installnpm run buildDRAWX_API_KEY=drawx_live_... node dist/index.js  # runs over stdio; use an MCP inspectornpm test

License

MIT © 2026 DrawX

Source: README.md at commit f6abe22

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts