API & MCP
Everything a person can do on Technical Drawing from a 3D Form Model, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://kerfwiseformdrawing.usefulweb.app/api/v1/calculate– run Technical Drawing from a 3D Form ModelGET https://kerfwiseformdrawing.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Technical Drawing from a 3D Form Model
Paste a Kerfwise Form Studio project and get a drawing sheet with front, top and side views in first- or third-angle projection, dashed hidden edges, an optional hatched section, overall or chain dimensions and a title block. Download it as SVG, DXF R12 or PDF at a true scale.
| Field | Type | Default | Description |
|---|---|---|---|
project | textarea | "{\n \"format\": \"kerfwise-form\",\n \"version\": 1,\n \"name\": \"L-shaped | Form Studio project JSON |
sheet | select (A4, A3, A2, A1, letter, tabloid) | "A3" | Sheet size |
orientation | select (landscape, portrait) | "landscape" | Orientation |
projection | select (first, third) | "first" | Projection method |
scale | select (auto, 5:1, 2:1, 1:1, 1:2, 1:5, 1:10, 1:20, 1:50, 1:100, 1:200, 1:500, 1:1000, 1:2000, 1:5000) | "auto" | Scale |
viewFront | boolean | true | Front view |
viewTop | boolean | true | Top view |
viewRight | boolean | true | Right view |
viewLeft | boolean | false | Left view |
viewBack | boolean | false | Back view |
viewBottom | boolean | false | Bottom view |
hidden | boolean | true | Draw hidden edges dashed |
dimensions | select (overall, chain, none) | "overall" | Dimensions |
sectionAxis | select (none, x, y, z) | "none" | Section plane |
sectionOffset | number | 0 | Section plane position (mm) |
sectionLabel | text | "A" | Section letter |
title | text | — | Drawing title (empty = project name) |
drawnBy | text | — | Drawn by |
date | text | — | Date |
Example request
L-shaped counter with a side section
curl -X POST https://kerfwiseformdrawing.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"project":"{\"format\":\"kerfwise-form\",\"version\":1,\"name\":\"L-shaped counter\",\"units\":\"mm\",\"grid\":100,\"snap\":true,\"objects\":[{\"id\":\"counter\",\"name\":\"Counter volume\",\"tag\":\"Concepts\",\"color\":\"#bda483\",\"profile\":[[0,0],[2800,0],[2800,650],[900,650],[900,2200],[0,2200]],\"height\":900,\"x\":-1400,\"y\":-1100,\"z\":0,\"rotation\":0,\"visible\":true,\"locked\":false}],\"scenes\":[{\"name\":\"Overview\",\"camera\":{\"azimuth\":-45,\"elevation\":32,\"target\":[0,0,450],\"span\":4223.8045646076}},{\"name\":\"Plan view\",\"camera\":{\"azimuth\":-90,\"elevation\":90,\"target\":[0,0,450],\"span\":4223.8045646076}}]}","sectionAxis":"x","sectionOffset":300,"sectionLabel":"A","viewLeft":false}'
Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://kerfwiseformdrawing.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
kerfwise_form_drawing - Local stdio connector:
node src/mcp-stdio.ts --tool=kerfwise-form-drawing
{
"mcpServers": {
"kerfwise-form-drawing": { "type": "http", "url": "https://kerfwiseformdrawing.usefulweb.app/mcp" }
}
}