kernelCAD

Add a variable-section sweep feature into .kcad source.

add_variable_sweep

Add a workspace/robotics target.

add_workspace_target

Flow: join_project → claim → submit_change. Every result carries your digest: head, landed edits, your statuses, and current claims. Lead only: admit a worker request into the normal sequencer gate.

admit_change_request

Use this when you need to author and evaluate a fillet or chamfer on a kernelCAD Shape. Inserts Shape.fillet(radius, selector, { continuity: G1|G2 }) or Shape.chamfer(distance, selector) through the existing public API and returns the patched source plus evaluation diagnostics. Selectors accept EdgeSelector syntax, including canonical edge refs/query strings or { face: canonical name, face label, or face query }. G2 continuity applies to fillets; chamfer uses the existing chamfer API. This authors the operation and does not extract blend-surface NURBS poles; that still requires kernel surface extraction.

apply_surface_blend

Use this when you have a list of parts with bounding boxes and positions (from a layout, spreadsheet, another tool or a sketch) and need an evaluable placeholder assembly script. Pass parts as { name, bboxMm:[x,y,z], positionMm:[x,y,z], rotationDeg?, anchors? } in mm; positionMm locates the bbox lower corner and anchors are named points in assembly coordinates. Optional connections [{ from, to }] reference anchors as "part.anchor" (including built-ins origin, bbox_center, bbox_x_min..bbox_z_max) and become fastened mates that express connectivity intent only; no wire or route geometry is generated. Returns the script (corner-anchored box solids with named connectors) plus warnings. It reads no files and cuts nothing; refine the solids with add_part/add_feature afterwards.

blockout_assembly

Capture an animation/turntable of a model.

capture_animation

Flow: join_project → claim → submit_change. Every result carries your digest: head, landed edits, your statuses, and current claims. Claims expire after 15 minutes without calls and are renewed by your next tool call.

claim

Use this when the user wants to union, subtract, or intersect two imported triangle mesh solids (STL, OBJ, or 3MF). Supports union, subtract (A minus B) and intersect. Pass each operand as { file } on the MCP server or { data } with base64 mesh bytes; formats are detected or may be specified. Returns volume in mm³, triangle count and a binary STL as data_base64; pass that payload to import_step to continue modeling. Inputs must be closed, consistently oriented 2-manifold meshes. Open, non-manifold, or invalid meshes return an error. This computes mesh geometry and does not create an editable B-rep feature tree.

mesh_boolean

Vector engineering PDF → starter CAD. PNG/scans: use trace_from_image. Hosted: give the file as an https:// URL, a data: URI (base64, max 25 MB) or "asset:<id>" from request_upload (when the file is on the user's device). A file the user attached in this chat is sent in `files` and used automatically.

drawing_to_cad

Diff two .kcad sources.

diff_scripts

Compare geometry between two model versions/scripts.

diff_geometry

Evaluate .kcad source ({ code } or { file }) → diagnostics + geometry summary. A full evaluation updates this MCP session's active model/viewer state and keeps temporary step evidence; { dryRun: true } leaves the session unchanged. Multi-body assemblies need connectors + mates/joints or mechanism.orphan-part fails (axis+revolute for shafts/hinges/gears; frame+fastened for rigid). Declare partRef.connector before arm.mate; after edits delete stale duplicate/orphaned overlapping bodies. Articulated closed loops (4-bar etc.) are UNSUPPORTED on v0.6.0 — expect assembly.solver.did-not-converge; use an open chain or fastened-only loop (do not invent gear-contact types). Use before open_in_studio. Hosted: lib.fromSTEP / fromSTL / fromDXF / fromSVG and referenceImage take a direct string literal or a const bound to one (computed expressions are unsupported). They accept "asset:<id>" (from request_upload), an https:// URL or a data: URI as the path. A file the user attached in this chat is sent in `files`; use "upload:0" (or "upload:<file name>") as the path.

evaluate_script

Evaluate a signed-distance field helper.

evaluate_sdf

Prefer after lookup_cookbook for industry demos when you need evaluate + optional Studio in ONE call. Args: id or query; dryRun:false for evidence; openInStudio:true to publish/paint. Different cookbooks are new projects. dryRun:true is NOT evidence. Do not refuse if you only scrolled Write tools — this is a registered MCP tool (read category).

execute_cookbook

Explain a failed evaluate/build from diagnostics.

why_did_this_fail

Export geometry: target + format + output_path + code/file. Front-only SVG/PDF: options.views:["front"]. Share downloads[].url. On export.deferred poll export({ job_id }).

export

Fetch a bundled catalog part. Prefer await lib.standard.nema17() and await lib.standard.bearing608() (offline). Lookups fail within 45s with parts.lookup.timeout rather than hanging.

fetch_part

Search the bundled catalog. NEMA-17: await lib.standard.nema17(). 608 bearing: await lib.standard.bearing608(). Do not fan out parallel lookups. Remote calls fail within 45s (parts.lookup.timeout).

find_part

Recover feature-ish CAD structure from mesh input. Hosted: give the file as an https:// URL, a data: URI (base64, max 25 MB) or "asset:<id>" from request_upload (when the file is on the user's device). A file the user attached in this chat is sent in `files` and used automatically.

mesh_to_features

Use this when you need to fit an orthogonal least-squares plane to XYZ point-cloud data. Returns centroid, deterministic unit normal, signed point residuals, RMS residual and maximum absolute residual. Accepts points already parsed by the caller from scan data or mesh vertices. Computes parameters only; it does not create a surface body. Requires at least three non-collinear finite points.

fit_plane

Flatten sheet-metal pattern.

flatten_pattern

Generate a kernelCAD .kcad.ts script from a natural-language prompt and return the evaluated source. BEFORE CALLING: read the `kernelcad-authoring` MCP resource (or call the `lookup_authoring_skill` tool if your client does not list resources) so you know the script-authoring conventions, parameter style, and evaluation contract. If neither is available, refer to kernelcad-authoring documentation in the kernelCAD-web repo. INPUT: a single `prompt` string (up to 8000 characters) describing the part in plain language (e.g. "60x40x5 mounting bracket with two 3mm holes"). Optional `partsBudget` is informational — quota is debited per successful generation regardless of this value. OUTPUT: { status, kcadSource, evaluationOk, featureCount, diagnostics, title, parameters, suggestions, partial? }. `evaluationOk: true` means the script parsed and lowered to valid BREP. `status: "done"` means the script passed the build gates. `status: "done_partial"` means the run hit its time or token limit (or a provider error) after a script already built: `kcadSource` is the best script so far and `partial` says what is unverified — continue by evaluating and refining it. Free-tier accounts: each successful call debits 1 part from the monthly quota; partial results, LLM errors and kernel-evaluator crashes do NOT debit. An identical call made while the same prompt is still generating joins that run instead of starting another. LONG RUNS (MCP): a generation often takes more than 60 s. This call waits at most `wait_ms` (default 45000, max 50000). If the generation has not finished by then it returns { status: "running", generationId, elapsedMs, stage?, message } instead, and the generation KEEPS RUNNING on the server (it is not cancelled and is billed only if it succeeds). Then call `get_generation({ generationId })` — repeat while it returns status "running" — to get exactly the result described above. Do not re-call generate_kcad_from_prompt to check on a run. ON FAILURE: generations that ran but did not validate return a structured `failure` object — { stage: "llm"|"parse"|"evaluate"|"gates", diagnostics: [{ code?, message, hint?, locus?, margin? }], source: "<last attempted .kcad.ts source or null>", suggestion: "<one-line next action>" }. Failed generations never debit quota. Prefer repairing `failure.source` against `failure.diagnostics` over re-prompting from scratch.

generate_kcad_from_prompt

Flow: join_project → claim → submit_change. Every result carries your digest: head, landed edits, your statuses, and current claims. Poll this tool for a change set that is still queued.

get_change_status

Flow: join_project → claim → submit_change. Every result carries your digest: head, landed edits, your statuses, and current claims. Use revision to read every change landed after that point.

get_changes_since

Summarize the latest FEA result.

fea_summary

Fetch the result of a generate_kcad_from_prompt run that returned { status: "running", generationId }. Waits up to `wait_ms` (default 45000, max 50000) for the run to finish. When it has finished, returns exactly what generate_kcad_from_prompt returns: { status: "done" | "done_partial", kcadSource, evaluationOk, featureCount, diagnostics, title, parameters, suggestions, partial? }, or the same error (a structured `failure` for a generation that did not validate, quota, rate limit). When it is still running, returns { status: "running", generationId, elapsedMs, stage?, progress?, message } — call get_generation again with the same generationId. Only the account that started the generation can read it. Results are kept for 30 minutes after the run ends. Reading a result never debits quota.

get_generation

Fetch the latest painted review feedback for a project slug (or signed-in user).

review_paint_peek_latest

Server-side PNG still by slug — NOT for interactive Studio paint. Prefer open_in_studio (previewDelivered already includes PNG). Use only for a different view, view:"all" contact sheet, or slug-only still. CRITICAL: image is from the MODEL camera, not the user camera.

get_latest_render

Return triangle mesh JSON for a project slug — NOT the ChatGPT interactive Studio paint path. For in-chat 3D viewing use open_in_studio (outputTemplate + embed). Prefer open_in_studio.

get_model_mesh

Read-only: fetch by slug (source + meshStatus/meshUrl/embedUrl) or list (no slug). Never shows a viewer. Use open_in_studio(+code) once to publish+paint. Poll here when open_in_studio returned meshStatus=building until meshReady=true. viewerPainted stays false until widget ack. Do NOT call get_model_mesh/get_latest_render for interactive paint.

get_project

Read immutable release-pinned source for a slug+version from open_in_studio.

get_project_revision

Use this when you need to read the human/agent selection in a local Studio session. Returns one clicked face or edge (or null), with current-generation mesh-local shapeIndex/kind/id and creating featureId. During a rebuild selection is null with “selection pending rebuild” until Studio uniquely verifies the face; ambiguous or deleted faces are cleared. Inspect the current shape before authoring a fillet. Requires a running local Studio opened on the same script; hosted sessions are not supported.

get_selection

Use this when the user wants to start from their own STEP or STL file (a part they designed elsewhere, a vendor model). Give exactly one source: url (a public https direct-download link), upload (a file the user attached in ChatGPT), or content_base64 (raw bytes, small files only). Max 50 MB. The format is detected from the bytes (or pass format: 'step' | 'stl'). Writes the file and a starter <name>.kcad.ts whose base body is lib.fromSTEP / lib.fromSTL into output_dir (default: a fresh temp dir), evaluates it, and returns { ok, format, model_path, script_path, code, bbox }. Pass script_path as { file } to evaluate_script, add_feature, dfm_review, export and the other tools, or edit code to build on the body. STL is a mesh: booleans, bbox and export work, but faces stay planar facets (use mesh_to_features for an editable feature tree). A non-watertight STL is refused unless allow_open is true.

import_step

Read model facts. `of` selects mode (assembly|robot|step|shape|mass|features|assemblies|params|bbox|…). Pass code/file as required by that mode. Hosted: give the file as an https:// URL, a data: URI (base64, max 25 MB) or "asset:<id>" from request_upload (when the file is on the user's device). A file the user attached in this chat is sent in `files` and used automatically.

inspect

Evaluate supplied kernelCAD code or a file to capture an authored NURBS curve (nurbsCurve/spline3d). Returns degree, distinct knots and multiplicities, poles, weights, rational and uniformWeights flags, hasNonUnitWeights, and parameter range. Defaults to the last captured curve in that script; pass feature_id to choose one. The source may load referenced assets. Reports authored curve data, not exact geometry-derived B-rep edge/face NURBS; surface extraction and blending are not supported. Does not update the active MCP session or write a project.

inspect_nurbs

Flow: join_project → claim → submit_change. Every result carries your digest: head, landed edits, your statuses, and current claims. The first joiner becomes lead; later agents join as workers by default.

join_project

List the signed-in user's saved kernelCAD projects, most recently updated first. Call this when the user wants to continue, change or reopen an earlier model. Then call get_project({ slug }) for the source, and open_in_studio({ project: slug, code }) to save the change as a new revision of that project. Do not create a new project for a model the user already has.

list_my_projects

Look up kernelCAD API docs by symbol/keyword.

lookup_api

Authoring skill for .kcad scripts. No args: quick-start + section index; then `section: "<id>"` or `query`. `section: "all"` = full ~108k body.

lookup_authoring_skill

Look up cookbook recipes for common CAD patterns. After picking an id, prefer execute_cookbook(id, openInStudio) instead of narrating or freehand-pasting.

lookup_cookbook