Create a new component in Sketchup.

Delete a component by entity ID.

Transform a component's position, rotation, or scale.

Get currently selected components.

Set material for a component (named color or hex).

Export the current scene. Note: Ruby tool name is 'export'.

Create a mortise and tenon joint between two components.

All dimensions in millimeters. Defaults sized for visibility on a typical 100mm-board: 50mm wide, 25mm tall, 10mm deep. Pydantic always sends these on the wire, so they override Ruby's V.optional_positive defaults — keep the two sides in sync (see su_mcp/su_mcp/handlers/joints.rb).

Create a dovetail joint between two components. Dimensions in mm.

Create a finger joint (box joint) between two components. Dimensions in mm.

Evaluate arbitrary Ruby code in Sketchup.

Perform a boolean operation (union/difference/intersection) on two solids.

Chamfer all edges of a group/component by distance (mm).

Default 5mm — visible on the documented 100mm-cube use case. Ruby tool name is chamfer_edges (plural); Python parameter id maps to Ruby entity_id.

Fillet (round) all edges of a group/component. Default radius 5mm.

Note: Ruby tool name is fillet_edges (plural); Python parameter id maps to Ruby parameter entity_id.

Capture the current SketchUp viewport as a PNG and return it as an MCP Image.

Useful for letting Claude visually verify the scene between steps.

Parameters

• max_size: largest side of the returned PNG (64..4096). Aspect ratio is taken from the current viewport; the smaller side is scaled proportionally.

• view_preset: switch the camera to a standard view before snapping. current leaves the camera alone.

• zoom_extents: call view.zoom_extents before snapping.

• style: temporarily flip a small set of rendering_options keys. default leaves them alone.

• restore_view: when true (default), camera and rendering_options are snapshotted before mutation and restored after the snapshot, so the user's viewport is unchanged.

Note on operation order (Ruby handler): snapshot → preset → style → zoom_extents → write_image → restore. Restore runs in an outer ensure block, so an exception anywhere between snapshot and write_image still leaves the viewport in its original state.

Get current SketchUp model info: file path, title, units, bounding box, entity count, layer list.

List groups and component instances in the model.

Returns each as {id, name, type, layer, depth, bbox_mm}. Bounds are in world coordinates. Set recursive=true to descend into nested components (bounded by max_depth, default 3).

Detailed info for a single Group or ComponentInstance by entity ID.

Find components matching name substring, layer, and/or type.

Recursive (bounded by max_depth). At least one filter should be supplied.

List all model layers as {name, visible, color, id}.

Create a new layer with the given name. Returns {id, name, visible}.

Undo the last atomic operation in SketchUp. One MCP tool-call = one undo step.

Return the server version and Python↔Ruby compatibility verdict.

Useful as a runtime sanity probe — always returns a payload, even when the connection or other tools surface errors. The result is a JSON string with fields: python_version, ruby_version, min_compatible_ruby, max_compatible_ruby, ruby_min_compatible_python, ruby_max_compatible_python, compatible (bool), error (string | null).