kernelcad

Execute Cookbook

execute_cookbook

Use this when you need evaluate_script (and optionally open_in_studio) for an industry / cookbook demo in ONE step — after lookup_cookbook for industry demos, prefer execute_cookbook when you need evaluate+Studio together; empty lookup is not a stop (freehand-author instead). Resolves a cookbook snippet by id or BM25 query (same ranking as lookup_cookbook), evaluates its body via evaluate_script with bounded vendor timeouts, and returns explicit status with stage resolve|evaluate|open_in_studio. Pass openInStudio:true to publish the same script via open_in_studio after a green full evaluate (hosted MCP). dryRun:true is the fast capture-only path — it is NOT evidence the cookbook builds a solid or is safe to publish; finish with dryRun:false (default) before claiming success or opening Studio.

Input Schema

TableJSON Schema

Name	Required	Description
`id`	No	Cookbook snippet id (e.g. gt2-timing-belt-drive, extrude-rounded-rect-plate).
`query`	No	When id is omitted: natural-language query; BM25 picks the top hit (same as lookup_cookbook).
`dryRun`	No	Default false. dryRun:true is NOT evidence the cookbook builds a solid — capture-only checks; do not claim success or open Studio from a dry run alone.
`intent`	No	The user's request in one sentence, in the user's own words and language (e.g. 'M4 bracket for a 25 mm tube, print on Bambu A1'). Helps kernelCAD improve; leave out personal data.
`project`	No	Slug of an existing project. Adds a revision to that project. Omit to start a new project when this cookbook or design is different from the one this chat already saved.
`new_project`	No	Pass true to start a separate project even when this cookbook was already published in this chat.
`openInStudio`	No	Default false. When true, after a green full (non-dryRun) evaluate, call open_in_studio on the same script (hosted MCP).
`continue_design`	No	Pass true to add a revision to the design this chat is already saving, even if this call runs a different cookbook. Ignored when `project` is set.

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: -{
-  "code": {
-    "description": "Snippet body used for evaluate / Studio.",
-    "type": "string"
-  },
-  "cookbookId": {
-    "description": "Resolved cookbook snippet id.",
-    "type": "string"
-  },
-  "dryRunNotEvidence": {
-    "description": "Present when dryRun:true — dryRun success is not evidence the solid built.",
-    "type": "boolean"
-  },
-  "error": {
-    "type": "string"
-  },
-  "evaluate": {
-    "additionalProperties": true,
-    "description": "Full evaluate_script result (same shape).",
-    "type": "object"
-  },
-  "executionId": {
-    "description": "Short id for logs / correlation.",
-    "type": "string"
-  },
-  "ok": {
-    "type": "boolean"
-  },
-  "openInStudio": {
-    "additionalProperties": true,
-    "description": "open_in_studio result when openInStudio was requested.",
-    "type": "object"
-  },
-  "stage": {
-    "description": "'resolve' | 'evaluate' | 'open_in_studio' on failure.",
-    "type": "string"
-  },
-  "title": {
-    "description": "Resolved cookbook title.",
-    "type": "string"
-  }
-}

removedOutput schema / required

Removed value: -[
-  "ok",
-  "executionId"
-]

Changed2 schema fields changedOct 9, 2026

changedInput schema / properties / dryRun / description

Previous value: -"Default false. dryRun:true is NOT evidence the cookbook builds under OCCT — capture-only checks; do not claim success or open Studio from a dry run alone."New value: +"Default false. dryRun:true is NOT evidence the cookbook builds a solid — capture-only checks; do not claim success or open Studio from a dry run alone."

changedOutput schema / properties / dryRunNotEvidence / description

Previous value: -"Present when dryRun:true — dryRun success is NOT evidence of a real OCCT build."New value: +"Present when dryRun:true — dryRun success is not evidence the solid built."

Changed3 schema fields changedOct 6, 2026

addedInput schema / properties / continue_design

Added value: +{
+  "description": "Pass true to add a revision to the design this chat is already saving, even if this call runs a different cookbook. Ignored when `project` is set.",
+  "type": "boolean"
+}

addedInput schema / properties / new_project

Added value: +{
+  "description": "Pass true to start a separate project even when this cookbook was already published in this chat.",
+  "type": "boolean"
+}

addedInput schema / properties / project

Added value: +{
+  "description": "Slug of an existing project. Adds a revision to that project. Omit to start a new project when this cookbook or design is different from the one this chat already saved.",
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedOct 3, 2026

addedInput schema / properties / intent

Added value: +{
+  "description": "The user's request in one sentence, in the user's own words and language (e.g. 'M4 bracket for a 25 mm tube, print on Bambu A1'). Helps kernelCAD improve; leave out personal data.",
+  "maxLength": 2000,
+  "type": "string"
+}

AddedSep 30, 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.