godot-mcp-pilot

Get the installed Godot engine version and platform information.

Find Godot projects (project.godot files) under a directory.

Get metadata about a Godot project: name, version, scene/script/asset counts.

Open the Godot editor for a project. Non-blocking — returns immediately.

Run a Godot project in debug mode (background). Optionally run a specific scene. Use get_debug_output to retrieve console logs after starting.

Stop the currently running Godot project.

Get console output (stdout/stderr) from the running or last run project.

Run a GDScript snippet headlessly inside a project and return the output. The script body is wrapped in a SceneTree subclass automatically — just write the statements to execute (e.g. print("hello")). Great for quick tests and calculations that need Godot's built-in types.

List all .tscn scene files in a project.

Read a scene file — returns raw .tscn text and a structured node list.

Create a new .tscn scene file with a specified root node type.

Save a scene (re-writes it to disk, optionally to a new path).

Add a new node to an existing scene.

Modify properties of an existing node in a scene.

Remove a node (and all its children) from a scene.

Duplicate a node (and its children) within the same scene, giving it a new name. The duplicate is placed under the same parent as the original.

Move (re-parent) a node to a different parent within the same scene. All descendant parent paths are updated automatically.

Attach a GDScript to a node in a scene, or detach the current script. Automatically adds the ext_resource entry to the .tscn file.

Instantiate a packed scene (sub-scene) as a child node inside another scene. Adds the ext_resource entry automatically.

Load a texture resource into a Sprite2D (or TextureRect) node.

List all GDScript (.gd) files in a project.

Read the source code of a GDScript file.

Overwrite a GDScript file with new content.

Create a new GDScript file. Use the template param to pick a starter template: 'CharacterBody2D', 'CharacterBody3D', 'Singleton', or provide custom content.

Perform basic static analysis on a GDScript file — finds common errors and Godot 4 migration issues.

Parse a GDScript file and return all functions, signals, and top-level variables with their names, parameters, return types, and line numbers.

Append a new function to a GDScript file. Fails if the function already exists.

Remove a function and its entire body from a GDScript file.

Add a signal declaration to a GDScript file. Inserted after existing signals.

Add a top-level variable or property declaration to a GDScript file.

Get the Godot 4 unique ID (uid://) for a resource file.

Re-import all project assets to refresh Godot 4 UIDs. Runs Godot headlessly. Use after adding or moving resource files.

List all asset files in a project (textures, audio, meshes, fonts, shaders, etc.). Optionally filter by type.

Get detailed metadata about a specific asset: type, size, UID, and import settings.

Read the project.godot configuration. Optionally filter to a specific section (e.g. "application", "display", "input", "autoload", "rendering").

Write a setting to project.godot. The value must be a valid Godot config value string. For strings, wrap in double quotes: e.g. value='"res://scene.tscn"'. For booleans/numbers use: 'true', '42'. Creates the section if it doesn't exist.

Get the project's configured main (startup) scene path.

Set the project's main (startup) scene.

List all autoload (singleton) entries configured in the project.

Add or update an autoload (singleton) in the project settings. The script will be instantiated automatically when the project starts.

Remove an autoload singleton from the project settings.

List all custom input actions defined in the project (Project > Project Settings > Input Map).

Add a new input action to the project's Input Map (with no events bound). Use the Godot editor or set_project_setting to bind keys to it.

Remove an input action from the project's Input Map.