Bragproof

← Reports

@shin2344234/godot-mcp

Starts with no setup0.1.2npm

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: 2 of 5 tools tried
Contacts while installing and starting: nothing

91tools listed
0hosts contacted
0files written
0.2 sto start
13dependencies

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 @shin2344234/godot-mcp@0.1.2

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

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 2 returned a result.

godot_statusReturned a result under 0.1 s · 234 characters
godot_project_infoNo usable answer tool reported an error: INTERNAL: No project.godot found at /project.godot. Start the server from your Godot project folder, or pass --project <path> (or set GO
godot_files_listReturned a result under 0.1 s · 504 characters
godot_node_findNo usable answer tool reported an error: BAD_PARAMS: The editor is not connected, so pass "scene" (a res:// path to a .tscn) to say which scene file to work on.
godot_anim_readNo usable answer tool reported an error: BAD_PARAMS: The editor is not connected, so pass "scene" (a res:// path to a .tscn) to say which scene file to work on.

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.

1 tool with commands in capitals or very long text
  • Gives the agent orders in godot_status: Godot status: call this first. Shows the project, whether the live editor is connected (open scenes, unsaved changes, playing sta

Common and usually harmless: it is how many makers stress how a tool should be used.

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

godot_status
Godot status: call this first. Shows the project, whether the live editor is connected (open scenes, unsaved changes, playing state), the Godot executable found, and running games.
godot_addon_install
Godot addon: install or update addons/godot_mcp (the editor bridge and game runtime this server needs) from the copy bundled with the server, and enable it in project.godot.
godot_project_info
Godot project facts from project.godot: name, Godot version, main scene, autoloads, input action names, renderer, enabled plugins, C# and test framework detection.
godot_project_settings prefix, limit
Godot project settings: read raw values from project.godot, filtered by key prefix (e.g. "display/window", "input/jump"). Only non-default values are stored in the file.
godot_files_list path, recursive, pattern, all, max
Godot files: list a project folder (res://...). Skips .godot/ and .git/; hides .uid/.import sidecars and, when recursive, addons/ contents unless all. Use recursive with a glob-like "pattern" (e.g. "*.tscn") to find files by type.
86 more tools
godot_files_read path, offset, limit
Godot files: read a text file (script, scene .tscn, resource .tres, shader, config) with line numbers. Use offset/limit for long files.
godot_files_search query, regex, case_sensitive, path, pattern, max_results
Godot files: search text across project files (scripts, scenes, resources, shaders). Literal by default; set regex for a regular expression.
godot_files_write path, content, overwrite
Godot files: create or overwrite a text file (e.g. a .gd script or .gdshader). GDScript files are then checked for parse and type errors (as godot_script_validate). Prefer godot_files_edit for small changes to existing files.
godot_files_edit path, old_text, new_text, replace_all
Godot files: replace an exact snippet in a text file (old_text -> new_text). old_text must match exactly once unless replace_all. GDScript files are then checked for parse and type errors (as godot_script_validate).
godot_files_move from, to
Godot files: move or rename a file or folder, carrying its .uid/.import sidecar files. References by uid:// keep working; plain res:// references in other files are NOT updated.
godot_files_delete path, recursive
Godot files: delete a file (and its .uid/.import sidecars). Deleting a folder requires recursive: true. This cannot be undone.
godot_scene_tree scene, root, depth, max_nodes
Godot scene: show the node tree (names, types, scripts, instanced sub-scenes) of a scene. Use depth/max_nodes to keep large scenes small; start from a subtree with root.
godot_scene_create path, root_type, root_name, open
Godot scene: create a new .tscn file with a root node of the given type (e.g. Node2D, Node3D, Control, CharacterBody2D).
godot_scene_open path
Godot scene: open a scene in the editor so later node operations target it.
godot_scene_save path
Godot scene: save the edited scene in the editor (headless edits are saved automatically).
godot_scene_save_as path
Godot scene: save the edited scene under a new path (editor only).
godot_node_get scene, path, properties
Godot node: read a node's type, script, non-default property values and connected signals. Pass properties to read only some.
godot_node_add scene, parent, type, instance, name, properties, index
Godot node: add a node of a built-in type (e.g. Sprite2D, CollisionShape2D, Label) or an instance of a .tscn scene, with optional initial properties. Undoable in the editor.
godot_node_set scene, path, properties
Godot node: set one or more properties on a node (position, texture, shape, modulate, ...). Returns the values read back. Undoable in the editor.
godot_node_remove scene, path
Godot node: delete a node and its children from the scene. Undoable in the editor; permanent when headless.
godot_node_rename scene, path, name
Godot node: rename a node. Note: scripts or NodePaths that refer to the old name are not updated.
godot_node_reparent scene, path, new_parent, index, keep_global_transform
Godot node: move a node under a different parent (and/or to a child index), keeping its global transform by default.
godot_node_duplicate scene, path, name
Godot node: duplicate a node (with children, script and properties) next to the original.
godot_script_attach scene, path, script
Godot script: attach a .gd (or .cs) script to a node, or detach with script: null. Create the file first with godot_files_write.
godot_script_validate path, source
Godot script: check GDScript for parse/type errors without running the game. Pass a file path, or source text to check before writing.
godot_run_start scene, mode, headless, quit_after_frames, breakpoints, break_on_errors, write_movie
Godot run: start the game (main scene, the current scene, or a given scene). Returns a run_id; read errors and prints with godot_run_output, stop with godot_run_stop.
godot_run_stop run_id
Godot run: stop a running game (the given run_id, the latest process run, or the game playing in the editor).
godot_run_output run_id, since, limit, level, errors
Godot run: read output and errors of a game started with godot_run_start (process or editor mode). Use level "error" to see only errors, and "since" (the "next" value from the last call) to page.
godot_editor_logs since, limit, level
Godot editor: read messages, warnings and errors printed by the editor process (plugin and tool scripts, import errors; not a running game's prints). Repeats are merged with a count. Page with "since".
godot_editor_launch wait_seconds, headless
Godot editor: open this project in the Godot editor and wait until the MCP plugin connects (the plugin must be enabled in the project).
godot_node_instance scene, instance, parent, name, properties, index, editable_children
Godot node: instance a .tscn as a linked sub-scene under a parent, optionally with Editable Children. Undoable in the editor.
godot_node_find scene, name, type, group, script, property, value, root, limit
Godot node: find nodes in a scene by name (glob/substring), type (incl. subclasses), group, script or property value.
godot_node_move scene, path, index
Godot node: move a node to another position among its siblings (draw/process order). Undoable in the editor.
godot_node_groups scene, path, add, remove
Godot node: add or remove a node's groups (saved in the scene). Undoable in the editor.
godot_scene_inherit path, base, root_name, open
Godot scene: create a new scene file that inherits a base scene (like "New Inherited Scene"); opens it in the editor.
godot_scene_close path, save, discard
Godot scene: close a scene tab in the editor. Refuses unsaved changes unless save or discard is true.
godot_batch_apply scene, ops
Godot scene: apply up to 100 scene edits (node.add, node.set, signal.connect, ...) to one scene in order, all-or-nothing; one undo step in the editor.
godot_signal_list scene, path, recursive, include_available
Godot signal: list saved signal connections of a node or scene and flag problems (missing/mismatched handlers, unconnected _on_* methods).
godot_signal_connect scene, from, signal, to, method, create_method, binds, unbinds, flags
Godot signal: connect a node's signal to a method (saved in the scene), optionally creating the handler stub in the target's script.
godot_signal_disconnect scene, from, signal, to, method
Godot signal: remove a saved signal connection from a scene. Undoable in the editor.
godot_resource_read path, properties, depth
Godot resource: read a .tres/.res/.gdshader (or uid://): class, uid, non-default properties, shader uniforms, theme items.
godot_resource_create path, type, properties, code, overwrite
Godot resource: create a resource file of any Resource class (materials, Theme, Gradient, shapes...) or a .gdshader with code.
godot_resource_set path, properties
Godot resource: set properties of an existing resource file and save it (undoable in the editor; open scenes update).
godot_resource_deps path, dependents, limit
Godot resource: list a file's dependencies (missing ones flagged), optionally the files that use it; resolves uid:// paths.
godot_visual_shader_graph path, create, mode, shader_type, ops
Godot visual: edit or create a VisualShader .tres with ordered node ops (add, connect, set...).
godot_visual_shader_graph_read path, shader_type
Godot visual: list a VisualShader's nodes (id, class, properties) and connections per shader type.
godot_visual_layout scene, path, preset, resize_mode, margin, anchors, offsets, size_flags, custom_minimum_size
Godot visual: apply a Control layout preset, anchors/offsets, size flags or minimum size. Undoable.
godot_visual_shader_check path, code
Godot visual: compile shader code or a .gdshader/VisualShader file and report errors with line numbers.
godot_anim_read scene, player, library, animation, max_keys
Godot animation: list an AnimationPlayer's libraries and animations, or with animation the tracks and keys of one. Pass library (a .tres) instead of a scene player to read an AnimationLibrary file.
godot_anim_edit scene, player, animation, allow_missing, ops
Godot animation: create/remove/rename animations and add tracks and keys on an AnimationPlayer. ops run in order as one undo step; track paths are "Node:property" relative to the player's root_node.
godot_anim_tree_read scene, tree, parameters
Godot animation: show an AnimationTree's graph (states, transitions, blend points, blend tree nodes) and its parameters.
godot_anim_tree scene, tree, nested, allow_missing, ops
Godot animation: build an AnimationTree state machine, blend space or blend tree (states, transitions, start/end, blend points). ops run in order as one undo step.
godot_anim_frames scene, node, path, ops
Godot animation: read or edit the SpriteFrames of an AnimatedSprite2D/3D (or a .tres): add/rename/remove animations, speed/loop, frames cut from a sprite sheet. No ops = summary.
godot_grid_read scene, path, region, limit, summary_only
Godot world: read a TileMapLayer/GridMap: cells, bounds and the TileSet tiles/terrains or MeshLibrary items to paint with.
godot_grid_edit scene, path, ops
Godot world: paint a TileMapLayer/GridMap with ordered ops (set, erase, fill_rect, terrain; clear wipes all cells). One undo step.
godot_tileset_edit path, create, tile_size, ops
Godot world: create/edit a TileSet .tres: atlas sources, collision (one-way), navigation, occlusion, terrains, custom data, per-tile values, alternative tiles, animation. Saved at once.
godot_navigation_bake scene, path, outline, agent_radius
Godot world: bake a NavigationRegion2D/3D from its child colliders, meshes, GridMaps and TileMapLayers.
godot_navigation_path scene, from, to, path, optimize, layers
Godot world: shortest path between two points over the scene's baked navigation regions.
godot_audio_buses
Godot audio: list the audio buses (volume, mute, solo, send) and their effects from the project's bus layout.
godot_audio_edit ops
Godot audio: add, remove, rename, move and set buses (volume, mute, solo, send) and their effects; saves the bus layout.
godot_project_set settings, create
Godot project: change project settings (project.godot); null resets one to its default. Values are converted to each setting's type.
godot_input_edit ops
Godot project: edit the input map (actions and their key/mouse/gamepad bindings), applied in order and saved to project.godot.
godot_autoload_edit op, name, path, singleton, index
Godot project: add, remove or reorder autoloads (global singletons loaded at startup).
godot_project_plugins enable, disable, force
Godot project: enable or disable editor plugins (addons) and list the available ones.
godot_project_validate scope, path_prefix, deep, addons, limit, offset
Godot project: health check for missing dependencies, stale or duplicate UIDs, script compile errors, broken autoloads, main scene and plugins.
godot_import_get path, full
Godot import: show an asset's importer, non-default options (full: all), uid and whether its imported files exist (imports new assets first).
godot_import_set path, options, importer
Godot import: change an asset's import options (or importer) and reimport it.
godot_export_presets preset
Godot export: list export presets (platform, path, filters, options; secrets redacted) and whether export templates are installed.
godot_export_preset_set preset, set, create, allow_new_keys, allow_secrets
Godot export: change an export preset's fields/options, or create a preset, in export_presets.cfg.
godot_export_run preset, mode, output, patches, allow_outside_project, timeout_s
Godot export: build the game with an export preset (release, debug, pack-only .pck/.zip, or patch); long-running.
godot_code_diagnostics paths
Godot code: GDScript errors and warnings for .gd files or a folder, from the language server.
godot_code_symbols path, query
Godot code: outline of a .gd file (funcs, signals, vars, consts, classes with lines), or find symbols by name with query.
godot_code_lookup path, line, column, symbol, kind, limit
Godot code: hover docs, definition, references, signature, completion or highlights at a position in a .gd file.
godot_code_rename path, line, column, symbol, new_name, dry_run, include_comments
Godot code: rename a GDScript symbol across the project via the language server (skips comments/strings). dry_run previews.
godot_docs_search query, kind, limit
Godot docs: search the offline class reference (engine + project classes) by class/member name or words.
godot_docs_class name, members, inherited, max_chars
Godot docs: class reference for an engine or project class, or one member ("Class.member"), as markdown.
godot_game_tree run_id, root, depth, max_nodes, name, class, group, text
Godot game: the running game's live nodes as a flat list (path, class, script, rect/pos, visible text). Filters list matches only; text "Start" finds the button to click.
godot_game_get run_id, path, properties, signals, methods
Godot game: current values of a live node: script variables and non-default properties (or listed ones, "prop:sub" ok), groups; optionally signal connections and script methods.
godot_game_edit run_id, ops
Godot game: change the running game with ops in order: set properties, call a method (returns its value, awaits coroutines), spawn, remove, change/reload scene. Stops at the first failing op; earlier ops stay (no undo, nothing saved).
godot_game_eval run_id, code, mode, path, inputs
Godot game: evaluate code in the running game: an Expression with self = node (default; autoloads and singletons by name), or a GDScript body of func run(node, tree, inputs) (use return). Off unless the server runs with --allow-eval.
godot_game_input steps, run_id
Godot game: send input steps in order (keys, actions, clicks on positions or nodes, drags, scroll, typing, joypad, touch, waits). Reports the Control and physics object under each click.
godot_game_time action, frames, physics_ticks, scale, node, signal, condition, seconds, timeout_ms, run_id
Godot game: pause/resume the whole game (Godot's suspend: no node processes; SceneTree.paused untouched), step frames or physics ticks, set speed, or wait for a node, signal, condition, frames or seconds.
godot_game_record action, path, recording, speed, run_id
Godot game: record the game's input events (real and injected) with timestamps, stop to get them as compact JSON (or save to a file), and replay them with the original timing.
godot_game_screenshot run_id, source, node, region, max_size, format, quality, save_to, compare_to, tolerance
Godot game: screenshot the running game (window, a node's viewport, or a region) or the editor's 2D/3D view, scaled down. Can save it and diff against a saved image.
godot_game_perf run_id, sample_seconds, profile_scripts_seconds, top, monitors
Godot game: performance monitors of the running game (fps, frame times, memory, objects, draw calls...); optionally sample frames (stats, spikes) and profile script functions.
godot_debug_state frame, variables, globals, expand, wait, run_id
Godot debug: is the game stopped (breakpoint, error, pause)? Call stack and variables (locals, members, globals) of a frame.
godot_debug_control action, expression, frame, wait, run_id
Godot debug: continue, pause, step_into/over/out (returns the new location and locals), or evaluate an expression in a stopped game (process runs).
godot_debug_breakpoints action, breakpoints, run_id
Godot debug: list, add, remove or clear breakpoints of a game started with godot_run_start (process mode), running or stopped.
godot_test_run path, test, framework, timeout_s
Godot test: run GUT or GdUnit4 tests headlessly (all, a folder, a file or one test name); returns totals and failures with file:line.
godot_editor_ui action, paths, scene, script, line, column, message, severity
Godot editor: get/set the selected nodes, open a script at a line, save all scenes and scripts, or show a toast.
godot_tools action, query, operations
Godot tool catalog: search all available Godot operations by keyword ("search"), or get full parameter schemas for some ("describe").

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

Install facts

LicenseMIT
Needsnode >=22
Sourcegithub.com/shin2344234/godot-mcp
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-/CXZiNVZIKN6F8P+ODMU4LP2/x9m/rZaaBNjBKTnA8sgA6XuRbRuKTdz3v+35/s7LUvtjYlnZ8w8iH3HUcXYpw==

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/@shin2344234/godot-mcp.svg)](https://bragproof.smaverk.com/r/%40shin2344234/godot-mcp)

New version out? Ask for a fresh report.