blender_get_node_tree
Read-onlyIdempotent
Retrieve the structure of shader, compositor, or geometry node trees to inspect connections and settings before making edits.
Instructions
Read the structure of any node tree — shader, compositor, or geometry nodes. Supports all 7 contexts.
Use this when: you need to understand node graph structure before editing.
Do NOT use for: editing nodes (use blender_edit_nodes).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tree_type | Yes | Node tree type. | |
| context | Yes | Context: SHADER uses OBJECT|WORLD|LINESTYLE|NODE_GROUP, COMPOSITOR uses SCENE|NODE_GROUP, GEOMETRY uses MODIFIER|TOOL|NODE_GROUP. | |
| target | No | Target: material name (SHADER/OBJECT), world name (SHADER/WORLD), 'Object/Modifier' (GEOMETRY/MODIFIER), or node group name (NODE_GROUP). | |
| depth | No | 'summary': name/type only. 'topology': connected sockets + non-default values (recommended). 'full': all data. | topology |
| skip_defaults | No | If True, omit inputs with default values (reduces tokens). | |
| expand_groups | No | Recursively expand node groups. | |
| max_depth | No | Max recursion for group expansion. |