// MCP TOOL REFERENCE

KERNELCAD TOOLS

48 tools from the Kernelcad MCP Server, categorised by risk level.

View the Kernelcad policy → Token cost: 11,038 tokens →

// ALL 48 KERNELCAD TOOLS

READ 24 tools

Read emboss_text Insert a `<shape>.embossText({ text, face, size, depth, align?, anchor?, rotation?, scaleMode? })` chained ... Read evaluate_sdf Sample the signed distance from an in-script sdf.* field at a 3D point. Returns { distance, inside, aabb, k... Read flatten_pattern Return the unfolded 2D flat-pattern of a bent sheet-metal Shape as a Region (outer polyline + holes + bend ... Read get_bend_table List every sheetMetalBend in a script with its computed K-factor bend allowance, axis line, angle, radius, ... Read get_edges_of Return the boundary edges of a named canonical face on an un-transformed primitive — index, centroid, lengt... Read get_face_lineage Walk the HistoryMap of a lowered feature and return the chain of lineage entries that produced a named face... Read get_shape_info Run + recompute a script, return volume/surfaceArea/bbox for one feature (default: last). Pass { file?, cod... Read inspect_assembly Evaluate a kernelCAD script and return an agent-facing physical assembly inventory: named parts, bboxes, co... Read list_api List the kernelCAD script-runtime surface: global functions (box, path, selectEdges, helix, etc), Shape met... Read list_assemblies List assembly intent captured by a kernelCAD script: assemblies, parts, named connectors, fixed connections... Read list_constraints List supported sketch constraint types and echo the provided constraint list. Use before add_constraint or ... Read list_diagnostic_codes Return the kernelCAD 26-code diagnostic catalogue with hint templates. Tiny one-shot call; useful for an ag... Read list_edges List edges of a kernelCAD shape with optional EdgeQuery filter. Returns each edge's id, midpoint, direction... Read list_face_labels List user-applied labels visible in a script: both sketch-segment labels (path().label('rim')) and creating... Read list_faces List faces of a kernelCAD shape with optional FaceQuery filter. Returns each face's id, centroid, normal, s... Read list_features List the features captured by a kernelCAD script — kind, id, params, inputs, transforms count, suppression.... Read list_mates List the mate records declared on the active assembly. Read-only; reads arm.__mates() under the hood. Retur... Read list_topology List the canonical face names available on a feature (top/bottom/left/right/front/back for box; top/bottom ... Read lookup_authoring_skill Return the kernelcad-authoring SKILL.md body — conventions for writing .kcad.ts scripts (imports, parameter... Read lookup_cookbook Search the kernelCAD cookbook for canonical pattern snippets. Returns top-k snippets matching the natural-l... Read params_list List all parameters declared on the active session, with current values, defaults, and metadata. Read-only. Read project_curve Insert a `<shape>.projectCurve({ curve, face, scaleMode?, asEdge? })` chained call into a kernelCAD script.... Read validate_assembly Run the mate-aware assembly validator (validateAssemblyWithMates) on the active assembly. Returns { status,... Read why_did_this_fail Walk the upstream chain of a failing feature. Returns the diagnostics of the requested feature plus the dia...

WRITE 18 tools

Write add_connector Register a v0.6 mate-style connector on a named part of the active assembly. Requires a prior evaluate_scri... Write add_constraint Append one validated sketch constraint to a constraint list. Side-effect-free: pass { constraints, constrai... Write add_feature Insert a new feature line into a kernelCAD script before the last top-level return statement. Returns the m... Write add_hermite_g2 Insert a `hermiteG2(a, b)` declaration into the user's .kcad.ts immediately before the last top-level retur... Write add_mate Declare a typed mate between two named connectors on the active assembly. Connector refs are "<partName>.<c... Write add_nurbs_curve Insert a `nurbsCurve(controlPoints, opts?)` declaration into the user's .kcad.ts immediately before the las... Write add_nurbs_surface Insert a nurbsSurface(...) or surfaceFromCurves(...) call into the user's .kcad.ts. The returned Surface is... Write add_path_hermite_g2 Insert a `.hermiteG2(a, b)` call into an existing PathBuilder chain on the named `chain_anchor` variable. T... Write add_path_nurbs_segment Insert a `.nurbsSegment(controlPoints, opts?)` call into an existing PathBuilder chain on the named `chain_... Write add_path_spline Insert a `.spline(points, opts?)` call into an existing PathBuilder chain on the named `chain_anchor` varia... Write add_pattern_feature Insert a Shape.patternLinear / .patternCircular / .patternGrid call into a kernelCAD script before the last... Write add_sketch_text Insert a sketch.text(...) call into a kernelCAD script before the last top-level return statement. Returns ... Write add_surface_from_boundary Insert a `surfaceFromBoundary([c1, c2, c3, c4], opts?)` declaration into the user's .kcad.ts immediately be... Write add_variable_sweep Insert a `variableSweep(spine, sections, opts?)` declaration into the user's .kcad.ts immediately before th... Write export_stl Export the script geometry to a binary STL file. Pass either { file } or { code } plus a required { output_... Write params_update Edit one or more session parameters and re-lower the affected records. Validates every edit before applying... Write set_param_value Edit a param() default value in a kernelCAD script. Returns the modified code as text plus diagnostics from... Write solve_sketch Solve a 2D sketch constraint set. Side-effect-free: pass { entities, constraints } and receive solved entit...

DESTRUCTIVE 1 tools

Destructive remove_feature Remove a single line from a kernelCAD script identified by a substring match. Returns the modified code plu...

EXECUTE 5 tools

Execute design_loop Run an agent CAD design loop over one or more attempt scripts: review each attempt with review_cad, continu... Execute evaluate_script Run a kernelCAD .kcad.ts script and report pass/fail + feature count + diagnostics. Pass either { file: "<p... Execute review_cad Run the deterministic CAD review loop: evaluate the script, validate the assembly/mate graph, check mate co... Execute solve_mates Run the v0.6 mate-graph solver on the active assembly. Returns { status, poses, iterations? } where each po... Execute trace_from_image Trace pixel-space features from a reference photo into normalized [0..1] waypoints the agent can map to mm ...

// RUNNING THIS SERVER

The managed route: connect Kernelcad through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y kernelcad

// FAQ

How many tools does the Kernelcad MCP server have? +

The Kernelcad MCP server exposes 48 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Kernelcad tools? +

Route the Kernelcad server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Kernelcad tools fall into? +

Kernelcad tools are categorised as Read (24), Write (18), Destructive (1), Execute (5). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.