configure_geometry_nodes
Inspect, configure, or evaluate Geometry Nodes modifier stacks, node trees, links, and interface sockets on a Blender mesh object to build and adjust procedural geometry.
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": "configure_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. |