Bragproof

← Reports

@n24q02m/better-godot-mcp

Starts with no setup1.24.4npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 1 of 1 tool tried
Contacts while installing and starting: nothing

17tools listed
0hosts contacted
0files written
0.2 sto start
100dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y @n24q02m/better-godot-mcp@1.24.4

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

1 tool that takes no input and looks read-only was called once with nothing. 1 returned a result.

helpReturned a result under 0.1 s · 1,167 characters

During the calls it contacted nothing it had not already contacted.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

project action, project_path, scene_path, pid, key, value, preset, output_path
Godot project operations.

Actions (required params -> optional):
- info (-> project_path): project metadata
- version: Godot engine version
- run (-> scene_path, project_path): launch game
- logs (-> pid): last captured stdout/stderr lines from a run (default: most recently started)
- stop: stop running game
- settings_get (key -> project_path): read project setting
- settings_set (key, value -> project_path): write project setting
- export (preset, output_path -> project_path): export game build
scenes action, project_path, scene_path, root_type, root_name, new_path
Scene file (.tscn) CRUD.

Actions (required params -> optional):
- create (scene_path -> root_type="Node2D", root_name, project_path)
- list (-> project_path)
- info (scene_path -> project_path)
- delete (scene_path -> project_path)
- duplicate (scene_path, new_path -> project_path)
- set_main (scene_path -> project_path)

scene_path: relative to project root (e.g., "scenes/main.tscn"), NOT res:// prefix. Use nodes tool to edit nodes within a scene.
nodes action, project_path, scene_path, name, type, parent, new_name, property, value
Scene node operations.

Actions (required params -> optional):
- add (scene_path, name -> type="Node", parent=".", project_path)
- remove (scene_path, name -> project_path)
- rename (scene_path, name, new_name -> project_path)
- list (scene_path -> project_path)
- set_property (scene_path, name, property, value -> project_path)
- get_property (scene_path, name, property -> project_path)

Node paths: relative to scene root using "/" (e.g., "Player/Sprite2D"). Use "." for root.
scripts action, project_path, script_path, extends, content, scene_path, node_name
GDScript file CRUD.

Actions (required params -> optional):
- create (script_path -> extends="Node", content, project_path): generate template
- read (script_path -> project_path)
- write (script_path, content -> project_path): replace entire file
- attach (script_path, scene_path, node_name -> project_path): link to scene node
- list (-> project_path)
- delete (script_path -> project_path)

script_path: relative to project root (e.g., "scripts/player.gd").
editor action, project_path
Godot editor control.

Actions (required params -> optional):
- launch (-> project_path): open editor
- status (-> project_path): check if editor is running

For running the game, use project(action="run") instead.
12 more tools
config action, key, value
Server configuration and environment.

Actions (required params -> optional):
- status: current config
- set (key, value): update setting
- detect_godot: find Godot binary path
- check: verify project and Godot availability
help topic
Full documentation. Omit topic for the overview; use a topic when compressed descriptions are insufficient.
resources action, project_path, resource_path, type
Resource file management.

Actions (required params -> optional):
- list (-> type, project_path): browse resources (type: image|audio|font|shader|scene|resource)
- info (resource_path -> project_path): resource metadata
- delete (resource_path -> project_path)
- import_config (resource_path -> project_path): view import settings
input_map action, project_path, action_name, deadzone, event_type, event_value
Input action management.

Actions (required params -> optional):
- list (-> project_path): all input actions
- add_action (action_name -> deadzone=0.5, project_path)
- remove_action (action_name -> project_path)
- add_event (action_name, event_type, event_value -> project_path)

event_type: key | mouse | joypad. event_value: e.g., KEY_SPACE.
signals action, project_path, scene_path, signal, from, to, method, flags
Signal connection management.

Actions (required params -> optional):
- list (scene_path -> project_path): all signal connections
- connect (scene_path, signal, from, to, method -> flags, project_path)
- disconnect (scene_path, signal, from, to, method -> project_path)
animation action, project_path, scene_path, name, parent, anim_name, duration, loop, track_type, node_path, property
Animation management. Actions: create_player|add_animation|add_track|add_keyframe|list. Use help tool for full docs.
tilemap action, project_path, scene_path, tileset_path, texture_path, tile_size
TileSet and TileMap management. Actions: create_tileset|add_source|set_tile|paint|list. Use help tool for full docs.
shader action, project_path, shader_path, shader_type, content
Godot shader management. Actions: create|read|write|get_params|list. Use help tool for full docs.
physics action, project_path, scene_path, name, collision_layer, collision_mask, dimension, layer_number, gravity_scale, mass
Physics config. Actions: layers|collision_setup|body_config|set_layer_name. Use help tool for full docs.
audio action, project_path, scene_path, bus_name, send_to, effect_type, name, stream_type, parent, bus
Audio bus and stream management. Actions: list_buses|add_bus|add_effect|create_stream. Use help tool for full docs.
navigation action, project_path, scene_path, name, parent, dimension, radius, max_speed
Navigation regions, agents, obstacles. Actions: create_region|add_agent|add_obstacle. Use help tool for full docs.
ui action, project_path, scene_path, name, type, parent, theme_path, preset, font_size
UI Control nodes and themes. Actions: create_control|set_theme|layout|list_controls. Use help tool for full docs.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseApache-2.0
Needsnode >=24.21.0
Sourcegithub.com/n24q02m/better-godot-mcp
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-X8KHOdROGI43WvXUrjik/LzsYpmXh2S3HZamof7BZzKBZyWuZ03OTttjjWhQpZ+1BcZGdSeqnaor+sG1+d3hGw==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/@n24q02m/better-godot-mcp.svg)](https://bragproof.smaverk.com/r/%40n24q02m/better-godot-mcp)

New version out? Ask for a fresh report.