hole
Drills round perpendicular features into a planar face at specified centers; supports metric screw clearances, tapped sizes, depths, counterbores, countersinks, and cosmetic threads.
Instructions
Drills round holes into a planar face, perpendicular to it.
centers: the hole centres [[x, y, z], ...] in mm, model coordinates, all on the SAME face (the face is found through the first one). size: metric screw size ("M3" ... "M24") with fit: close / normal / loose clearance hole (ISO 273) or tapped = tap drill diameter; or give diameter_mm. depth_mm or through_all=True. style: counterbore / countersink for socket head screws; with a metric size their dimensions are standard (ISO 4762 / ISO 10642, 90 degrees), otherwise give them. thread=True (with a metric size, fit="tapped", style="simple") adds a cosmetic thread to each hole (e.g. M6x1, shown in drawings and the thread callout), over thread_depth_mm or the whole hole.
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": {
"centers": "<centers>"
},
"name": "hole"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fit | No | normal | |
| size | No | ||
| style | No | simple | |
| thread | No | ||
| centers | Yes | ||
| depth_mm | No | Hole depth in mm (0 if through_all) | |
| diameter_mm | No | Hole diameter in mm (0 if using metric size) | |
| through_all | No | ||
| thread_depth_mm | No | Thread length in mm (0 = the whole hole) | |
| counterbore_depth_mm | No | Counterbore depth in mm | |
| countersink_angle_deg | No | Countersink angle in degrees (0 < angle < 180) | |
| counterbore_diameter_mm | No | Counterbore diameter in mm | |
| countersink_diameter_mm | No | Countersink diameter in mm |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |