Godot MCP Server — Tool Reference

Generated from the tool catalogue (src/registration/catalogue.ts) — regenerate with npm run docs:tools. This is the per-tool reference; for the subsystem explanation see Architecture.

112 built-in tools exposing 160 operations — an action-consolidated tool packs several operations behind one discriminator, so the operation count runs ahead of the tool count. Counts are a ceiling (“up to”); some tools and operations are Godot-version-gated and absent on older editors.

Startup surface (eager)

Registered up front — always in the initial tools/list. The two meta tools (discover_tools, extensions_refresh) are also eager but defined outside the catalogue.

34 tools, 48 operations.

`editor_save_scene`

Save the current edited scene. Optional file_path triggers save-as.

eager · idempotent

1 operation.

Param	Type	Required	Description
`file_path`	string	no

`scene_open`

Open a scene (.tscn / .scn) as the active edited scene. res:// only; NOT_FOUND if the file doesn’t exist.

eager · read-only

1 operation.

Param	Type	Required	Description
`file_path`	string	yes

`project_get_settings`

List ProjectSettings keys + values. Optional prefix filter. Keys matching /password

token

secret

key/i are dropped (MVP filter).

eager · read-only

1 operation.

Param	Type	Required	Description
`prefix`	string	no

`editor_get_console`

Tail editor Output. source=’buffer’ (default): live editor console on 4.5+, game-log tail on 4.2-4.4. source=’file’: the game-written log (never editor output, any version). level_filter, since_id, text_filter (is_regex=true for regex). Carries returned/total_lines/has_more + next_id — page via since_id. Primary post-crash diagnostic tool — reads runtime errors even after game_stop.

eager · read-only

1 operation.

Param	Type	Required	Description
`clear_buffer`	boolean	no	Clear the log buffer before reading. Use when stale errors persist after successful script recompilation.
`is_regex`	boolean	no	Treat text_filter as a regex pattern instead of a plain substring (default false).
`level_filter`	union	no	Single level or array of levels to filter by
`limit`	number	no
`since_id`	number	no
`source`	enum	no
`text_filter`	string	no	Substring to match against message text (case-insensitive). Set is_regex=true for regex patterns.

`project_set_setting`

Write a ProjectSettings key and persist via ProjectSettings.save. Refuses mcp_toolkit/, mcp/, and editor/* prefixes. Returns previous_value. Update (no status).

eager

1 operation.

Param	Type	Required	Description
`setting`	string	yes	ProjectSettings key (e.g. ‘application/config/name’)
`value`	any	yes

`folder_create`

Create directory at res:// path (recursive — parents auto-created). Idempotent: status created on fresh, returned if pre-existing.

eager · idempotent

1 operation.

Param	Type	Required	Description
`path`	string	yes

`node_get_property`

Read a property from the node at path. Returns { value } (engine types are dict-wrapped).

eager · read-only

1 operation.

Param	Type	Required	Description
`node_path`	string	yes
`property`	string	yes	Property name. Use ‘:’ to chain into sub-resources (e.g. ‘material:shader_parameter/value’).

`node_set_property`

Set a property on a node in the EDITOR scene tree (saved to .tscn files). Does NOT affect the running game — for runtime property changes during playtesting, use runtime_set_property. Node paths are relative to the edited scene root: “.” is root, “./Player” is a direct child, “./Player/Sprite2D” for deeper nodes. Engine types: {type:’Vector2’,x,y}. Inline sub-resources: {type:’NewResource’,class:’CircleShape2D’,properties:{radius:50}}. External resources (textures, audio, tilesets, materials): {type:’Resource’, path:’res://path/to/file.tres’}. Packed arrays: {type:’PackedVector2Array’, values:[{type:’Vector2’,x:0,y:0}, …]}. Collision layers: {type:’LayerMask’, layers:[1,4,6]} (by number) or {type:’LayerMask’, layers:[‘player’,’walls’]} (by name from layer_names_set); optional category defaults to ‘2d_physics’. All supported type tags: Vector2, Vector3, Vector4, Vector2i, Vector3i, Color, Rect2, Rect2i, Transform2D, Transform3D, NodePath, Resource, NewResource, PackedVector2Array, PackedVector3Array, PackedColorArray, LayerMask. Unknown type tags are rejected with an error listing supported types. Anchor presets: setting anchors_preset alone may not auto-apply underlying values. For reliable layout, set anchor_left/top/right/bottom and offset_left/top/right/bottom explicitly. Batch mode: pass batch:[{node_path, property, value, make_unique?}, …] to set multiple properties at once.

eager

1 operation.

Param	Type	Required	Description
`batch`	array	no	Batch mode: array of {node_path, property, value, make_unique?}. Omit for single-property operations. When present, top-level node_path/property/value are ignored.
`make_unique`	boolean	no	When true and the compound path targets an external (.tres) sub-resource, auto-duplicate it as an inline copy before setting. Equivalent to the Inspector’s ‘Make Unique’. Only needed for compound paths on external resources.
`node_path`	string	no	Single mode: path to target node
`property`	string	no	Single mode: property name. Compound ‘/’ paths supported. Use ‘:’ for sub-resource chaining (e.g. ‘material:shader_parameter/value’).
`value`	any	no

`node_get_property_list`

Introspect node properties. mask: common (default), all, groups, script. ‘script’ returns all script variables with public/private label; use visibility param to filter.

eager · read-only

1 operation.

Param	Type	Required	Description
`mask`	enum	no	Property filter. ‘common’ (default) returns 8-12 most-edited. ‘all’ returns full list. ‘groups’ returns names+usage only. ‘script’ returns script variables with visibility label. Prefer ‘common’ or node_get_property; ‘all’ returns the full list and is large.
`node_path`	string	yes
`visibility`	enum	yes	Filter for mask=’script’. ‘public’ = no _ prefix, ‘private’ = _ prefix, ‘all’ = both.

`node_set_script`

Attach a script (.gd/.cs) to a node. Returns @export properties exposed by the script. Empty script_path string detaches.

eager

1 operation.

Param	Type	Required	Description
`node_path`	string	yes
`script_path`	string	yes

`control_set_layout`

Set anchor preset + optional margins on a Control node in one call. Uses set_anchors_and_offsets_preset(). Returns final_rect.

eager

1 operation.

Param	Type	Required	Description
`margins`	object	no	Additive offsets applied after the preset (in pixels).
`node_path`	string	yes
`preset`	string	yes	Layout preset: PRESET_TOP_LEFT, PRESET_TOP_RIGHT, PRESET_BOTTOM_LEFT, PRESET_BOTTOM_RIGHT, PRESET_CENTER_LEFT, PRESET_CENTER_TOP, PRESET_CENTER_RIGHT, PRESET_CENTER_BOTTOM, PRESET_CENTER, PRESET_LEFT_WIDE, PRESET_TOP_WIDE, PRESET_RIGHT_WIDE, PRESET_BOTTOM_WIDE, PRESET_VCENTER_WIDE, PRESET_HCENTER_WIDE, PRESET_FULL_RECT
`resize_mode`	enum	no	keep_size (default) preserves size; set_to_anchors resizes to anchor region.

`node_call_method`

Call method with args on an edited-scene node (editor-only; for runtime nodes use execute_code).

eager · destructive

1 operation.

Param	Type	Required
`args`	array	no
`method_name`	string	yes
`node_path`	string	yes

`node_manage`

Structural node operations on the edited scene tree. action: rename — requires new_name. action: reparent — requires new_parent_path, optional keep_global_transform (default true). action: reorder — requires new_index (0-based sibling index). action: duplicate — optional new_name, parent_path, properties (overrides like {position:{x,y}}).

eager

4 operations (action): rename, reparent, reorder, duplicate

Param	Type	Required	Description
`action`	enum	yes
`keep_global_transform`	boolean	no	For reparent: preserve world transform. Default true.
`new_index`	integer	no	For reorder: 0-based sibling index.
`new_name`	string	no	Required for rename; optional for duplicate.
`new_parent_path`	string	no	Required for reparent.
`node_path`	string	yes
`parent_path`	string	no	For duplicate: target parent. Defaults to same parent.
`properties`	object	no	For duplicate: property overrides on the copy (e.g. {position:{x:100,y:200}}).

`node_groups`

Manage node group membership. Groups are the idiomatic Godot way to tag and query game objects (e.g. ‘coins’, ‘enemies’). Single mode: node_path + group (node_path required for add/remove/list). Batch mode: entries array of {node_path, group} carries per-item paths, and the top-level node_path/group are ignored. action: add — requires group. action: remove — requires group. action: list — returns all groups (single only).

eager

3 operations (action): add, remove, list

Param	Type	Required	Description
`action`	enum	yes
`entries`	array	no	Batch mode (add/remove only): array of {node_path, group}. When present, processes all entries as a batch.node_path and group params are ignored in batch mode.
`group`	string	no	Group name. Required for single add/remove.
`node_path`	string	no	Single mode: target node path. Required for single add/remove/list; omit in batch mode (provide entries instead).
`persistent`	boolean	no	For add: save to .tscn. Default true.

`autoload_manage`

Manage project autoload singletons (GameManager, AudioManager, etc.). Writes to project.godot; takes effect on next game launch. action: register — requires name + script_path. action: unregister — requires name. action: list — returns all.

eager

3 operations (action): register, unregister, list

Param	Type	Required	Description
`action`	enum	yes
`enabled`	boolean	no	For register: auto-initialize on startup. Default true.
`name`	string	no	Autoload name (e.g. ‘GameManager’). Required for register/unregister.
`script_path`	string	no	Script path (e.g. ‘res://scripts/game_manager.gd’). Required for register.

`game_start`

Start playtest. Blocks until runtime is ready by default; wait_for_runtime:false launches without blocking. scene_path:’main’

‘current’(default)

res://path. if_running:’return’ for idempotent mode.

eager

1 operation.

Param	Type	Required	Description
`if_running`	enum	no
`runtime_poll`	boolean	no	With if_running:’return’, re-check whether the already-running game’s runtime has since connected. Default false.
`scene_path`	string	no
`wait_for_runtime`	boolean	yes	Defaults true — blocks until runtime connects (or times out) so runtime tools are immediately available. Pass wait_for_runtime:false to launch without blocking.

`game_stop`

Stop the currently-playing scene (idempotent — returns was_running:false if nothing was running). No params.

eager · destructive

1 operation.

No parameters.

`runtime_screenshot`

Capture the running game window. Requires an active playtest (game_start). Use editor_screenshot for the editor viewport. image_response_mode ‘disk’ saves the PNG and returns only its path.

eager · read-only

1 operation.

Param	Type	Required	Description
`force_foreground_game`	boolean	no	If true, un-minimize + raise/focus the game window before capturing (default false). Set it when runtime_screenshot reports RUNTIME_WINDOW_MINIMIZED; leave false to avoid fighting for focus (esp. parallel game instances).
`image_detail`	enum	no	Resolution of the returned inline image only. full = native; mid ≈ 1024 px long edge; low ≈ 512 px (gross layout/motion only — not for reading text). Does not affect files written to disk.
`image_response_mode`	enum	no	How to return the capture: ‘inline’ (default) embeds the PNG; ‘disk’ persists it and returns only the path — use for very large captures or to conserve context tokens; ‘both’ does both. Files written to disk are always full resolution, regardless of image_detail.
`save_path`	string	no	Destination .png used by image_response_mode disk/both (user://screenshots/ only); auto-named when omitted.

`debugger_get_log`

Game output log. Works during gameplay AND after crash (auto-serves cached output). print()/push_* from a running game are captured here on every version (4.2-4.7) — the ‘read my own prints to validate a flow’ path. Compile errors will NOT appear here (the game must run); use script_check (one file) or lsp_project_diagnostics (whole project). source=’buffer’

‘file’. limit=200. text_filter + is_regex for search. +returned/total_lines/has_more (capped tail). Right after game_stop the first call may return GAME_NOT_RUNNING while the session registry settles — retry once (the cache serves the next call).

eager · read-only

1 operation.

Param	Type	Required	Description
`is_regex`	boolean	no	Treat text_filter as a regex pattern instead of a plain substring (default false).
`limit`	integer	no
`source`	enum	no
`text_filter`	string	no	Substring to match against log message text (case-insensitive). Set is_regex=true for regex.

`input_simulate`

Inject input into the running game. events: single {event_type, event_data?, delay_before_ms?, delay_after_ms?} for one action, or an array for a sequence of actions (prefer a single call with multiple events over separate calls). Types: key

mouse_button

mouse_motion

action

click

click_node

send_text. click is a composite: press + 50ms delay + release via push_input (no OS focus/warp; parallel-safe). click_node takes {node_path} — calls grab_focus + emits pressed on BaseButtons (no coordinate guessing). send_text types a string into the focused text field (or the event_data.node_path-targeted Control) by synthesizing per-character key events via push_input, firing the real text_changed/text_submitted signals that setting .text skips. send_text event_data: text (required), node_path? (a Control to focus first), submit? (append Enter); it returns focus_target, focus_source, text_changed, text_after (secret fields redacted), chars_sent, and a hint. Mouse coordinate modes: - position: {x, y} — raw viewport/screen coordinates (default). Use for UI elements (buttons, menus). - world_position: {x, y} — game-world coordinates, auto-translated via canvas transform (accounts for camera offset and zoom). Use for clicking at specific in-game locations. Mouse events route through push_input (position + global_position) for CanvasLayer/GUI hit-testing — no OS focus/warp, parallel-safe. Returns per-event diagnostics.

eager

7 operations (operation): key, mouse_button, mouse_motion, action, click, click_node, send_text

Param	Type	Required	Description
`events`	union	yes
`summary`	boolean	no

`runtime_get_script_vars`

Get script variables (names, values, public/private) for a live game node. Complements runtime_get_node_state (engine props only). visibility param filters.

eager · read-only

1 operation.

Param	Type	Required	Description
`node_path`	string	yes
`visibility`	enum	yes

`execute_code`

DANGER: evaluates a GDScript expression. Expression-only — no var/return/if/for statements, no = assignment. channel: ‘runtime’ (default) runs in the running game, ‘editor’ runs in the editor process. To set properties: get_node(‘/root/Main/Player’).set(‘speed’, 400) To call methods: get_node(‘/root/Main/Player’).call(‘take_damage’, 25) To read values: get_node(‘/root/Main/Player’).position Prefer runtime_set_property for single property changes (safer, no expression syntax). Use execute_code for complex multi-step operations or method calls with specific arguments. If C# project, managed methods are callable at runtime (channel:’runtime’). LIMITATION: Expression cannot access engine singletons (EditorInterface, Engine, OS, Input) or call load()/preload(). Property chaining on method return values (get_node(‘X’).position) may fail due to Variant type erasure — use scope_path to bind the node as self, or use .get(‘property’) instead (get_node(‘X’).get(‘position’) works reliably).

eager · destructive

1 operation.

Param	Type	Required	Description
`channel`	enum	no	‘runtime’ (default) evaluates in the running game — needs game_start first, else GAME_NOT_RUNNING; ‘editor’ evaluates in the editor process, no running game needed — use it for editor-state expressions.
`code`	string	yes
`scope_path`	string	no

`scene_get_tree`

Return the current edited scene’s node tree as nested JSON { name, class, path, children }. Paths use “.” for root — pass them directly to other editor commands.

eager · read-only

1 operation.

Param	Type	Required	Description
`include_properties`	boolean	no	Embed property snapshot per node. Default false.
`max_depth`	number	no	Tree depth. Default 2. Use -1 for full tree.

`scene_create_node`

Create a node of class_name under parent. Supports engine + user-defined class_name classes. Idempotent: ‘returned’ on collision, ‘created’ on fresh. Example: class_name: “CharacterBody2D”, parent_path: “.”, node_name: “Player”

eager · idempotent

1 operation.

Param	Type	Required	Description
`class_name`	string	yes
`layout_mode`	number	no	Layout mode for Control nodes: 0=free, 1=anchors. Auto-sets 1 when parent is Container.
`node_name`	string	no
`parent_path`	string	yes
`properties`	object	no	Inline property values set after creation. Same coercion as node_set_property. Partial failure keeps the node — check properties_failed. Dict iteration order is not guaranteed.
`unique_name`	boolean	no	Mark as scene-unique node for %Name access in scripts. Warns if name collides with existing unique node.

`scene_delete_node`

Delete the node at path (NodePath). Refuses to delete the edited scene root.

eager · destructive

1 operation.

Param	Type	Required	Description
`node_path`	string	yes

`scene_create`

Create .tscn at file_path. Root name = filename stem at ‘.’. root_type default Node. Idempotent: created

returned

replaced. if_exists: return

fail

replace. Use scene_open afterward to edit.

eager · idempotent

1 operation.

Param	Type	Required	Description
`file_path`	string	yes
`if_exists`	enum	no
`root_name`	string	no	Root node name override (default: filename stem).
`root_type`	string	no

`scene_query`

Search scene tree with filters (class, group, name glob, property conditions). Returns matching nodes. Faster than scene_get_tree + manual filtering. Paged: returned, total_matches, has_more. When has_more, page via next_offset until has_more is false. Stable only if the source is unchanged between calls. Results are returned in deterministic depth-first order; nodes echoes offset/limit. limit is 1-200 (default 50, clamped above 200). If the tree changes between paged reads (nodes added, removed, or reordered) results may skip or repeat — re-query from offset 0.

eager · read-only

1 operation.

Param	Type	Required	Description
`class_filter`	string	no	Class name filter (inheritance-aware, e.g. ‘CollisionShape2D’, ‘Control’)
`group_filter`	string	no	Node group membership filter
`include_properties`	array	no	Property names to include in results
`limit`	integer	no	Page size (default per tool); a request above the cap is clamped and limit_clamped is set.
`max_depth`	integer	no	Max traversal depth (-1 = unlimited, default -1)
`name_pattern`	string	no	Glob pattern for node name (e.g. ‘Enemy’, ‘Collision*’)
`offset`	integer	no	Skip the first N (default 0); pass next_offset back as offset until has_more is false.
`property_filters`	array	no	Property value conditions (AND logic)
`root_path`	string	no	Subtree root path (default: scene root)

`script_read`

Read a script file (res:// only). Returns the file content as text in an envelope. Read large scripts in successive line windows via start_line/end_line (1-indexed, inclusive). Paged: returned, total_lines, has_more. When has_more, page via next_start_line until has_more is false.

eager · read-only

1 operation.

Param	Type	Required	Description
`end_line`	integer	no	1-based last line to read (inclusive).
`file_path`	string	yes
`start_line`	integer	no	1-based first line (default 1); pass next_start_line back as start_line to page.

`script_write`

Write .gd/.cs/.gdshader/.gdshaderinc at file_path (res:// only, creates or overwrites). For .gd files, returns inline diagnostics (valid: bool, diagnostics: […]) — check valid before proceeding. Not idempotent. Use script.delete to remove; resource.create for .tres; scene.create for .tscn.

eager

1 operation.

Param	Type	Required	Description
`content`	string	yes
`file_path`	string	yes

`script_edit`

Surgically replace a span in an existing .gd/.cs/.gdshader/.gdshaderinc file (res:// only) — the MCP analogue of the native Edit tool. old_string must match the file byte-for-byte (whitespace and indentation included); no regex, no fuzzy match. old_string not found -> NOT_FOUND; matches more than once without replace_all -> NOT_UNIQUE. new_string:’’ deletes the span. replace_all replaces every occurrence and returns replacements:N. Prefer this over rewriting the whole file with script_write for a small change — it keeps the editor undo entry, reindexing, and inline diagnostics. For .gd files, returns inline diagnostics (valid: bool, diagnostics: […]) — check valid before proceeding.

eager

1 operation.

Param	Type	Required	Description
`file_path`	string	yes
`new_string`	string	yes	replacement text; empty string deletes the span
`old_string`	string	yes	exact byte-for-byte span to replace (whitespace/indent must match)
`replace_all`	boolean	no	replace every occurrence instead of requiring a unique match (default false)

`script_check`

Offline GDScript validation — pass/fail + diagnostics. On 4.5+ the error diagnostic carries the real line (1-based; omitted on 4.2-4.4). Columns are lsp_diagnostics’ domain. Works without editor.

eager · read-only

1 operation.

Param	Type	Required	Description
`file_path`	string	yes	res:// path to a .gd file

`signal_list`

List signals on a node. include_connections=true adds targets ({target_path, method_name, flags}). flags & 2 = CONNECT_PERSIST (saved in .tscn).

eager · read-only

1 operation.

Param	Type	Required	Description
`include_connections`	boolean	no
`node_path`	string	yes

`signal_manage`

Connect or disconnect a signal (editor-time, CONNECT_PERSIST — saved in .tscn, survives save/load). Idempotent connect (status ‘returned’ on collision).

eager · idempotent

2 operations (action): connect, disconnect

Param	Type	Required
`action`	enum	yes
`method_name`	string	yes
`node_path`	string	yes
`signal_name`	string	yes
`target_path`	string	yes

`scene_spatial_map`

Spatial layout of the current scene: per-node world position, bounds (2D Rect2 / 3D AABB), size, plus computed overlaps/gaps/containment. Call before placing or moving nodes to find clear space. Paged: returned, total_nodes, has_more. Cursor-less — narrow with subtree/class/region/radius or raise max_nodes for more.

eager · read-only

1 operation.

Param	Type	Required	Description
`center`	array	no	Center for radius filter: [x,y] (2D) or [x,y,z] (3D)
`class`	string	no	Only include nodes of this class (ancestry-aware)
`detail`	enum	no	brief = position/size only; normal = + bounds + overlaps; full = + containment + nearest-neighbour gaps
`max_nodes`	number	no	Response cap (default 200, max 1000)
`radius`	number	no	Only nodes within this distance of center
`region`	array	no	Only nodes intersecting this box: [x,y,w,h] (2D) or [x,y,z,sx,sy,sz] (3D)
`subtree`	string	no	Map only this node and its descendants (node path relative to the scene root)

Group: runtime_advanced

Inspect live node state, set node properties, and control AnimationPlayer during playtests

3 tools, 6 operations.

`runtime_get_node_state`

Inspect a live node in the running game. Returns { name, class, path, properties } — primarily @export vars and inspector-visible fields.

on-demand (group: runtime_advanced) · read-only

1 operation.

Param	Type	Required	Description
`node_path`	string	yes

`runtime_set_property`

Set a property on a node in the running game. Requires a running game (use game_start first). For editor-time scene editing, use node_set_property instead. Examples: node_path: “/root/Main/Player”, property: “speed”, value: 400 node_path: “/root/Main/Enemy”, property: “health”, value: 0 node_path: “/root/Main/HUD/ScoreLabel”, property: “text”, value: “Score: 999”

on-demand (group: runtime_advanced)

1 operation.

Param	Type	Required	Description
`node_path`	string	yes	Absolute path to the node in the running scene tree
`property`	string	yes	Property name (supports compound paths like ‘position:x’)
`value`	union	yes	Value to set — type is coerced to match the property’s existing type

`animation_player_control`

Drive an AnimationPlayer in the running game. operation: play

pause

stop

seek. Optional animation_name (play) or time (seek). Returns post-op state.

on-demand (group: runtime_advanced)

4 operations (operation): play, pause, stop, seek

Param	Type	Required
`animation_name`	string	no
`node_path`	string	yes
`operation`	enum	yes
`time`	number	no

Group: signals

Emit signals on scene nodes at editor-time or runtime

1 tool, 1 operations.

`signal_emit`

Emit signal_name on node with optional args. channel=’editor’ (default, edited scene) or channel=’runtime’ (the running game).

on-demand (group: signals)

1 operation.

Param	Type	Required
`args`	array	no
`channel`	enum	no
`node_path`	string	yes
`signal_name`	string	yes

Group: animation_authoring

Inspect and author keyframes, edit tracks, and configure AnimationTree state machines

4 tools, 10 operations.

`animation_keyframe`

Add/remove a keyframe on an existing animation’s track. animation must already exist; action=’add’ auto-creates the track only. Idempotent on exact-time dup.

on-demand (group: animation_authoring) · idempotent

2 operations (action): add, remove

Param	Type	Required	Description
`action`	enum	yes
`animation_name`	string	yes
`player_path`	string	yes
`time`	number	yes
`track_path`	string	yes
`track_type`	enum	no	Track type; only ‘value’ supported currently.
`value`	any	no	Required for action=’add’.

`animation_get_keys`

List keys on an AnimationPlayer track: { time, value, transition }. Read-only; no auto-track-create.

on-demand (group: animation_authoring) · read-only

1 operation.

Param	Type	Required
`animation_name`	string	yes
`player_path`	string	yes
`track_path`	string	yes

`animationtree_edit`

Configure AnimationTree state machines: set root, add/remove nodes and transitions, or set properties.

on-demand (group: animation_authoring) · destructive · idempotent

6 operations (action): set_root, add_node, remove_node, add_transition, remove_transition, set_property

Param	Type	Required	Description
`action`	enum	yes	Operation to perform on the AnimationTree.
`advance_condition`	string	no	For add_transition: condition name for conditional advance.
`advance_mode`	enum	no	For add_transition: advance mode (disabled=0, enabled=1, auto=2).
`animation_name`	string	no	For add_node with AnimationNodeAnimation: which animation to play.
`from`	string	no	For transitions: source node name.
`node_name`	string	no	For add_node/remove_node: name of the state machine node.
`node_path`	string	yes	Path to an AnimationTree node in the edited scene.
`node_type`	string	no	For add_node: AnimationNode subclass (e.g. AnimationNodeAnimation, AnimationNodeBlendSpace2D).
`position`	object	no	For add_node: graph position { x, y }.
`property`	string	no	For set_property: property name to set.
`root_type`	enum	no	For set_root: type of root node to create.
`switch_mode`	enum	no	For add_transition: when the transition fires.
`target_node`	string	no	For set_property: node name in the state machine.
`to`	string	no	For transitions: destination node name.
`value`	any	no	For set_property: value to assign.

`animationtree_list`

List an AnimationTree state machine’s structure: root type, nodes, and transitions. Read-only; no mutation.

on-demand (group: animation_authoring) · read-only

1 operation.

Param	Type	Required	Description
`node_path`	string	yes	Path to an AnimationTree node in the edited scene.

Group: input_map

List, create, and edit input actions and their key/controller bindings

2 tools, 4 operations.

`input_map_action`

Add or remove an InputMap action. action: ‘add’ or ‘remove’ (the operation). name: the input map name (e.g. ‘jump’, ‘move_left’). action=’add’ is idempotent with optional deadzone.

on-demand (group: input_map)

2 operations (action): add, remove

Param	Type	Required
`action`	enum	yes
`deadzone`	number	no
`name`	string	yes

`input_map_event`

Bind/unbind an input event to an action. action: ‘bind’ or ‘unbind’ (the operation). event: object — {type:’key’, keycode:’Space’}, {type:’mouse_button’, button_index:1}, {type:’joypad_button’, button_index:0}, {type:’joypad_motion’, axis:0, axis_value:1.0}. action=’bind’ is idempotent.

on-demand (group: input_map)

2 operations (action): bind, unbind

Param	Type	Required
`action`	enum	yes
`event`	object	yes
`name`	string	yes

Group: resource_io

Load and write Godot resources (.tres/.res) programmatically

2 tools, 2 operations.

`resource_load`

Load a res:// resource and return { class, path, properties, metadata }. Heavy fields (image, mesh_arrays) pruned; Texture2D gets size in metadata.

on-demand (group: resource_io) · read-only

1 operation.

Param	Type	Required	Description
`file_path`	string	yes

`resource_write`

Write/create a .tres/.res resource. If file exists, updates properties. If not, ‘type’ (class name) is required to create it. For TileSets, use tileset_create instead (handles atlas + physics setup).

on-demand (group: resource_io) · idempotent

1 operation.

Param	Type	Required	Description
`file_path`	string	yes
`properties`	object	no	Property values. Sub-resources in dicts: use {type:’NewResource’, class:’ClassName’, properties:{…}}.
`type`	string	no	Resource class name. Required when creating a new resource.

Group: asset_ops

List assets, query dependencies, and import binary files into the project

3 tools, 3 operations.

`asset_list`

Enumerate res:// assets with filters (path_prefix, name_glob, class_filter ancestry-aware, extension_filter). Returns [{path,class,modified_unix}]. Paged: returned, total_assets, has_more. Cursor-less — narrow filters or raise limit for more. limit caps at 2000 (default 500); a request above 2000 is clamped and limit_clamped is set (a non-positive limit is rejected).

on-demand (group: asset_ops) · read-only

1 operation.

Param	Type	Required	Description
`class_filter`	string	no
`extension_filter`	array	no
`limit`	number	no	Max assets returned (default 500, clamped to 2000)
`name_glob`	string	no
`path_prefix`	string	no

`asset_get_dependencies`

Forward dependencies of a res:// resource/scene via EditorFileSystem cache. include_transitive walks deps-of-deps. Returns [{path,raw_path,class}]. Paged: returned, total_dependencies, has_more. Cursor-less — narrow the query or raise limit for more.

on-demand (group: asset_ops) · read-only

1 operation.

Param	Type	Required	Description
`file_path`	string	yes
`include_transitive`	boolean	no
`limit`	number	no	Max dependencies returned (default 200)

`asset_import`

Import binary asset (image/audio/font/3D) into res:// via exactly one of source_path (absolute or res:// path) or base64_data. Triggers EditorFileSystem scan. if_exists:return

fail

replace.

on-demand (group: asset_ops) · idempotent

1 operation.

Param	Type	Required
`base64_data`	string	no
`dest_path`	string	yes
`if_exists`	enum	no
`source_path`	string	no
`wait_for_scan_ms`	number	no

Group: placeholders

Generate placeholder/prototype assets procedurally — textures (shapes, patterns, labels) and sound effects (tones, noise). No art or network needed.

2 tools, 2 operations.

`texture_generate`

Generate a placeholder PNG (imports as Texture2D): a shape (solid/circle/triangle/diamond/arrow/checkerboard/grid) with fill/outline/background colours + an optional text label. Dimensions <=1024px.

on-demand (group: placeholders)

1 operation.

Param	Type	Required	Description
`background_color`	union	no	Canvas colour behind the shape (default transparent)
`cell_size`	number	no	Cell size for checkerboard/grid
`direction`	enum	no	Arrow direction
`file_path`	string	yes	res:// destination ending in .png
`fill_color`	union	no	Interior colour; transparent = hollow shape
`height`	number	no	Pixels, 1-1024 (default 64)
`if_exists`	enum	no
`label`	string	no	Optional text overlaid centred on any shape
`label_color`	union	no
`outline_color`	union	no	Border colour; transparent/omitted = no border
`outline_width`	number	no	Border thickness in pixels (default 1)
`shape`	enum	no
`wait_for_scan_ms`	number	no
`width`	number	no	Pixels, 1-1024 (default 64)

`sound_generate`

Generate a placeholder sound effect (mono WAV): waveform sine/square/triangle/sawtooth/noise, frequency, duration <=5s, volume, optional pitch sweep + fade/decay envelope. SFX only, no music.

on-demand (group: placeholders)

1 operation.

Param	Type	Required	Description
`decay`	number	no	Exponential decay time-constant in seconds (>0 = pluck/bell)
`duration`	number	no	Seconds, max 5 (default 0.3)
`end_frequency`	number	no	If set, pitch sweeps frequency -> end_frequency over the duration
`fade_in`	number	no	Fade-in seconds (default ~0.003 de-click)
`fade_out`	number	no	Fade-out seconds (default ~0.003 de-click)
`file_path`	string	yes	res:// destination ending in .wav
`frequency`	number	no	Hz (default 440; ignored for noise)
`if_exists`	enum	no
`volume`	number	no	Peak amplitude 0-1 (default 0.8)
`wait_for_scan_ms`	number	no
`waveform`	enum	no

Group: cleanup

Delete files, scripts, scenes, resources, and folders; close open scenes

6 tools, 6 operations.

`file_delete`

Delete any file under res:// and its .import companion. Auto-closes .tscn/.scn editor tabs on 4.5+ (tab_closed:true). Use for assets not covered by scene/script/resource.delete.