Run game
godot_runLaunch a Godot project as a child process with live debugging capabilities including scene tree inspection, expression evaluation, hot reload, and screenshots.
Instructions
Launch the project (or a specific scene) as a child process and return a handle. With live=true the godot_mcp bridge is enabled (auto-installed if needed) so you can inspect the scene tree, eval expressions, hot reload and screenshot the running game.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| live | No | Enable the godot_mcp bridge for live control. | |
| scene | No | A specific scene to run (res:// path). Defaults to the project main scene. | |
| version | No | Godot version to use, e.g. "4.7", "4.7-stable", "stable"/"latest". Defaults to the project's declared version, then the latest stable release. | |
| headless | No | Run with the headless/dummy renderer (no window; screenshots unavailable). | |
| position | No | Window position as X,Y. | |
| extra_args | No | Additional engine arguments. | |
| resolution | No | Window size as WxH, e.g. "1280x720". | |
| project_root | No | Path to the Godot project root (folder containing project.godot). Defaults to $GODOT_PROJECT_ROOT or an upward search from the working directory. | |
| response_format | No | Output format. "markdown" is human-readable; "json" is structured. | markdown |