kernelcad

Evaluate SDF

evaluate_sdf

Read-only

Use this when you need to sample a signed-distance field at a point. Sample the signed distance from an in-script sdf.* field at a 3D point. Returns { distance, inside, aabb, kind }. Distance is in mm; negative = inside the surface, 0 = exactly on the surface, positive = outside. Use this to verify SDF composition before calling sdf.materialize (which is the expensive step). The script must bind the SdfField via sdf.bind('', field) and pass that name as fieldName. Hint: pass either { file } or { code }, plus { fieldName, point: [x,y,z] }.

Input Schema

TableJSON Schema

Name	Required	Description
`code`	No	Inline kernelCAD script source.
`file`	No	Path to a .kcad.ts script file. Hosted server: cannot read files from your machine — pass `code`, or `project:<slug>` for a saved project.
`point`	Yes	Sample point [x, y, z] in mm.
`fieldName`	Yes	sdf.bind binding name holding the SdfField.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 11, 2026

removedOutput schema / properties

Removed value: -{
-  "aabb": {
-    "additionalProperties": true,
-    "description": "Axis-aligned bounding box of the field (success).",
-    "type": "object"
-  },
-  "distance": {
-    "description": "Signed distance in mm; negative = inside (success).",
-    "type": "number"
-  },
-  "error": {
-    "type": "string"
-  },
-  "errorCode": {
-    "type": "string"
-  },
-  "hint": {
-    "type": "string"
-  },
-  "inside": {
-    "description": "Whether the point is inside the surface (success).",
-    "type": "boolean"
-  },
-  "kind": {
-    "description": "SDF field kind (success).",
-    "type": "string"
-  },
-  "ok": {
-    "type": "boolean"
-  }
-}

removedOutput schema / required
```
Removed value: -[
-  "ok"
-]
```

Changed1 schema field changedSep 28, 2026

changedInput schema / properties / file / description

Previous value: -"Path to a .kcad.ts script file."New value: +"Path to a .kcad.ts script file. Hosted server: cannot read files from your machine — pass `code`, or `project:<slug>` for a saved project."

Changed1 schema field changedJun 15, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "aabb": {
+      "additionalProperties": true,
+      "description": "Axis-aligned bounding box of the field (success).",
+      "type": "object"
+    },
+    "distance": {
+      "description": "Signed distance in mm; negative = inside (success).",
+      "type": "number"
+    },
+    "error": {
+      "type": "string"
+    },
+    "errorCode": {
+      "type": "string"
+    },
+    "hint": {
+      "type": "string"
+    },
+    "inside": {
+      "description": "Whether the point is inside the surface (success).",
+      "type": "boolean"
+    },
+    "kind": {
+      "description": "SDF field kind (success).",
+      "type": "string"
+    },
+    "ok": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "ok"
+  ],
+  "type": "object"
+}

First observedMay 25, 2026

TDQS

Score is being calculated.

All kernelcad tools Inspect

Try in Browser

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.