kernelcad

Query Geometry

query

Read-only

Use this when you need to resolve or inspect topology against a script's lowered geometry. Selected by mode (default 'evaluate'):

'evaluate' — inspect a Query (@kc[...] ref, @kcq[...] DSL, or { ast }); returns matched entities. Pass expect:'unique' to assert exactly-one.
'resolve' — resolve a single @kc[...] / @kcq[...] ref to one entity ({ ref }).
'lineage' — walk the HistoryMap for a named face ref ({ feature_id, ref }). All params except mode are forwarded verbatim.

Input Schema

TableJSON Schema

Name	Required	Description
`ref`	No	mode:'resolve'\|'lineage' — topology ref string.
`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.
`mode`	No	Resolution mode (default 'evaluate').
`query`	No	mode:'evaluate' — Query input: @kc[...] / @kcq[...] string or { ast } object.
`expect`	No	mode:'evaluate' — 'unique' asserts exactly-one.
`feature_id`	No	Optional FeatureId; defaults to the last lowered shape (use "auto" for lineage).

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: -{
-  "candidates": {
-    "description": "mode:'resolve' — near-miss candidates (failure).",
-    "items": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "chain": {
-    "description": "mode:'lineage' — HistoryMap walk.",
-    "items": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "entities": {
-    "description": "mode:'evaluate' — matched entities.",
-    "items": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "entity": {
-    "additionalProperties": true,
-    "description": "mode:'resolve' — the single matched entity.",
-    "type": "object"
-  },
-  "error": {
-    "type": "string"
-  },
-  "errorCode": {
-    "type": "string"
-  },
-  "ok": {
-    "type": "boolean"
-  },
-  "query": {
-    "additionalProperties": true,
-    "description": "mode:'evaluate' — the resolved Query ({ ast }).",
-    "type": "object"
-  },
-  "ref": {
-    "description": "mode:'resolve' — the resolved ref string.",
-    "type": "string"
-  },
-  "warnings": {
-    "items": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "type": "array"
-  }
-}

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": {
+    "candidates": {
+      "description": "mode:'resolve' — near-miss candidates (failure).",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "chain": {
+      "description": "mode:'lineage' — HistoryMap walk.",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "entities": {
+      "description": "mode:'evaluate' — matched entities.",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "entity": {
+      "additionalProperties": true,
+      "description": "mode:'resolve' — the single matched entity.",
+      "type": "object"
+    },
+    "error": {
+      "type": "string"
+    },
+    "errorCode": {
+      "type": "string"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "query": {
+      "additionalProperties": true,
+      "description": "mode:'evaluate' — the resolved Query ({ ast }).",
+      "type": "object"
+    },
+    "ref": {
+      "description": "mode:'resolve' — the resolved ref string.",
+      "type": "string"
+    },
+    "warnings": {
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "ok"
+  ],
+  "type": "object"
+}

AddedJun 13, 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.