Godot Runtime MCP

Launch Godot editor for a specific project

Run the Godot project and capture output

Get the current debug output and errors

Stop the currently running Godot project

List Godot projects in a directory

Retrieve metadata about a Godot project, or just the Godot version if no projectPath is provided

Capture a PNG screenshot of the running Godot project viewport. Requires run_project first.

Simulate input in a running Godot project. Supports batched sequential actions with delays. Requires run_project first.

Types: key, mouse_button, mouse_motion, click_element, action, wait

Get visible Control UI elements from a running project with positions, types, and text. Use before click_element. Requires run_project first.

Execute a custom GDScript in the running Godot project. Script must define: extends RefCounted and func execute(scene_tree: SceneTree) -> Variant. Has full access to the live scene tree. Requires run_project first.

Manage Godot scene files. Operations:

• create: Create new scene (optional: rootNodeType, default Node2D)

• add_node: Add node to scene (required: nodeType, nodeName; optional: parentNodePath, properties)

• load_sprite: Load texture into Sprite2D (required: nodePath, texturePath)

• save: Save scene file (optional: newPath for save-as)

• export_mesh_library: Export as MeshLibrary (required: outputPath; optional: meshItemNames)

Manage UIDs in a Godot 4.4+ project. Operations:

• get: Get UID for a file (required: filePath)

• update: Resave all resources to update UID references

Manage nodes within a Godot scene. Operations:

• delete: Remove a node (required: nodePath)

• update_property: Set a property value (required: nodePath, property, value)

• get_properties: Get all properties of a node (required: nodePath)

• attach_script: Attach/change a script on a node (required: nodePath, scriptPath)

• list: List child nodes (optional: parentPath)

• get_tree: Get full hierarchical tree (optional: parentPath to scope)