Tools

Get Godot project metadata (name, Godot version, main scene, autoloads, feature tags).

Get all project.godot settings as structured JSON (sections and keys).

List files in the Godot project (excludes the .godot cache and .import sidecars by default).

Read a UTF-8 text file inside the Godot project.

Create or edit a file in the project. Requires Safe Edit or Full Control mode; protected files (project.godot, .godot cache, the Godot MCP Studio addon) require Full Control.

Delete a file in the project. Destructive: requires Full Control mode.

Copy a file within the project (sidecars are regenerated by the editor). Requires Safe Edit or Full Control.

Create a directory (and any missing parents) inside the project. Requires Safe Edit or Full Control.

Move or rename a file within the project, carrying its .import and .uid sidecars so Godot keeps import settings and UID references. Requires Safe Edit or Full Control.

Search the text contents of project files (grep-like). Skips the .godot cache and, by default, the addons folder.

Find project files by filename (case-insensitive substring match).

List scene (.tscn) files with their root node name and type. Works with the editor closed.

Get the resource dependencies (ext_resource paths) referenced by a scene file.

List GDScript/C# scripts with their class_name and extends. Works with the editor closed.

Get project statistics: file counts by kind and total script lines.

Find assets, resources, scenes, and shaders that nothing in the project references (no res:// path or uid:// use anywhere), so dead files can be reviewed and removed. Works with the editor closed.

Detect dependency cycles between scenes and resources (ext_resource references). Cycles make scenes hard to reason about and can break preloading. Works with the editor closed.

Get the tree of the scene currently open in the Godot editor (requires the editor to be open with the Godot MCP Studio addon enabled).

Get recent editor bridge log lines (Phase 1 subset of editor output).

Capture a screenshot of the Godot editor's main viewport so you can see the current editor state.

Get the nodes the user currently has selected in the editor's scene tree. The way to see what the user is pointing at.

Select a node in the editor's scene tree and focus the inspector on it, so the user can see the node being discussed. Requires Safe Edit or Full Control.

Replace a node with a new class (the editor's Change Type), keeping the name, children, groups, and compatible properties. Requires Safe Edit or Full Control.

Toggle a node's scene-unique name so scripts can reference it as %Name. Requires Safe Edit or Full Control.

Set several properties on a node in one call and one undo step. `properties` maps property names to values (arrays for vectors/colors). Requires Safe Edit or Full Control.

Add a Timer with wait_time, autostart, and one_shot in one call, optionally connecting its timeout signal to a method on another node. Requires Safe Edit or Full Control.

Set the same property on many nodes in one call and one undo step, e.g. hide every enemy at once. Requires Safe Edit or Full Control.

Read the same properties from many nodes in one call, a row per node, for auditing scene state without a request per node.

Set a property on every node of a class across every saved scene in the project (a cross-scene refactor). Open scenes are skipped and reported; changes save to disk and are not undoable. Requires Full Control.

Get the editor properties of a node in the open scene (path relative to the scene root).

Search the open scene for nodes by class (with inheritance) and/or name substring. The fast way to navigate a large scene.

Open a scene (.tscn) in the editor so live scene tools act on it.

Create a new scene file with a root node and open it. Requires Safe Edit or Full Control.

Add a node of the given class under a parent in the open scene. Requires Safe Edit or Full Control.

Instance a scene (.tscn) as a child node in the open scene, the way reusable game objects are composed. Requires Safe Edit or Full Control.

Duplicate a node (and its children) within the open scene. Requires Safe Edit or Full Control.

Delete a node from the open scene. Destructive: requires Full Control mode.

Rename a node in the open scene. Requires Safe Edit or Full Control.

Move a node to a new parent in the open scene. Requires Safe Edit or Full Control.

Set a property on a node in the open scene. Vector/color values accept arrays like [x, y]. Requires Safe Edit or Full Control.

Connect a signal from one node to a method on another. Requires Safe Edit or Full Control.

Save the scene currently open in the editor to disk. Requires Safe Edit or Full Control.

Turn a node's subtree into a reusable .tscn (Godot's Save Branch as Scene) and replace the branch with an instance of it, the way prefabs are built. Requires Safe Edit or Full Control.

Read a script file's source via the editor.

Create a new script file. Requires Safe Edit or Full Control.

Replace the source of an existing script file. Requires Safe Edit or Full Control.

Compile-check GDScript source (or an existing script) without running it; reports whether it is valid.

Attach a script resource to a node in the open scene. Requires Safe Edit or Full Control.

Scaffold a minimal finite-state-machine script (enter/exit/update stubs per state) and attach it to a node, the backbone for enemy and player behaviour. Requires Safe Edit or Full Control.

List the signals a node can emit (built-in and script-defined), with their argument names.

List the existing signal connections coming out of a node (signal, target node, method).

Disconnect a signal connection between two nodes in the open scene. Requires Safe Edit or Full Control.

List groups: a node's groups when `path` is given, otherwise every group used in the open scene.

Add a node to a group (persisted into the scene). Requires Safe Edit or Full Control.

Remove a node from a group in the open scene. Requires Safe Edit or Full Control.

List the node paths in a given group within the open scene.

Run the project's main scene. Requires Safe Edit or Full Control.

Run a specific scene. Requires Safe Edit or Full Control.

Stop the running game.

Report whether a scene is currently running in the editor.

Write and run a game test: provide `body` with check(cond, msg) assertions (or a full `source`). Runs in a headless Godot subprocess and reports pass/fail and output. Executes code; requires Full Control mode.

Get the live scene tree of the RUNNING game (start it with play_project/play_scene first).

Get the errors, script errors, and warnings the RUNNING game has raised (push_error, crashes in scripts). The way to find out why the game is misbehaving.

Get the print() output the RUNNING game has produced, for reading debug logs live.

Sample a node property in the RUNNING game over time (up to 8 seconds) and return the series. The way to verify motion, physics, and animation actually happen.

Restart the RUNNING game's current scene, for fast iteration without stopping and replaying. Requires Safe Edit or Full Control.

Get a node's live property values in the RUNNING game.

Set a property on a node in the RUNNING game (does not persist to the scene file). Requires Safe Edit or Full Control.

Call a method on a node in the RUNNING game and return its result. Executes game code; requires Full Control mode.

Cast a native Godot 3D physics ray in the RUNNING game. Use world-space from/to points, or camera_path plus an optional screen position for FPS hitscan and line-of-sight verification. Returns collider, hit position, normal, shape and face indices.

Simulate player input in the RUNNING game: an input action, key press, mouse click, or mouse motion. Requires Safe Edit or Full Control.

Run a timed multi-step input sequence in the RUNNING game (combos, move-then-jump, menu flows): steps of action/key/mouse events with hold and delay timing, plus wait steps. Requires Safe Edit or Full Control.

Wait until a node exists in the RUNNING game (spawns, scene changes, opening UI) or a timeout passes, then report which. Use before asserting on nodes that appear asynchronously.

List interactive UI in the RUNNING game (buttons, inputs, sliders) with text, screen rect, and disabled/focus state, optionally filtered by text. The map of what is clickable right now.

Click a button/control in the RUNNING game by its visible text (or exact path), via real simulated mouse press and release at its center. Requires Safe Edit or Full Control.

Start recording the player's real input (keys, mouse) with timestamps in the RUNNING game, for building regression replays from an actual session. Requires Safe Edit or Full Control.

Stop the input recording in the RUNNING game and return the captured events (also kept in the game for game_replay_input).

Replay recorded input events with their original timing in the RUNNING game (background playback; observe with screenshots or monitors). Omit events to replay the last recording. Requires Safe Edit or Full Control.

Assert a node property in the RUNNING game against an expected value (eq, ne, gt, lt, ge, le, contains) and get a pass/fail with the actual value. The building block for automated play-test checks.

Capture a screenshot of the RUNNING game's viewport so you can see what the player sees.

Get live performance metrics of the RUNNING game: FPS, frame times, memory, node count, draw calls.

Set the RUNNING game's engine time scale (slow motion / fast forward). Requires Safe Edit or Full Control.

Pause or unpause the RUNNING game's scene tree. Requires Safe Edit or Full Control.

Report physics contacts in the RUNNING game: floor/wall/ceiling and slide collisions for character bodies, overlaps for areas, colliding bodies for rigid bodies. Empty path walks the whole scene. The way to debug why something is (not) colliding.

Capture a short sequence of viewport frames from the RUNNING game as PNGs (motion the agent can review), spaced over time. Returns the saved frame paths.

Set the RUNNING game viewport's debug draw mode (disabled, unshaded, wireframe, overdraw, normal_buffer) to inspect rendering. Requires Safe Edit or Full Control.

Set import parameters for an asset and reimport it, e.g. {"edit/loop_mode": 1} to make a WAV loop. Requires Safe Edit or Full Control.

List project asset files, optionally filtered by kind (texture, audio, scene, script, model, font, resource).

Get a resource's class, name, and stored properties.

Get an image asset's pixel dimensions; check this before slicing a sprite sheet or sizing a tileset.

Compare two images pixel by pixel (before/after screenshots, texture revisions): changed-pixel ratio, changed-region bounding box, and an optional saved red-mask diff image.

Translate between uid:// identifiers and res:// paths, in either direction. Scenes and scripts reference resources by uid.

Create a Resource (.tres/.res) of any Resource subclass with initial properties. Requires Safe Edit or Full Control.

Set properties on an existing Resource file. Requires Safe Edit or Full Control.

Read a Resource file's class and stored properties.

Create a Curve resource (.tres) from [[x, y], ...] control points, for particle scale/alpha curves and easing. Requires Safe Edit or Full Control.

Create a Gradient resource (.tres) from colors and optional offsets, for particle color ramps and shader ramps. Requires Safe Edit or Full Control.

Add an AnimatedSprite2D with SpriteFrames cut from a sprite-sheet grid: hframes x vframes, animations mapped to frame indices with fps and loop. Requires Safe Edit or Full Control.

Rename an animation inside an AnimationPlayer's library. Requires Safe Edit or Full Control.

List the animations on an AnimationPlayer node.

Create an animation on an AnimationPlayer node. Requires Safe Edit or Full Control.

Add a value track to an animation targeting a node's property. Requires Safe Edit or Full Control.

Insert a keyframe on an animation track. Values coerce to the property's type. Requires Safe Edit or Full Control.

Get an animation's length, loop flag, and tracks.

Add an AnimationTree with a state-machine root, wired to an AnimationPlayer and active. The base for blend/state animation. Requires Safe Edit or Full Control.

Add a state (an animation) to an AnimationTree's state machine. Requires Safe Edit or Full Control.

Connect two states in an AnimationTree's state machine, optionally auto-advancing. Requires Safe Edit or Full Control.

The states and transitions of an AnimationTree's state machine.

Remove an animation from an AnimationPlayer's library. Requires Safe Edit or Full Control.

Author a simple property tween (move/fade/scale over time) as an AnimationPlayer animation with two keyframes, without writing GDScript; the player is created under the target when none is given. Requires Safe Edit or Full Control.

Add an audio effect (reverb, delay, chorus, distortion, compressor, limiter, phaser, eq, lowpass, highpass, amplify, pitch_shift) to a bus with property overrides. Requires Safe Edit or Full Control.

Create an AudioStreamRandomizer from audio files with pitch and volume variation, saved as .tres and optionally assigned to a player, for non-repetitive sound effects. Requires Safe Edit or Full Control.

Add an AudioStreamPlayer (plain, 2d, or 3d) with its stream, bus, and autoplay set in one call. Requires Safe Edit or Full Control.

Audit every audio player in a subtree (default: whole scene): stream, bus (and whether it exists), volume, autoplay; plus the bus list.

List the audio buses and their volumes.

Add an audio bus. Requires Safe Edit or Full Control.

Set an audio bus's volume/mute/send. Requires Safe Edit or Full Control.

Persist the current audio bus layout to res://default_bus_layout.tres. Requires Safe Edit or Full Control.

List the project's input actions.

Add an input action. Requires Safe Edit or Full Control.

Bind a physical key to an input action. Requires Safe Edit or Full Control.

Remove an input action. Destructive: requires Full Control mode.

Bind an input event to an action: key, mouse_button, joy_button, or joy_axis. Covers keyboard, mouse, and gamepad. Requires Safe Edit or Full Control.

Paint a single cell on a TileMapLayer. Requires Safe Edit or Full Control.

Fill a rectangle of cells on a TileMapLayer. Requires Safe Edit or Full Control.

Read a TileMapLayer cell's source and atlas coords.

Clear all cells on a TileMapLayer. Destructive: requires Full Control mode.

List the used cells of a TileMapLayer.

Paint many TileMapLayer cells in one call: `cells` is [[x, y], ...] sharing one source/atlas tile. The bulk way to lay out a level. Requires Safe Edit or Full Control.

Create a TileSet resource from an atlas texture (grid of tile_width x tile_height tiles), save it as .tres, and optionally assign it to a TileMapLayer. Requires Safe Edit or Full Control.

A TileMapLayer's tileset summary: tile size, atlas sources with their textures and grids, and used cell count. Check this before painting.

Add a Line2D from [[x, y], ...] points with width, color, and closed flag, for trails, lasers, and drawn shapes. Requires Safe Edit or Full Control.

Add a CanvasModulate that tints every node on the canvas, for day/night and mood. Requires Safe Edit or Full Control.

Add a PointLight2D or DirectionalLight2D with color, energy, and (for point lights) a texture. Requires Safe Edit or Full Control.

Add a LightOccluder2D with an occluder polygon from [[x, y], ...] points, so 2D lights cast shadows. Requires Safe Edit or Full Control.

Add a Parallax2D layer with a scroll scale and repeat size, for scrolling layered backgrounds. Requires Safe Edit or Full Control.

Add a Polygon2D from [[x, y], ...] points with a fill color, for flat shapes without art. Requires Safe Edit or Full Control.

Set position, rotation_degrees, and/or scale on a Node2D or Control in one call. Vectors are [x, y] arrays. Requires Safe Edit or Full Control.

Generate a solid or checkerboard placeholder PNG inside the project, so scenes are visible and playable before real art exists. Requires Safe Edit or Full Control.

Assign a Texture2D to a node's texture property (Sprite2D, TextureRect, ...). Requires Safe Edit or Full Control.

Add a Sprite2D with its texture and position in one call. Requires Safe Edit or Full Control.

Add an AnimatedSprite2D with SpriteFrames sliced from a sprite-sheet texture grid (h_frames x v_frames), ready to play. Requires Safe Edit or Full Control.

Add a Camera2D, optionally enabled (the one the game uses) with position and zoom. Requires Safe Edit or Full Control.

Add a Decal that projects a texture onto surfaces (bullet holes, blob shadows, signage) with a size and position. Requires Safe Edit or Full Control.

Add a ReflectionProbe for local reflections, with a size and box projection. Requires Safe Edit or Full Control.

Add a SubViewport with a render size, for minimaps, render targets, and 3D-in-2D. Requires Safe Edit or Full Control.

Add a BoneAttachment3D under a Skeleton3D, bound to a named bone, for attaching weapons and props. Requires Safe Edit or Full Control.

Add a GridMap with an optional MeshLibrary and cell size, for 3D tile-based levels. Requires Safe Edit or Full Control.

Set a GridMap cell to a MeshLibrary item (item -1 clears the cell). Requires Safe Edit or Full Control.

Create a StandardMaterial3D from a named preset (metal, chrome, plastic, rubber, glass, emissive, toon, unshaded) with an optional tint, save it as .tres, and optionally assign it. Requires Safe Edit or Full Control.

Add 3D text: a MeshInstance3D with a TextMesh, with font size, extrusion depth, and color. Requires Safe Edit or Full Control.

Generate a terrain: a noise-displaced mesh from size, resolution, height, seed, and frequency, with optional trimesh collision. Requires Safe Edit or Full Control.

Set the boolean operation (union, subtraction, intersection) on a CSG shape, for carving and combining level geometry. Requires Safe Edit or Full Control.

Scatter instances of a mesh over an area with one MultiMeshInstance3D: seeded random positions, rotations, and scales, for trees, rocks, and props. Requires Safe Edit or Full Control.

Add a SpringArm3D camera boom that keeps its child camera out of walls, with length and an optional Camera3D child, for third-person cameras. Requires Safe Edit or Full Control.

Add global illumination: a VoxelGI probe (realtime) or LightmapGI (baked), for bounced light. Requires Safe Edit or Full Control.

Add a 3D primitive mesh (box, sphere, cylinder, capsule, plane, prism, torus). Requires Safe Edit or Full Control.

Add a 3D light (directional, omni, spot). Requires Safe Edit or Full Control.

Add a Camera3D. Requires Safe Edit or Full Control.

Set a StandardMaterial3D (albedo color, metallic, roughness) on a MeshInstance3D. Requires Safe Edit or Full Control.

Add a CSG shape (box, sphere, cylinder, torus) with a boolean operation (union to build, subtraction to carve) for 3D level blockout. Collision on by default. Requires Safe Edit or Full Control.

Create a real Godot StandardMaterial3D resource (color, metallic, roughness, emission, albedo/normal textures, transparency, cull mode), save it as .tres, and optionally assign it in the edited scene. Generates no gameplay script. Requires Safe Edit or Full Control.

Edit a MeshInstance3D material as an undoable serialized editor resource, including res:// texture properties; shared materials are duplicated into a scene-local override first. Generates no gameplay script. Requires Safe Edit or Full Control.

Tune an existing WorldEnvironment: glow/bloom, fog, tonemap (linear/reinhard/filmic/aces), and ambient energy, beyond the initial add_environment. Requires Safe Edit or Full Control.

Orient a Node3D to look at a target node or along a direction vector, for cameras, turrets, and AI. Requires Safe Edit or Full Control.

Set position, rotation_degrees, and/or scale on a Node3D in one call. Vectors are [x, y, z] arrays. Requires Safe Edit or Full Control.

Add a WorldEnvironment with a procedural sky, sky ambient light, and optionally a shadowed sun. One call makes an empty 3D scene look lit. Requires Safe Edit or Full Control.

Add a Control node (Label, Button, Panel, ...) with its text and anchors preset in one call. The quick way to build UI. Requires Safe Edit or Full Control.

Apply a Control anchors preset (center, full_rect, top_wide, ...) like the editor's Layout menu, the sane way to lay out UI. Requires Safe Edit or Full Control.

Add a layout container (vbox, hbox, grid, margin, center, panel, scroll, ...) with grid columns, child sizing flags, separation, and an anchors preset, so responsive layouts are one call instead of manual anchor math. Requires Safe Edit or Full Control.

Style one Control through undoable, serialized theme overrides (font size, font color, outline, minimum size, modulate). Visible before Play and generates no gameplay script. Requires Safe Edit or Full Control.

Assign an imported Godot Texture2D resource to a TextureRect/TextureButton through undoable editor history, with stretch and expand settings serialized in the scene. Generates no gameplay script. Requires Safe Edit or Full Control.

Assign an imported Texture2D as a Button or other Control icon through editor undo, with optional expansion and alignment. The resource reference is serialized in the scene and no gameplay script is generated. Requires Safe Edit or Full Control.

Add a ProgressBar (health/mana/stamina) with min, max, value, and optional fill and background colors, styled through theme overrides in one call. Requires Safe Edit or Full Control.

Connect a button's pressed signal (or toggled/button_down) to a method on a target node in one call, the most common UI wiring. Requires Safe Edit or Full Control.

Import a .ttf/.otf/.woff font and assign it as a per-node override, a Theme's default font, or both, so text uses a real typeface. Requires Safe Edit or Full Control.

Set a Camera2D's scroll limits and optional position smoothing, so the camera stops at level edges and eases toward its target. Requires Safe Edit or Full Control.

Add a Marker2D/Marker3D (auto-detected from the parent) at an optional position, for spawn points and reference transforms. Requires Safe Edit or Full Control.

Add a RemoteTransform2D/3D (auto-detected) that drives a target node's transform, for camera rigs and followers. Requires Safe Edit or Full Control.

Add a Path2D/Path3D (auto-detected) with a curve built from points, for patrol routes and rails. Requires Safe Edit or Full Control.

Add a PathFollow2D/3D under a Path node, with progress and loop, so a node moves along the path. Requires Safe Edit or Full Control.

Add a VisibleOnScreenNotifier2D/3D (auto-detected) for on-screen detection, spawn/despawn, and culling. Requires Safe Edit or Full Control.

Add a MultiplayerSpawner that replicates spawned scenes under a path, for networked games. Requires Safe Edit or Full Control.

Add a MultiplayerSynchronizer that replicates a node's properties across the network. Requires Safe Edit or Full Control.

List every bone of a Skeleton3D (index, name, parent, rest position). Point at the skeleton or any ancestor of an imported model.

Pose one bone of a Skeleton3D by name or index: position, rotation_degrees, scale. Requires Safe Edit or Full Control.

Reset every bone of a Skeleton3D back to its rest pose. Requires Safe Edit or Full Control.

Describe a MeshInstance3D: surfaces with materials and vertex counts, blend shapes with values, AABB, and skeleton path.

Set a blend-shape weight on a MeshInstance3D by shape name, for facial expressions and morphs. Requires Safe Edit or Full Control.

List animations inside a scene file, including imported .glb/.gltf/.fbx models: every AnimationPlayer with animation names, lengths, and loop modes.

Create a Skeleton3D from a bone list ({name, parent, position, rotation_degrees} each), for custom rigs. Requires Safe Edit or Full Control.

Append a bone to a Skeleton3D with a parent bone, rest position, and rotation. Requires Safe Edit or Full Control.

Set a bone's rest transform (position, rotation_degrees, scale) by name or index, and pose it there. Requires Safe Edit or Full Control.

Create a Skeleton2D with a hierarchy of Bone2D nodes for cutout animation. Requires Safe Edit or Full Control.

Create a BoneMap resource for animation retargeting, optionally using SkeletonProfileHumanoid. Requires Safe Edit or Full Control.

Add a LookAtModifier3D under a Skeleton3D to drive a bone toward a target. Requires Safe Edit or Full Control.

Add a CSGPolygon3D extruded from a 2D outline for fast level geometry. Requires Safe Edit or Full Control.

Add an OccluderInstance3D with a BoxOccluder3D resource for occlusion culling. Requires Safe Edit or Full Control.

Set a body's PhysicsMaterial: friction, bounce, rough, absorbent, for ice, rubber, and game feel. Requires Safe Edit or Full Control.

Add a CollisionPolygon2D/3D (auto-detected) from [[x, y], ...] points; the 3D polygon extrudes by depth. Requires Safe Edit or Full Control.

Add a ShapeCast2D/3D (auto-detected) with a sphere or box shape and cast vector, for thick raycasts like melee sweeps and ground checks. Requires Safe Edit or Full Control.

Generate collision for a MeshInstance3D (e.g. an imported model): a static trimesh for level geometry or a convex hull for dynamic bodies. Requires Safe Edit or Full Control.

Add a complete 3D physics body in one call: body (character, static, rigid, or area), a fitted collision shape (box, sphere, capsule), and a matching visible mesh. Requires Safe Edit or Full Control.

Add a CollisionShape2D/3D (auto-detected) with a shape under a physics body/area. Requires Safe Edit or Full Control.

Set collision_layer/collision_mask bitmasks on a physics body/area. Requires Safe Edit or Full Control.

Get a node's collision type, dimension, layer, and mask.

Add a RayCast2D/RayCast3D (auto-detected from the parent) with target vector, collision mask, and enabled flag in one call. Requires Safe Edit or Full Control.

Set collision_layer/collision_mask by their project-settings layer names instead of raw bitmasks, so intent survives renumbering. Requires Safe Edit or Full Control.

Add a complete 2D physics body in one call: body (character, static, rigid, or area), a fitted collision shape, and optionally a sprite. The building block for players, platforms, enemies, and pickups. Requires Safe Edit or Full Control.

Create a Theme resource (.tres). Requires Safe Edit or Full Control.

Set a theme color (item name + control type). Requires Safe Edit or Full Control.

Set a theme constant. Requires Safe Edit or Full Control.

Set a theme font size. Requires Safe Edit or Full Control.

Get a theme's default font size and defined color/constant types.

Assign an external Godot Theme .tres resource to a Control through editor undo so the UI style is serialized and visible before Play. Generates no gameplay script. Requires Safe Edit or Full Control.

Set a flat StyleBox (background color, corner radius, border, content margin) on a theme entry, e.g. a Button's normal state or a Panel's panel. Requires Safe Edit or Full Control.

Write a ready-made 2D shader preset (outline, flash, dissolve, scroll, grayscale, wave) as a .gdshader and optionally assign it to a node. Requires Safe Edit or Full Control.

Create a .gdshader file. Requires Safe Edit or Full Control.

Read a shader's source.

Replace a shader's source. Requires Safe Edit or Full Control.

Assign a shader to a node as a ShaderMaterial. Requires Safe Edit or Full Control.

Set a uniform on a node's ShaderMaterial (assign_shader first). Requires Safe Edit or Full Control.

List the uniforms a node's shader exposes, with current values.

Add a NavigationLink2D/3D (auto-detected) connecting two positions, for jumps, ladders, and teleports across the navmesh. Requires Safe Edit or Full Control.

Add a NavigationObstacle2D/3D (auto-detected) with a radius that agents route around. Requires Safe Edit or Full Control.

Add a NavigationRegion (2D/3D auto-detected) under a parent. Requires Safe Edit or Full Control.

Add a NavigationAgent (2D/3D auto-detected) under a parent. Requires Safe Edit or Full Control.

Get a navigation node's type and layers.

Bake a NavigationRegion2D/3D from the geometry under it, so agents can path immediately. Requires Safe Edit or Full Control.

Set navigation/avoidance layer bitmasks on a navigation region, agent, link, or obstacle. Each accepts a bitmask int or an array of layer numbers (1-32). Requires Safe Edit or Full Control.

Add a GPUParticlesCollisionBox3D/Sphere3D so 3D particles collide with it. Requires Safe Edit or Full Control.

Add a GPUParticles node (2D/3D auto-detected) with a process material. Requires Safe Edit or Full Control.

Set particle process properties: amount, lifetime, gravity, velocity (single or min/max range), scale, color, direction, spread, emission shape (point/sphere/sphere_surface/box/ring with radius or extents), one_shot, explosiveness, preprocess. Requires Safe Edit or Full Control.

Give particles a color-over-lifetime ramp from [r,g,b,a] stops, serialized into the process material. Requires Safe Edit or Full Control.

Inspect a GPUParticles node's full configuration: emission state, one_shot, explosiveness, and the process material's direction, spread, velocity range, gravity, color, scale range, emission shape, and color ramp.

Add a ready-made VFX particle node (muzzle_flash, explosion, sparks, smoke, fire, rain, snow) with a tuned ParticleProcessMaterial, instead of configuring one by hand. Requires Safe Edit or Full Control.

Configure the game window in one call: resolution, fullscreen, stretch mode/aspect, and title. Requires Safe Edit or Full Control.

Set the scene the game starts with (application/run/main_scene), validating the scene exists. The last step that makes a project runnable. Requires Safe Edit or Full Control.

Read a project setting value.

Set a project setting value and save. Requires Safe Edit or Full Control.

Register an autoload singleton. Requires Safe Edit or Full Control.

Remove an autoload singleton. Destructive: requires Full Control mode.

Compile-check every GDScript in the project and report which ones fail to parse. Great for finding what's broken.

List the editor configuration warnings (the yellow triangles) on nodes in the open scene.

The errors and warnings the editor process has raised since the addon started (script errors, import problems). Pass clear to reset the buffer.

Read captured Godot debugger errors and warnings with sequence filtering and script backtraces. Reports whether capture is supported (Godot 4.5+). Pass after_sequence to poll only new errors, or clear to reset the buffer.

List every tool currently registered by this MCP server. Optionally search names/descriptions or include full input schemas. Use this instead of guessing which Godot tools are available.

List instantiable Godot classes, optionally filtered. Defaults to Node types. Discover what nodes exist before adding them.

Describe a Godot class: its properties, methods, and signals from ClassDB. The way to learn a node's API without guessing.

Run an arbitrary GDScript snippet inside the editor. The snippet must define `func run():` and may return a value. Has full access to the editor API for automation the fixed tools don't cover. Executes code; requires Full Control mode.

List the project's export presets (name, platform, runnable, output path).

Export/build the project with a preset to an output path. Needs the matching export templates installed. Executes a build; requires Full Control mode.

Create a complete main-menu scene with title, Play, and Quit buttons, wired to a script. Requires Safe Edit or Full Control.

Create a pause-menu scene that toggles with ui_cancel and provides Resume and Quit buttons. Requires Safe Edit or Full Control.

Create a settings-menu scene with master volume, fullscreen, and Back controls persisted through ConfigFile. Requires Safe Edit or Full Control.

Create and register a ConfigFile-based save-system autoload with typed save/load/delete helpers. Requires Safe Edit or Full Control.

Launch 2-8 independent game instances for live multiplayer testing. Requires Full Control and confirmation.

Launch Godot Movie Maker mode to record a scene to a movie file for trailers or bug reports. Requires Full Control and confirmation.

Paint connected autotile terrain across TileMapLayer cells using the TileSet terrain rules. Requires Safe Edit or Full Control.

Fill a box, shell, floor, or line of GridMap cells in one call. Requires Safe Edit or Full Control.

Author a script-free day/night cycle as a serialized looping AnimationPlayer track that rotates a DirectionalLight3D. Visible and editable in Godot before Play. Requires Safe Edit or Full Control.

Author a script-free minimap rig from serialized SubViewport, orthographic Camera3D, and RemoteTransform3D nodes. Visible and editable in Godot before Play. Requires Safe Edit or Full Control.

Create or replace an export preset in export_presets.cfg for a target platform. Requires Safe Edit or Full Control.

Create a Translation resource from key/value messages and register it with the project. Requires Safe Edit or Full Control.

Set the locale used for editor preview and the next game run. Requires Safe Edit or Full Control.

Align Node2D or Control nodes along the x or y axis using the first node as the reference. Requires Safe Edit or Full Control.

Distribute Node2D or Control nodes evenly along x or y with explicit spacing. Requires Safe Edit or Full Control.

Copy an external local asset into res://, trigger import, and optionally apply import settings. Requires Full Control and confirmation.