MCP server and API
Read, search, render, edit and convert drawings from Claude Code, other AI clients or your own programs, with the same conversion engine as zumen-gate: through the MCP server or the API.
What it does
- Read: an overview of a drawing (format, paper and scale, entity counts per layer, texts) in a form an AI can use
- Search: filter entities by layer, type, text or area, with lengths and areas in real-world units (for quantity take-off and similar work)
- Render: an image of the area you choose, so the AI can check its own work
- Convert: DXF, PDF and SVG, plus export to JWW, DWG and SXF. The same input formats as the web app
- Edit: keep a drawing locally in its intermediate form (IR), replace texts or change layers and colors, then write it back to its original format such as JWW
How you use it
- From Claude on the web, desktop or mobile, just add it as a connector (nothing to install; see the “Claude” tab)
- AI clients that support MCP (Claude Code, Claude Desktop, Cursor and others) use it through the MCP server zumen-gate-mcp, which also installs a command-line tool (zumen-gate) that does the same. Both run on your machine; reading and conversion happen on zumen-gate's servers (see the “MCP server” tab)
- Programs can use the REST API at https://api.zumen-gate.com. API keys are free; create one on your account page (see the “REST API” tab)
- The servers use no generative AI. Every call is answered by the conversion engine with deterministic computation
Use it from Claude (web, desktop and mobile)
Add zumen-gate to claude.ai as a connector to read, search, render, edit and convert drawings from Claude in your browser or phone, with nothing to install.
- Press “Add to Claude”. Claude's add-connector screen opens with the name (zumen-gate) and the URL filled in. Press “Continue”, then “Add” on the next screen without changing the settings
- Press “Connect”. A zumen-gate page opens: sign in with the 6-digit code sent to your email and allow the connection (you can create an account there)
- In the chat, ask to upload a drawing. Claude shows an upload link; after sending the drawing, tell Claude the upload is done
- Then ask things like “total the wall line lengths” or “fix this text and export it as JWW”. Outputs come back as download links
The URL, if you add it by hand (authentication is OAuth; nothing else to set):
https://api.zumen-gate.com/mcp- Works on Claude's free plan too (one custom connector). It also works in the mobile apps, but add the connector on the web or in the desktop app
- Files attached to the chat do not reach the connector. Send drawings through the upload link
- Uploaded drawings become unavailable 24 hours after the upload and are then deleted automatically. Ask Claude to delete a drawing to remove it right away
- Calls come out of your account's allowance, as with API keys (1 per read, search, render or conversion; 10 per JWW, DWG, SXF or STEP export; editing uses 1 only the first time)
- Disconnect anytime under “API & MCP” on your account page. On Team and Enterprise plans, an organization owner adds the connector first, then each member connects
Installing the MCP server
# Claude Code (zg_live_... is your key)
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 similar
{
"mcpServers": {
"zumen-gate": {
"command": "uvx",
"args": ["zumen-gate-mcp", "--root", "/path/to/drawings"],
"env": { "ZUMEN_GATE_API_KEY": "zg_live_..." }
}
}
}- You need uv (a runner for Python tools); uvx fetches what is needed and starts the server
- --root is your drawings folder. Only files inside it are read, and outputs go to zumen-gate-out inside it. The original drawings are never modified
- Eight tools: overview, search, render, edit and convert, plus the format list, the state of long conversions and the calls left. Editing happens locally and uses no calls (except one, the first time, to fetch the drawing)
- The command-line tool does the same (for example: zumen-gate convert *.jww --to dxf)
For Codex, VS Code and other clients, and for details, see the README on GitHub.
REST API
POST /v1/inspect | Overview: format, paper and scale, coordinate units, counts per layer, sample texts, what could not be read | 1 call |
POST /v1/query | Entities filtered by layer, type, text, area or ID, with total length and area (also in real-world mm) | 1 call |
POST /v1/render | A PNG of the area, layers and highlighted entities you choose, with the pixel-to-drawing mapping | 1 call |
POST /v1/convert | Conversion. Fetch outputs from GET /v1/files/…; the intermediate form (ir) is available too | 1 call (10 for JWW, DWG, SXF, STEP) |
GET /v1/usage | Calls left and their expiry, this month's usage | 0 calls |
GET /v1/formats | Supported formats (no key needed) | 0 calls |
export ZUMEN_GATE_API_KEY=zg_live_… # create one on your account page
# Overview
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" \
-F file=@plan.jww https://api.zumen-gate.com/v1/inspect
# Lines on the layer "壁" (walls); totals also come in real-world mm
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" \
-F file=@plan.jww -F 'params={"layer":"壁","kind":"LINE"}' \
https://api.zumen-gate.com/v1/query
# Convert to DXF and fetch the output
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" \
-F file=@plan.jww -F target_format=dxf "https://api.zumen-gate.com/v1/convert?locale=en"
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" -o plan.dxf \
-L https://api.zumen-gate.com/v1/files/<job_id>/plan.dxf- Send multipart form data: exactly one of a drawing file (file) or an intermediate document (ir), plus per-call fields (params as JSON). Add ?locale=en to the URL (or send Accept-Language: en) for English messages
- Every response includes the calls counted and the calls left (usage)
- One call at a time per account (a second one gets 429). Failed calls are not counted
- Calls are also rate-limited: up to 120 per minute per account, 2 open connections per account (downloads included), and 10 invalid API keys per minute from one network
- On 429 or 503, wait the number of seconds in Retry-After, then send again. Other errors come back the same if you resend the same request, so do not retry them automatically
- Long conversions can stream progress with stream=1, up to 300 seconds
- When converting to PDF, add pdf_paper=1 to make the first page the exact size of the drawing's sheet for JWW, SFC and P21 (printing at 100% gives the drawing at its scale). Without it, the whole drawing is fitted on one page
- Output files (GET /v1/files/…) are returned as a redirect (307) to a temporary storage URL. Use -L with curl. The redirect target does not need your API key
- There is no SLA and the service is provided as is. Conversion results are not guaranteed to be accurate; check them for important work (Terms, Article 2)
Try it with a sample drawing
No drawing at hand? Try our own sample: a house ground-floor plan (Jw_cad JWW, 1:100, A3, 37 KB).
- In Claude, send it through the upload link and ask, for example, “What is the scale, and which rooms are there?”, “Make a table of the swing doors and their widths, with the evidence” or “Show me an image with the swing doors highlighted”
- With the MCP server, put it in the --root folder; with the REST API, send it in place of plan.jww in the examples on the “REST API” tab
- It is our own drawing, not a real building or a customer's drawing. The texts in it are in Japanese
Pricing
| Free (account required) | 300 calls a month: read, search, render, and convert to DXF/PDF/SVG |
|---|---|
| Extra calls | ¥980 for 1,000 calls (one-time purchase, valid for 180 days) |
| Day pass (¥480) | Includes 1,500 calls for 24 hours |
| Pro (monthly) | Includes 3,000 calls a month |
- We count API calls. Listing formats, checking your balance and failed calls are not counted
- Exporting to JWW, DWG, SXF or STEP counts as 10 calls and uses extra calls, a day pass or Pro, not the free monthly calls. As in the web app, you can see the preview and loss report first
- Drawings over 10 MB can be used with extra calls, a day pass or Pro
- Prices include Japanese consumption tax. Free calls reset on the 1st of each month (Japan time). Extra calls are added as soon as payment is confirmed
Data handling
- Drawings sent through the MCP server, command-line tool or API are never used for machine learning, on any plan
- Input files are not kept after processing. Output files are deleted automatically after a short period, as on paid plans
- Drawings received through the connector for Claude and other apps (remote MCP), and the working copies of their edits, are kept on zumen-gate's servers so you can keep working with them. They become unavailable 24 hours after the upload and are then deleted automatically within about a day. You can delete them anytime
- Only what the MCP server returns (overviews, selected entities and images) reaches your AI. You do not need to send the drawing file itself to an AI service
For regular conversions, see our data policy.
AI adoption support (for companies)
We help you bring AI, including MCP, into work that involves drawings, such as quantity take-off, sorting a batch of drawings, or returning files in a customer's format.
- Consultation (30 minutes): free
- Trial (2–4 weeks): from ¥300,000. We try the work you want AI to take on with your own drawings and report the results
- Adoption: ¥600,000–¥1,200,000. We deliver procedures and AI instructions (skills) tailored to your work
- We take one engagement at a time and reply within two business days
- On-site staffing, full system development and drawing tracing are not included
Prices are a guide; we quote after hearing your needs. If you want to build conversion into your own service or internal system (annual contract, invoice billing), ask here too.