inspect_scene_data
Inspect structured Blender scene data read-only through an explicit category allowlist to retrieve scene summaries, object details, topology, materials, and render settings safely.
Instructions
Inspect structured Blender scene data with an explicit, safe read-only allowlist. Supported categories: 'scene_summary', 'object_modifiers', 'object_materials', 'mesh_topology', 'scene_hierarchy', 'world_settings', 'collection_tree', 'render_settings', 'blender_info', 'uv_layers', 'render_result', 'cameras', 'camera_settings'. Arbitrary code execution and unapproved data access are strictly rejected.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum items for collection/hierarchy or indexed mesh queries. | |
| offset | No | Pagination offset for collection/hierarchy or indexed mesh queries. | |
| category | Yes | Category of scene data to inspect. | |
| mesh_source | No | Indexed topology only. Base is editable source; evaluated is a temporary modifier result, freed after readback. Object Mode only; evaluated indices cannot authorize base-mesh edits. | |
| target_name | No | Target object name in the active scene. Required for object-specific categories ('object_modifiers', 'object_materials', 'mesh_topology', 'uv_layers'). | |
| element_domain | No | Optional indexed base-mesh domain for mesh_topology only. Object Mode, active-scene mesh only. Omitting preserves count-only response. Local coordinates; indices are snapshot-local. Paginated with limit/offset; oversized snapshots/pages fail explicitly. | |
| include_parameters | No | Whether to include detailed property values for modifiers/materials. | |
| expected_snapshot_id | No | Indexed topology only: reject the page if geometry/source changed since this fingerprint. |