scene-node-add
Add any Godot node type to an existing scene and configure properties via JSON. Replaces specialized create node tools.
Instructions
[compact alias of add_node] Adds ANY node type to an existing scene. This is the universal node creation tool — replaces all specialized create_* node tools. Supports ALL ClassDB node types (Camera3D, DirectionalLight3D, AudioStreamPlayer, HTTPRequest, RayCast3D, etc.). Set any property via the properties parameter with type conversion support (Vector2, Vector3, Color, etc.). Use query_classes to discover available node types. Use query_class_info to discover available properties for a type.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectPath | Yes | Absolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow. | |
| scenePath | Yes | Path to .tscn file relative to project (e.g., "scenes/Player.tscn") | |
| parentNodePath | No | Node path within scene (e.g., "." for root, "Player" for direct child, "Player/Sprite2D" for nested) | |
| nodeType | Yes | Godot node class name (e.g., "Sprite2D", "CollisionShape2D", "CharacterBody2D"). Must be valid Godot 4 class. | |
| nodeName | Yes | Name for the new node (will be unique identifier in scene tree) | |
| properties | No | Optional properties to set on the node (as JSON string). Tagged Godot values such as {"position":{"type":"Vector2","x":100,"y":200}} are the most explicit form; common typed properties like Vector2 also accept inferred shapes such as {"position":{"x":100,"y":200}} or {"position":[100,200]}. |