Docs · Tools · Godot

47 capabilities
for Godot, ready for your AI agent.

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.

47
Type
Action
Area

Editor

Query & change nodes, scenes, resources, files

3

Run a read-only RQL query over nodes, scenes, resources, files, classes, project settings and editor state, and get compact rows back.

rql-queryEditor
  • query*string
“List every OmniLight3D in the scene with its energy.”

Change 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.

rql-mutateEditor
  • query*string
  • dry_runbool
“Hide every node whose name starts with Enemy.”

List the RQL sources, functions and node classes in the edited scene; with a type name, its members, methods and Godot properties.

rql-schemaEditor
  • typestring
“What properties does CharacterBody3D have?”

Script

CRUD · attach · build · run C# in the editor

8

Read a .cs or .gd script file.

script-readScript
  • path*string
“Show me the contents of Player.cs.”

Create a new script file.

script-createScript
  • path*string
  • contentsstring
“Create a HealthBar.cs script with a public float Health.”

Update an existing script file's contents.

script-updateScript
  • path*string
  • contents*string
“Add a _Ready method to Player.cs.”

Delete a script file.

script-deleteScript
  • path*string
“Delete the unused Spinner.gd script.”

Attach a script to a node.

script-attach-to-nodeScript
  • node*NodePath
  • script*string
“Attach Player.cs to the Player node.”

Validate GDScript (.gd) files and return structured parse/compile diagnostics. Omit the path to scan every .gd file under res://.

script-validateScript
  • scriptPathstring
“Check all my GDScript files for errors.”

Build the project's C# so new scripts load. The result arrives after Godot reloads the assembly.

script-buildScript
“Build the C# project and show me any compiler errors.”

Compile and run C# in the editor with Roslyn and return the value and printed output.

script-executeScript
  • csharpCode*string
“Run C# that counts the nodes in the current scene.”

Screenshot

Viewport · camera · isolated renders

3

Capture the editor viewport as a PNG.

screenshot-viewportScreenshot
“Take a screenshot of the editor viewport.”

Capture from a specific camera.

screenshot-cameraScreenshot
  • camera*NodePath
“Render the scene from the main camera.”

Render a node in isolation from a chosen angle.

screenshot-isolatedScreenshot
  • node*NodePath
“Render the player model in isolation.”

Console

Read & clear logs in a running game

2

Read the logs collected in a running game, with filtering.

console-get-logsConsole
  • minSeverityenum<Log|Warning|Error>
  • limitint
“Show me the last 20 errors from the running game.”

Clear the log cache of a running game.

console-clear-logsConsole
“Clear the running game log cache.”

Reflection

Find & call C# methods in a running game

2

In a running game, find C# methods, including private, across every loaded assembly.

reflection-method-findReflection
  • query*string
“Find every C# method whose name contains spawn.”

In a running game, call any C# method with input parameters and get the result.

reflection-method-callReflection
  • method*string
  • argsobject[]
“Call MyTools.GenerateLevel with seed 42.”

Runtime Errors

Poll errors from the running game (opt-in)

2

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().

runtime-errors-getRuntime Errors
  • sinceSequencelong
  • maxEntriesint
“Run the game and tell me which runtime errors it raised.”

Clear the captured in-game runtime-error buffer (a no-op when capture is not enabled).

runtime-errors-clearRuntime Errors
“Clear the captured runtime errors before the next play test.”

Ping

Lightweight readiness probe

1

Lightweight readiness probe — echoes a message back, or returns pong. Verifies the end-to-end MCP path.

pingPing
  • messagestring
“Ping the Godot addon to check the connection.”

Animation

AnimationPlayer · libraries · tracks · keys

Extension · AI Animation · godot-cli install-extension com.IvanMurzak.Godot.MCP.Animation <GodotProject>

3

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

Via rql-query / rql-mutate · What is RQL?Animation

Needs the AI Animation extension installed.

nodes | where name == "Player" | get libraries[""] | call CreateAnimation("Idle", 2, "linear")
“Create a 2-second looping Idle animation on the AnimationPlayer.”

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

Via rql-query / rql-mutate · What is RQL?Animation

Needs the AI Animation extension installed.

nodes | where name == "Player" | get animations["Idle"] | call InsertKey(0, 0.5, 1.5)
“Add a track for Mover:position:x and key it to 1.5 at 0.5 seconds.”

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

Via rql-query / rql-mutate · What is RQL?Animation

Needs the AI Animation extension installed.

nodes | where $ is AnimationPlayer | select name animations.keys() libraries.keys()
“List every AnimationPlayer with its animations.”

Beehave

Behaviour trees · composites · leaves

Extension · AI Beehave · godot-cli install-extension com.IvanMurzak.Godot.MCP.Beehave <GodotProject>

2

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

Via rql-query / rql-mutate · What is RQL?Beehave

Needs the AI Beehave extension installed.

godot.find("BT") | call AddChild("SelectorComposite", "Sel")
“Add a Selector composite under the BT behaviour tree.”

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

Via rql-query / rql-mutate · What is RQL?Beehave

Needs the AI Beehave extension installed.

beehave.nodes | where tree == "BT" | select name scriptClass kind depth path
“Show every node of the BT behaviour tree with its class and depth.”

CSG

Boolean solids — box/sphere/cylinder/combine

Extension · AI CSG · godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG <GodotProject>

2

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

Via rql-query / rql-mutate · What is RQL?CSG

Needs the AI CSG extension installed.

nodes | where name == "Ball" | set Radius = 1.8, Operation = "Subtraction"
“Subtract a sphere of radius 1.8 from the box.”

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

Via rql-query / rql-mutate · What is RQL?CSG

Needs the AI CSG extension installed.

nodes | where $ is CSGShape3D | select name class Operation rootShape
“List every CSG shape and its operation.”

Dialogic

Characters · timelines · text lines

Extension · AI Dialogic · godot-cli install-extension com.IvanMurzak.Godot.MCP.Dialogic <GodotProject>

3

Create Dialogic timeline (.dtl) and character (.dch) files, a timeline optionally with a first line and its speaker.

Covers Create timeline · Create character

Via rql-query / rql-mutate · What is RQL?Dialogic

Needs the AI Dialogic extension installed.

dialogic | call CreateTimeline("res://intro.dtl", "Hello", "Narrator")
“Create a timeline res://intro.dtl whose first line is "Halt!".”

Append text lines (with a speaker) to a timeline, and edit character properties such as the description.

Covers Append text line · Edit character

Via rql-query / rql-mutate · What is RQL?Dialogic

Needs the AI Dialogic extension installed.

dialogic.timelines | where name == "intro" | call AddText("A second line", "Hero")
“Append "Who goes there?" by Guard to the intro timeline.”

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

Via rql-query / rql-mutate · What is RQL?Dialogic

Needs the AI Dialogic extension installed.

dialogic.characters | select path displayName color description
“List every Dialogic character.”

GridMap

3D grid · mesh library · cells

Extension · AI GridMap · godot-cli install-extension com.IvanMurzak.Godot.MCP.GridMap <GodotProject>

3

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

Via rql-query / rql-mutate · What is RQL?GridMap

Needs the AI GridMap extension installed.

nodes | where name == "Grid" | set MeshLibrary = "res://tiles.tres", CellSize = "(1, 1, 1)"
“Assign the dungeon mesh library to the GridMap.”

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

Via rql-query / rql-mutate · What is RQL?GridMap

Needs the AI GridMap extension installed.

nodes | where name == "Grid" | call SetCell(2, 0, 1, 0, 10)
“Place item 0 at cell (2, 0, 1), rotated.”

List a GridMap’s filled cells (position, item, item name, orientation) and its cell count.

Covers List cells · Cell count

Via rql-query / rql-mutate · What is RQL?GridMap

Needs the AI GridMap extension installed.

nodes | where name == "Grid" | get cells | select x y z item orientation
“List every filled cell of the GridMap.”

Navigation

Regions · agents · links · nav config

Extension · AI Navigation · godot-cli install-extension com.IvanMurzak.Godot.MCP.Navigation <GodotProject>

3

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

Via rql-query / rql-mutate · What is RQL?Navigation

Needs the AI Navigation extension installed.

nodes | where name == "NavAgent" | set Radius = 0.75, MaxSpeed = 8, AvoidanceEnabled = true
“Give the enemy’s navigation agent radius 0.75 and max speed 8.”

Bake 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

Via rql-query / rql-mutate · What is RQL?Navigation

Needs the AI Navigation extension installed.

nodes | where name == "NavRegion" | call Bake()
“Bake the level’s navigation region.”

List navigation regions, agents and links with their settings and baked polygon counts.

Covers List regions · List agents · Polygon count

Via rql-query / rql-mutate · What is RQL?Navigation

Needs the AI Navigation extension installed.

nodes | where $ is NavigationRegion3D | select name Enabled polygonCount NavigationMesh
“Which navigation regions are baked?”

Particles

GPU emitters · tune · restart

Extension · AI Particles · godot-cli install-extension com.IvanMurzak.Godot.MCP.Particles <GodotProject>

2

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

Via rql-query / rql-mutate · What is RQL?Particles

Needs the AI Particles extension installed.

nodes | where name == "FX" | set Amount = 32, Lifetime = 2, Explosiveness = 0.5
“Give the FX emitter 32 particles with a 2-second lifetime.”

Restart a GPU particle emitter from the beginning.

Covers Restart emitter

Via rql-query / rql-mutate · What is RQL?Particles

Needs the AI Particles extension installed.

nodes | where name == "FX" | call Restart()
“Restart the FX emitter.”

Phantom Camera

Virtual cameras · follow · look-at · priority

Extension · AI PhantomCamera · godot-cli install-extension com.IvanMurzak.Godot.MCP.PhantomCamera <GodotProject>

3

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

Via rql-query / rql-mutate · What is RQL?Phantom Camera

Needs the AI PhantomCamera extension installed.

phantomcamera.cameras | where name == "PCam" | call SetFollow("Simple", "Player")
“Make the camera follow the 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

Via rql-query / rql-mutate · What is RQL?Phantom Camera

Needs the AI PhantomCamera extension installed.

phantomcamera.cameras | where name == "PCam" | get node | set props["priority"] = 50
“Raise the boss camera’s priority to 50 so it takes over.”

The 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

Via rql-query / rql-mutate · What is RQL?Phantom Camera

Needs the AI PhantomCamera extension installed.

phantomcamera.cameras | select name priority followMode followTarget lookAtMode lookAtTarget
“List every Phantom Camera with its follow target.”

Terrain3D

Terrain3D nodes · region size · material

Extension · AI Terrain3D · godot-cli install-extension com.IvanMurzak.Godot.MCP.Terrain3D <GodotProject>

3

Change a terrain’s region size (64, 128, 256, 512, 1024 or 2048; any other size fails and changes nothing).

Covers Change region size

Via rql-query / rql-mutate · What is RQL?Terrain3D

Needs the AI Terrain3D extension installed.

terrain3d | where name == "Terrain" | call ChangeRegionSize(1024)
“Set the terrain’s region size to 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

Via rql-query / rql-mutate · What is RQL?Terrain3D

Needs the AI Terrain3D extension installed.

terrain3d | where name == "Terrain" | get node | set props["material"] = terrain3d.newMaterial()
“Give the terrain a new Terrain3DMaterial.”

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

Via rql-query / rql-mutate · What is RQL?Terrain3D

Needs the AI Terrain3D extension installed.

terrain3d | select name regionSize dataDirectory regionCount version
“How many regions does the terrain have?”

Tilemap

2D TileMapLayer · tileset · cells

Extension · AI Tilemap · godot-cli install-extension com.IvanMurzak.Godot.MCP.Tilemap <GodotProject>

2

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

Via rql-query / rql-mutate · What is RQL?Tilemap

Needs the AI Tilemap extension installed.

nodes | where name == "Layer" | call SetCell(1, 0, 0, 2, 1)
“Paint atlas tile (2, 1) from source 0 at cell (1, 0).”

List a TileMapLayer’s used cells (position, source id, atlas coordinates, alternative) and their count.

Covers List used cells · Used cell count

Via rql-query / rql-mutate · What is RQL?Tilemap

Needs the AI Tilemap extension installed.

nodes | where name == "Layer" | get usedCells | select x y sourceId atlasX atlasY alternative
“List every painted cell in the TileMapLayer.”