MCP server providing tools for programmatic interaction with SketchUp models, including scene inspection, entity manipulation, terrain surface management, staged assets, and site element creation.
Create a model-root group with optional metadata and child assignment.
Create a managed Site Element with optional metadata and semantic position or parent assignment.
Create or adopt a repository-backed Managed Terrain Surface with owned terrain state and derived mesh output. Use for managed terrain state/output, not semantic hardscape or site-element creation.
Curate an existing in-model group or component instance as an approved metadata-backed Asset Exemplar. This writes Asset Exemplar metadata only; it does not import, move, reparent, tag, lock, duplicate, or delete geometry.
Delete a collection of entities and their descendants.
Apply bounded intent-based edits to a repository-backed Managed Terrain Surface. Choose target_height for local area elevations, corridor_transition for linear ramp or corridor grades, local_fairing for smoothing, and survey_point_constraint for measured-point correction, or planar_region_fit for bounded fitted plane replacement. Review edit evidence and profile samples; command success is not visual or grading acceptance. Not for arbitrary TIN edits, broad sculpting, or site elements.
Execute arbitrary Ruby code in the SketchUp context. Escape hatch for unsupported operations.
Resolve entities by exact-match identity, attributes, or supported metadata predicates. This tool is for predicate targeting, not scoped inventory.
Retrieve consolidated entity metadata and geometry properties for a resolved target.
Get a structured summary of the current SketchUp scene for broad grounding before more targeted inspection tools are used.
Retrieve the current SketchUp selection as a structured entity list.
Create an editable model-root Asset Instance from an approved metadata-backed Asset Exemplar. Requires caller-supplied metadata.sourceElementId for the new instance, preserves lean source lineage, and supports placement position, scalar scale, and orientation intent.
Inventory entities within a known scope such as the current selection, top-level model context, or children of an explicit target. This tool is for scoped inventory, not predicate search.
List approved metadata-backed Asset Exemplars filtered by optional metadata predicates.
Measure resolved scene targets and return structured quantities. Use for direct measurements such as bounds, bounds-height, bounds-center distance, area, and terrain profile elevation summaries. Do not use for validation verdicts. Do not use for slope, grade, terrain diagnostics, raw metadata inspection, or arbitrary Ruby probing.
Local SketchUp MCP runtime health check
Move a collection of entities to a new parent group or component.
Sample world-space surface elevation from an explicit target using a canonical sampling object. Use sampling.type points for explicit XY control checks or profile for terrain-shape review between controls. For direct terrain-surface readback, prefer visibleOnly false instead of sending ignoreTargets. Use ignoreTargets only for known visible blockers or target descendants that must be excluded. This is not broad scene discovery and does not return terrain validation verdicts.
Update or clear supported metadata fields on a resolved managed object target.
Apply a material by name to a resolved target entity.
Apply a rigid transform (position, rotation, scale) to a resolved target.
Validate explicit scene-update expectations against resolved scene targets and return structured acceptance findings. Use for post-update acceptance checks, not broad discovery or raw semantic property inspection. Metadata requirements currently verify supported managed-object keys only; geometry-facing checks belong under geometryRequirements.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 0 | 2026-07-28+ | v2 |