zumen-gate-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@zumen-gate-mcp inspect floor-plan.jww and list its layers, scale and texts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
zumen-gate-mcp
An MCP server and command-line tool for the zumen-gate drawing API. It lets Claude and other MCP clients read, search, render, edit and convert CAD drawings: Jw_cad (JWW), DWG, DXF, SXF (SFC/P21), PDF, and more.
Read: format, paper, scale, layers, entity counts and texts of a drawing.
Search: entities by layer, kind, text or area, with lengths and areas in real millimetres.
Render: a PNG of the drawing or a part of it, with the pixel-to-coordinate mapping.
Edit: change texts, layers, colors and coordinates, delete and add entities, or draw a new JWW or DXF from scratch, then write it back in its original format.
Convert: between drawing formats (DXF, DWG, JWW, SFC, P21, PDF, SVG, PNG, and STL/OBJ/STEP for 3D models).
Reading and converting run on the zumen-gate API with a deterministic CAD engine (no generative AI on the server). Edits run locally on a working copy of the drawing.
Get an API key
Register for free at zumen-gate.com and create a key under Account → API keys. The free plan includes a monthly allowance of calls; see the price list for paid outputs and more calls.
Related MCP server: QCAD MCP
Install
You need uv (uvx runs the server
without a separate install). Replace zg_live_... with your key. --root is the folder whose
drawings the tools may read; outputs are written to zumen-gate-out/ inside it.
Claude Code
claude mcp add zumen-gate -e ZUMEN_GATE_API_KEY=zg_live_... -- uvx zumen-gate-mcp --root .Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and other
clients that use the same format:
{
"mcpServers": {
"zumen-gate": {
"command": "uvx",
"args": ["zumen-gate-mcp", "--root", "/path/to/drawings"],
"env": { "ZUMEN_GATE_API_KEY": "zg_live_..." }
}
}
}Codex (~/.codex/config.toml)
[mcp_servers.zumen-gate]
command = "uvx"
args = ["zumen-gate-mcp", "--root", "/path/to/drawings"]
env = { ZUMEN_GATE_API_KEY = "zg_live_..." }VS Code
code --add-mcp '{"name":"zumen-gate","command":"uvx","args":["zumen-gate-mcp","--root","${workspaceFolder}"],"env":{"ZUMEN_GATE_API_KEY":"zg_live_..."}}'Claude Code plugin: this repository is also a plugin with a skill that teaches the model how to
work with drawings. Add it with /plugin from a marketplace that lists it, or copy
skills/zumen-gate/SKILL.md into your project's .claude/skills/.
Tools
Tool | What it does | Calls |
| Formats, extensions, which can be read and written, paid outputs | 0 |
| Summary: format, paper, scale, layers, counts, texts | 1 |
| Entities matching layer / kind / text / area, with totals | 1 |
| PNG image and pixel-to-coordinate mapping | 1 |
| Local edits on a working copy, blank drawings, undo | 0 (1 the first time) |
| Convert and save the outputs | 1, or 10 for paid outputs |
| State of a long conversion | 0 |
| Calls left, expiry dates, this month's use | 0 |
Every answer includes the calls counted and the calls left. Writing JWW, DWG, SFC, P21 or STEP is a paid output; without enough paid calls the conversion returns a preview and a loss report instead.
Command line
The same operations are available as zumen-gate:
export ZUMEN_GATE_API_KEY=zg_live_...
zumen-gate inspect plan.jww
zumen-gate query plan.jww --layer 壁 --kind LINE
zumen-gate render plan.jww --bbox 0 0 120 80
zumen-gate edit plan.jww --ops '[{"op": "replace_text", "pattern": "Old Co.", "replacement": "New Co."}]'
zumen-gate convert *.jww --to dxf
zumen-gate accountSettings
Setting | Meaning |
| Your API key (required, except for |
|
|
| The working folder (default: the current folder) |
| Return |
How files are handled
Only files inside
--rootare read; symbolic links that lead outside are refused. Files are sent only if their extension (and, where the format has one, their signature) says they are drawings.The original drawing is never modified. Edits are kept as versions in
.zumen-gate/inside the working folder; outputs go tozumen-gate-out/.Text read from drawings is marked as data for the model, not instructions.
See the zumen-gate terms and privacy policy for how the API handles uploaded drawings.
Development
uv sync
uv run pytest
uv run ruff check src testsLicense
MIT
Available Tools
8 toolsaccount_statusARead-only
Calls left in each allowance with expiry dates, this month's use, and the price list. Uses no calls.
Inputs: no named parameters.
convert_drawingA
Convert a drawing (or its working copy) and save the outputs in the output folder (zumen-gate-out by default). Returns the saved paths and the main losses. Uses 1 call; writing JWW, DWG, SFC, P21 or STEP uses 10, and without enough paid calls returns only a preview and the loss report.
to: dxf, dwg, jww, sfc, p21, pdf, svg, png, ir, or for 3D models stl, obj, step, glb. version: the output version (e.g. a DWG version). scale: the output scale like "1/100". pages: for PDF input, pages like "1-3". A conversion longer than 40 s returns a job_id; call get_job with it.
Inputs: to (required), path (required), pages, scale, +3 more.
edit_drawingA
Edit a drawing locally (no calls, except 1 the first time to fetch the drawing as IR). Every edit is saved as a new version of the working copy; the original file is never changed. Returns the counts changed, the IDs and real lengths of added entities, and the version.
ops: a list of operations, applied all or nothing: {"op": "set", "ids": [...] or "where": {"layer"|"kind"|"text": ...}, "fields": {...}} fields: layer, color (0-256 or "#RRGGBB"), linetype, lineweight_mm, or the kind's geometry and text fields (p1, p2, center, radius, insert, height, text...). {"op": "delete", "ids": [...]} or with "where" {"op": "replace_text", "pattern": "old", "replacement": "new", "where": {...}?, "regex": false} {"op": "add_layer", "name": "walls", "color": 5} {"op": "add", "entities": [{"kind": "LINE", "layer": "walls", "p1": [0, 0], "p2": [36.4, 0]}]} kinds: LINE, CIRCLE, ARC, POINT, LWPOLYLINE, TEXT, MTEXT. Coordinates are drawing units (see inspect_drawing; for Jw_cad, millimetres on paper). To pick by area, get IDs with query_drawing first. No geometric operations (move, copy, offset): compute new coordinates and use set or add. create: start a blank drawing at path (which must not exist): {"format": "jww" or "dxf", "paper": "A3", "scale": "1/100", "layers": ["walls", "text"]} undo: go back one version. reset: discard the working copy (start again from the file).
Inputs: path (required), ops, undo, reset, +1 more.
get_jobBRead-only
The state of a long conversion started by convert_drawing or edit_drawing: running (with elapsed seconds), or done with the saved outputs, or the error. Uses no calls.
Inputs: job_id (required).
inspect_drawingARead-only
Summarize a drawing: format and version, paper, coordinate units and scale (real mm per unit; for Jw_cad per layer group), bounding box, entity counts by kind, layers, the first texts, sheets or pages, and what could not be read. Uses 1 call.
path: a drawing file inside the working folder (or an .ir.json.gz file). use_edits: send the working copy if edit_drawing made one (default true). pages: for PDF, pages like "1-3,5". sheet: a sheet or layout name if the drawing has several.
Inputs: path (required), pages, sheet, use_edits.
list_formatsARead-only
List the drawing formats: extensions, which can be read (2D or 3D) and written, which outputs are paid (use 10 calls), and which are beta. Uses no calls and needs no API key.
Inputs: no named parameters.
query_drawingARead-only
List entities matching all given conditions, with IDs, layers, kinds, texts and lengths, plus totals (count, length and area, also in real mm). Uses 1 call.
layer / kind: one name or a list (kinds: LINE, ARC, CIRCLE, LWPOLYLINE, TEXT, MTEXT, INSERT, DIMENSION, HATCH...). text: a substring of the entity text (text_regex=true for a regular expression). bbox: [xmin, ymin, xmax, ymax] in drawing coordinates; bbox_mode "intersects" (default) or "within". ids: entity IDs. include_entities: also return each entity in IR form (use it as a model for edit_drawing's add). limit: 1-500 (default 50); pass next_cursor back as cursor for the next page. Narrow by layer or bbox first.
Inputs: path (required), ids, bbox, kind, +8 more.
render_drawingBRead-only
Draw the drawing (or part of it) as a PNG image and return it with the mapping from pixels to drawing coordinates. The PNG is also saved in the output folder. Uses 1 call.
bbox: [xmin, ymin, xmax, ymax] to zoom in. layers: only these layers. highlight_ids: entity IDs to mark. width_px: the long side in pixels (default 1600, at most 2576).
Inputs: path (required), bbox, layers, width_px, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct action on a drawing (inspect, query, render, edit, convert) or a distinct auxiliary concern (account_status, list_formats, get_job). The only mild overlap is between inspect_drawing and query_drawing, since both summarize entities, but the descriptions clarify that one is a whole-file overview and the other is a filtered entity listing with pagination. Boundaries are otherwise clear.
The dominant pattern is a clean verb_noun scheme: inspect_drawing, query_drawing, render_drawing, edit_drawing, convert_drawing, list_formats, get_job. The single deviation is account_status, which is noun-first rather than verb-first, but it is still readable and unambiguous. Minor inconsistency only.
Eight tools is well-scoped for a CAD gateway: five drawing operations plus three supporting utilities (formats, account, job polling). Each tool earns its place, and the async job tool is justified by the long-running conversion path. No bloat and no obviously thin area.
The lifecycle is well covered: discover formats, inspect, query, render, edit (set/delete/replace_text/add_layer/add/create/undo/reset), convert, and poll long jobs, with billing visibility. The main gaps are the explicit absence of geometric operations (move, copy, offset) and no way to list or manage prior working-copy versions beyond undo/reset, though both have documented workarounds.
Related MCP Connectors
JusPronto is case-management software for Brazilian law firms. Its remote MCP server (OAuth 2.1 with PKCE, per-permission scopes, audit log) lets Claude and ChatGPT read the firm's own cases, deadlines, agenda, recent court movements and case files with the page cited. Write actions require the lawyer's approval. Requires a JusPronto account.
MCP server for the PDFGate API. Generate PDFs, manage documents and handle e-signatures.
Lets your AI build and edit websites in Xodia, a visual website builder for real code (Vite, React, Tailwind CSS or plain HTML in your own git repo): read and write site files, create pages and CMS collections, run typecheck, design and link checks, take screenshots, manage forms and translations, and pick up change requests the user sends from the visual editor. Sign in once with your Xodia account (OAuth). Free plan, no card needed. Setup: https://xodia.ai/ai/mcp
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read and edit ZWCAD drawings directly, including summarizing drawings, querying layers and entities, reading dimensions and text, and creating lines, text, and blocks.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to automate 2D architectural drafting and CAD file management, including DXF/DWG parsing, SVG/PNG/PDF rendering, wall extrusion to 3D STL meshes, room and beam analysis, block/script library access, and persistent depot storage via a REST API and MCP tools.18MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to control CAD applications like AutoCAD, ZWCAD, GstarCAD, and BricsCAD through natural language or direct tool calls. Supports drawing, layer and entity management, block operations, data export, and file handling via 7 unified MCP tools covering 56 CAD commands.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants like Claude for Desktop or Cursor to control supported CAD applications through MCP, supporting drawing, layer and entity management, block operations, data export, and file/session control via natural language or unified tool calls.-