inspect_geometry_nodes
Inspect, configure, and evaluate Geometry Nodes modifier stacks, node trees, links, and interface sockets on Blender mesh objects for procedural modeling workflows.
Instructions
Inspects, configures, or evaluates Geometry Nodes modifier stacks, node trees, links, and interface sockets on a scene mesh object.
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": {
"name": "<name>"
},
"name": "inspect_geometry_nodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Target object name. | |
| links | No | List of link specifications for configure_graph/update_graph. | |
| nodes | No | List of node specifications for configure_graph/update_graph. | |
| value | No | Value to set for set_node_input. | |
| action | No | Action: 'inspect', 'create', 'assign_group', 'add_node', 'remove_node', 'add_link', 'remove_link', 'set_node_input', 'add_socket', 'set_socket_default', 'configure_graph', 'update_graph', 'evaluate', or 'apply'. Defaults to 'inspect'. | inspect |
| in_out | No | Interface socket direction for add_socket. Defaults to 'INPUT'. | |
| inputs | No | Optional dictionary of initial input socket default values for add_node. | |
| task_id | No | Optional task or workflow identifier. | |
| to_node | No | Target node name for add_link or remove_link (e.g. 'Output', 'Group Output', or node name). | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| location | No | Optional [x, y] coordinates for add_node. | |
| from_node | No | Source node name for add_link or remove_link (e.g. 'Input', 'Group Input', or node name). | |
| max_value | No | Optional maximum value limit for numeric sockets. | |
| min_value | No | Optional minimum value limit for numeric sockets. | |
| node_name | No | Name of node for add_node, remove_node, or set_node_input. | |
| node_type | No | Type of node to add for add_node (e.g. 'GeometryNodeTransform', 'GeometryNodeSubdivisionSurface', 'GeometryNodeMeshCube', etc.). | |
| to_socket | No | Target socket name for add_link or remove_link (e.g. 'Geometry', 'Mesh'). | |
| parameters | No | List of interface parameter specifications for configure_graph/update_graph. | |
| from_socket | No | Source socket name for add_link or remove_link (e.g. 'Geometry', 'Mesh'). | |
| object_name | No | Alias for name. | |
| socket_name | No | Interface socket name to add or configure. | |
| socket_type | No | Socket type: 'NodeSocketFloat', 'NodeSocketInt', 'NodeSocketVector', 'NodeSocketColor', 'NodeSocketBool', 'NodeSocketString', 'NodeSocketGeometry'. | NodeSocketFloat |
| default_value | No | Default value for the interface socket. | |
| modifier_name | No | Name of the Geometry Nodes modifier. Defaults to 'GeometryNodes'. | GeometryNodes |
| target_object | No | Alias for name. | |
| node_group_name | No | Name of the GeometryNodeTree node group to assign or create. | |
| expected_snapshot_id | No | Optimistic concurrency state fingerprint from previous inspect call. |