Run a read-only RQL query over nodes, scenes, resources, files, classes, project settings and editor state, and get compact rows back.
query*string
A few MCP tools plus RQL, one query language for nodes, scenes, resources, files and editor state, alongside C# / GDScript files and screenshots.
21 are MCP tools the agent calls directly. The other 26, marked RQL, are done with one RQL query through rql-query / rql-mutate. Extensions add no tools of their own: each one teaches RQL a new area.
Query & change nodes, scenes, resources, files
Run a read-only RQL query over nodes, scenes, resources, files, classes, project settings and editor state, and get compact rows back.
query*stringChange the editor with an RQL set or call query: edit properties, add, move or free nodes, open and save scenes, create or move resources. All-or-nothing and undoable, with a dry run preview.
query*stringdry_runboolList the RQL sources, functions and node classes in the edited scene; with a type name, its members, methods and Godot properties.
typestringCRUD · attach · build · run C# in the editor
Read a .cs or .gd script file.
path*stringCreate a new script file.
path*stringcontentsstringUpdate an existing script file's contents.
path*stringcontents*stringDelete a script file.
path*stringAttach a script to a node.
node*NodePathscript*stringValidate GDScript (.gd) files and return structured parse/compile diagnostics. Omit the path to scan every .gd file under res://.
scriptPathstringBuild the project's C# so new scripts load. The result arrives after Godot reloads the assembly.
Compile and run C# in the editor with Roslyn and return the value and printed output.
csharpCode*stringViewport · camera · isolated renders
Capture the editor viewport as a PNG.
Capture from a specific camera.
camera*NodePathRender a node in isolation from a chosen angle.
node*NodePathRead & clear logs in a running game
Read the logs collected in a running game, with filtering.
minSeverityenum<Log|Warning|Error>limitintClear the log cache of a running game.
Find & call C# methods in a running game
In a running game, find C# methods, including private, across every loaded assembly.
query*stringIn a running game, call any C# method with input parameters and get the result.
method*stringargsobject[]Poll errors from the running game (opt-in)
Read errors captured inside the running game (GDScript runtime errors, push_error/push_warning, shader errors, unhandled C# exceptions); poll only new ones via sinceSequence. Off by default — opt in with builder.WithRuntimeErrorCapture().
sinceSequencelongmaxEntriesintClear the captured in-game runtime-error buffer (a no-op when capture is not enabled).
Lightweight readiness probe
Lightweight readiness probe — echoes a message back, or returns pong. Verifies the end-to-end MCP path.
messagestringAnimationPlayer · libraries · tracks · keys
Extension · AI Animation · godot-cli install-extension com.IvanMurzak.Godot.MCP.Animation <GodotProject>
Add animation libraries and create animations (length, loop mode) on an AnimationPlayer or AnimationTree, or inside a library.
Covers Add animation library · Create animation · Set length & loop mode
Needs the AI Animation extension installed.
nodes | where name == "Player" | get libraries[""] | call CreateAnimation("Idle", 2, "linear")Add value and 3D position / rotation / scale tracks, and insert value or transform keys (rotation as Euler degrees).
Covers Add value track · Add 3D transform track · Insert key · Insert transform key
Needs the AI Animation extension installed.
nodes | where name == "Player" | get animations["Idle"] | call InsertKey(0, 0.5, 1.5)List the animations and libraries of every player, and each animation’s tracks with their kind, path and key count.
Covers List animations · List libraries · List tracks & key counts
Needs the AI Animation extension installed.
nodes | where $ is AnimationPlayer | select name animations.keys() libraries.keys()Behaviour trees · composites · leaves
Extension · AI Beehave · godot-cli install-extension com.IvanMurzak.Godot.MCP.Beehave <GodotProject>
Create a BeehaveTree and its composites, decorators and leaves with the core AddChild (Beehave classes by name), and set tree properties such as the tick rate through the row’s node.
Covers Create BeehaveTree · Add composite · Add decorator · Add action / condition leaf · Set tick rate
Needs the AI Beehave extension installed.
godot.find("BT") | call AddChild("SelectorComposite", "Sel")The beehave source: whether the addon is installed, every tree in the scene, and every Beehave node with its class, kind, tree and depth.
Covers List behaviour trees · List tree nodes · Check addon installed
Needs the AI Beehave extension installed.
beehave.nodes | where tree == "BT" | select name scriptClass kind depth pathBoolean solids — box/sphere/cylinder/combine
Extension · AI CSG · godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG <GodotProject>
Set validated box / sphere / cylinder / torus dimensions (an invalid value fails instead of clamping) and each shape’s boolean Operation; create the shapes with the core AddChild.
Covers Box size · Sphere radius · Cylinder radius & height · Torus sides · Union / intersection / subtraction
Needs the AI CSG extension installed.
nodes | where name == "Ball" | set Radius = 1.8, Operation = "Subtraction"List every CSG shape with its class, operation and whether it is the root shape that builds the combined mesh.
Covers List CSG shapes · Root shape
Needs the AI CSG extension installed.
nodes | where $ is CSGShape3D | select name class Operation rootShapeCharacters · timelines · text lines
Extension · AI Dialogic · godot-cli install-extension com.IvanMurzak.Godot.MCP.Dialogic <GodotProject>
Create Dialogic timeline (.dtl) and character (.dch) files, a timeline optionally with a first line and its speaker.
Covers Create timeline · Create character
Needs the AI Dialogic extension installed.
dialogic | call CreateTimeline("res://intro.dtl", "Hello", "Narrator")Append text lines (with a speaker) to a timeline, and edit character properties such as the description.
Covers Append text line · Edit character
Needs the AI Dialogic extension installed.
dialogic.timelines | where name == "intro" | call AddText("A second line", "Hero")List the project’s timelines (with their text and event count) and characters (display name, color, description).
Covers List timelines · List characters · Check addon installed
Needs the AI Dialogic extension installed.
dialogic.characters | select path displayName color description3D grid · mesh library · cells
Extension · AI GridMap · godot-cli install-extension com.IvanMurzak.Godot.MCP.GridMap <GodotProject>
Assign the MeshLibrary and set a validated cell size and octant size (an invalid value fails instead of clamping).
Covers Assign MeshLibrary · Cell size · Octant size
Needs the AI GridMap extension installed.
nodes | where name == "Grid" | set MeshLibrary = "res://tiles.tres", CellSize = "(1, 1, 1)"Set a cell to a mesh-library item with an orientation (0 to 23), clear one cell, or clear the whole map.
Covers Set cell · Cell orientation · Clear cell · Clear GridMap
Needs the AI GridMap extension installed.
nodes | where name == "Grid" | call SetCell(2, 0, 1, 0, 10)List a GridMap’s filled cells (position, item, item name, orientation) and its cell count.
Covers List cells · Cell count
Needs the AI GridMap extension installed.
nodes | where name == "Grid" | get cells | select x y z item orientationRegions · agents · links · nav config
Extension · AI Navigation · godot-cli install-extension com.IvanMurzak.Godot.MCP.Navigation <GodotProject>
Set validated agent settings (radius, distances, max speed, avoidance), region and link costs, and link endpoints on the 2D and 3D navigation nodes.
Covers Agent radius & speed · Avoidance · Enter / travel cost · Navigation link
Needs the AI Navigation extension installed.
nodes | where name == "NavAgent" | set Radius = 0.75, MaxSpeed = 8, AvoidanceEnabled = trueBake a region’s NavigationMesh or NavigationPolygon synchronously and get its polygon count; add or clear NavigationPolygon outlines.
Covers Bake navigation mesh · Polygon count · Add / clear outline
Needs the AI Navigation extension installed.
nodes | where name == "NavRegion" | call Bake()List navigation regions, agents and links with their settings and baked polygon counts.
Covers List regions · List agents · Polygon count
Needs the AI Navigation extension installed.
nodes | where $ is NavigationRegion3D | select name Enabled polygonCount NavigationMeshGPU emitters · tune · restart
Extension · AI Particles · godot-cli install-extension com.IvanMurzak.Godot.MCP.Particles <GodotProject>
Set validated Amount, Lifetime, Explosiveness and Randomness on GPUParticles2D / 3D (an out-of-range value fails), plus the process material and emitting state.
Covers Amount · Lifetime · Explosiveness & randomness · Process material · Emitting
Needs the AI Particles extension installed.
nodes | where name == "FX" | set Amount = 32, Lifetime = 2, Explosiveness = 0.5Restart a GPU particle emitter from the beginning.
Covers Restart emitter
Needs the AI Particles extension installed.
nodes | where name == "FX" | call Restart()Virtual cameras · follow · look-at · priority
Extension · AI PhantomCamera · godot-cli install-extension com.IvanMurzak.Godot.MCP.PhantomCamera <GodotProject>
Set a camera’s follow and look-at mode by name and its target, validated against the camera (2D / 3D) and the mode.
Covers Set follow mode & target · Set look-at mode & target
Needs the AI PhantomCamera extension installed.
phantomcamera.cameras | where name == "PCam" | call SetFollow("Simple", "Player")Write camera properties such as priority and damping through the row’s node (undoable); create cameras and hosts with the core AddChild.
Covers Set priority · Follow damping · Create PhantomCamera / host
Needs the AI PhantomCamera extension installed.
phantomcamera.cameras | where name == "PCam" | get node | set props["priority"] = 50The phantomcamera source: every Phantom Camera with its priority, modes and targets, and every host with its Camera3D.
Covers List cameras · List hosts · Check addon installed
Needs the AI PhantomCamera extension installed.
phantomcamera.cameras | select name priority followMode followTarget lookAtMode lookAtTargetTerrain3D nodes · region size · material
Extension · AI Terrain3D · godot-cli install-extension com.IvanMurzak.Godot.MCP.Terrain3D <GodotProject>
Change a terrain’s region size (64, 128, 256, 512, 1024 or 2048; any other size fails and changes nothing).
Covers Change region size
Needs the AI Terrain3D extension installed.
terrain3d | where name == "Terrain" | call ChangeRegionSize(1024)Create a Terrain3DMaterial and write terrain properties (material, data directory, mesh LODs, vertex spacing) through the row’s node.
Covers New Terrain3DMaterial · Data directory · Mesh LODs & vertex spacing
Needs the AI Terrain3D extension installed.
terrain3d | where name == "Terrain" | get node | set props["material"] = terrain3d.newMaterial()The terrain3d sources: every Terrain3D node with its region size, data directory, LODs and region count, and whether the addon is loaded.
Covers List terrains · Region count · Check addon installed
Needs the AI Terrain3D extension installed.
terrain3d | select name regionSize dataDirectory regionCount version2D TileMapLayer · tileset · cells
Extension · AI Tilemap · godot-cli install-extension com.IvanMurzak.Godot.MCP.Tilemap <GodotProject>
Set a cell from a tileset source, atlas coordinates and alternative (validated), erase a cell, or clear the layer; assign the TileSet as a property.
Covers Assign TileSet · Set cell · Erase cell · Clear layer
Needs the AI Tilemap extension installed.
nodes | where name == "Layer" | call SetCell(1, 0, 0, 2, 1)List a TileMapLayer’s used cells (position, source id, atlas coordinates, alternative) and their count.
Covers List used cells · Used cell count
Needs the AI Tilemap extension installed.
nodes | where name == "Layer" | get usedCells | select x y sourceId atlasX atlasY alternative