add_primitive
Creates box, cylinder, sphere, cone, or torus solids in a FreeCAD document from dimensions, position, rotation, material, and color so AI clients can build parts.
Instructions
Add a primitive solid. dimensions keys per shape: box {length(x), width(y), height(z)}; cylinder {radius, height}
(axis +Z); sphere {radius}; cone {radius1, radius2, height}; torus {radius1 (ring), radius2 (tube)}.
The shape is created with its origin corner/base centre at position [x,y,z] mm (default origin) after rotating
rotation_deg about rotation_axis (default Z). Box origin is its min corner; cylinder/cone origin is the centre of
the base circle. material: aluminium_6061, steel, stainless_304, pa12, pla, pom. color: [r,g,b] 0..1.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"doc": "<doc>",
"name": "<name>",
"shape": "<shape>",
"dimensions": "<dimensions>"
},
"name": "add_primitive"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doc | Yes | ||
| name | Yes | ||
| color | No | ||
| shape | Yes | ||
| material | No | ||
| position | No | ||
| dimensions | Yes | ||
| rotation_deg | No | ||
| rotation_axis | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |