@yanhuifair/godot-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Contacts while installing and starting: nothing
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 @yanhuifair/godot-mcp@1.12.18
Installing a package runs its code. Use a sandbox for anything you have not read.
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
add_animation_library scene_path, animation_name, animations
Add animation library to player.
add_animation_track scene_path, animation_name, track_type, track_path, interp
Add track to animation.
add_audio_bus layout_path, bus_name, send_to, volume_db
Add audio bus to layout.
add_autoload name, path
Add an autoload entry.
add_bus_effect layout_path, bus_index, bus_name, effect_type, effect_params
Add effect to audio bus.
195 more tools
add_input_binding action, key, mouse_button, joypad_button, joypad_axis, device
Add key/mouse/joypad binding to action.
add_node scene_path, parent_path, name, type, properties, groups
Add a node to a scene.
add_script_export path, var_name, var_type, default_value, export_hint
Add @export variable to GDScript.
add_script_function path, func_name, params, return_type, body, after_func
Append a function to GDScript.
add_script_signal path, signal_name, params
Add a signal declaration to GDScript.
add_shader_graph_node path, node_type, position, params, shader_stage
Add a node to a VisualShader graph. 40+ node types available (constants, math, textures, effects).
add_theme_type theme_path, type, font_size, font_color
Add a control type (font size/color) to a Theme.
add_tileset_source tileset_path, texture_path, source_id, tile_size, margin, separation
Add an atlas source (texture) to a TileSet.
add_translation_key path, key, translations
Append a translation key/row to an existing CSV.
attach_script scene_path, node_path, script_path
Attach a script to a node.
capture_screenshot output_path, window_title, delay
Capture screenshot of running game.
clear_game_logs include_current
Delete rotated Godot log backups (optionally the current log too).
clone_node scene_path, clone_source, name, parent_path
Deep-clone a node in a scene.
compile_shader path
Compile (reimport) a .gdshader via Godot editor or local validation.
configure_file_logging enabled, log_path, max_log_files
Enable/disable engine file logging and set log_path / max_log_files in project.godot.
connect_shader_graph_nodes path, from_node, from_port, to_node, to_port, shader_stage
Connect two node ports in a VisualShader graph.
connect_signal scene_path, signal, from_node, to_node, method_name, flags, unbinds
Connect a signal between nodes.
create_animation path, length, loop_mode
Create Animation .tres resource.
create_atlas_texture path, atlas_texture, region
Create AtlasTexture .tres.
create_audio_bus_layout path, master_volume
Create AudioBusLayout.
create_camera_attributes path, preset
Create CameraAttributes (Practical or Physical) for 3D camera DOF and auto-exposure.
create_collision_polygon scene_path, parent_path, name, points
Create CollisionPolygon2D.
create_curve path, points, bake_resolution
Create Curve .tres.
create_directory path
Create a directory in project.
create_environment path, preset
Create Environment from preset.
create_export_preset name, platform, export_path, runnable, export_filter, include_filter, exclude_filter, custom_features, dedicated_server, options
Create an export preset in export_presets.cfg (Windows Desktop/Linux/macOS/Android/iOS/Web).
create_gdextension path, entry_symbol, library_path
Create a .gdextension config file.
create_gradient path, colors, interpolation_mode
Create Gradient .tres.
create_grid_map scene_path, name, parent
Create a GridMap node for 3D tile-based level design.
create_image_texture path, source
Create an ImageTexture .tres pointing at an image file.
create_joint scene_path, joint_type, parent_path, name, node_a, node_b
Create a physics joint.
create_mesh_primitive path, mesh_type, params
Create 3D mesh resource: Box, Capsule, Cylinder, Plane, Sphere, Torus, etc. (11 types).
create_multimesh path, instance_count, mesh_path, transform_mode
Create a MultiMesh .tres resource.
create_nav_link scene_path, link_type, parent_path, name, start, end
Create a NavigationLink3D between two points.
create_nav_mesh path, agent_radius, agent_height, cell_size, cell_height
Create NavigationMesh .tres.
create_noise_texture path, width, height, seamless, noise_type
Create NoiseTexture2D.
create_physics_material path, friction, bounce, absorb, rough
Create PhysicsMaterial.
create_po_translation path, language, entries, register
Create a Gettext .po translation file (optionally registering it).
create_resource path, type, properties
Create a resource from template.
create_scene path, template, root_type, root_name
Create a new scene from template.
create_script path, type, template, class_name
Create a new script from template.
create_shader path, type
Create a new .gdshader from template.
create_shader_include path
Create a .gdshaderinc file.
create_sky path, material
Create a Sky .tres with a procedural or panorama sky material.
create_spring_arm scene_path, name, parent, length
Create a SpringArm3D for smooth camera follow.
create_sprite_frames path, animations
Create a SpriteFrames .tres resource with named animations.
create_theme path, default_font_size
Create a Theme .tres resource.
create_tileset path, tile_size
Create a TileSet .tres resource.
create_translation path, language, keys
Create translation CSV.
create_vehicle_body scene_path, name, parent, wheels
Create a VehicleBody3D with VehicleWheel nodes for car physics.
create_visual_shader path, shader_type
Create a new VisualShader .tres graph file.
create_world path, environment_path
Create World3D .tres.
create_world_environment path, environment_path
Create a .tscn with a WorldEnvironment node referencing an Environment.
delete_file path
Delete a file with .bak backup.
diff_animation path_a, path_b
Compare two Animation .tres files.
diff_project_config path_a, path_b
Compare two config files (project.godot, .cfg, .import) ignoring whitespace and comments.
diff_resource path_a, path_b, context_lines
Compare two resource files.
diff_scene path_a, path_b, ignore_whitespace
Compare two scene files.
diff_script path_a, path_b
Compare two GDScript files line-by-line.
disconnect_shader_graph_nodes path, from_node, from_port, to_node, to_port, shader_stage
Disconnect two node ports in a VisualShader graph.
disconnect_signal scene_path, signal, from_node, to_node, method_name
Disconnect a signal.
duplicate_resource source, destination
Duplicate a .tres resource.
duplicate_scene source, destination
Duplicate a scene file.
edit_scene path, operations
Apply batch operations to a scene.
editor_add_autoload name, path
Add an autoload singleton via editor API.
editor_add_input_action name, deadzone
Add an input action via editor API.
editor_add_node type, name, parent, properties
Add a node to the currently open scene in editor.
editor_attach_script path, script
Attach a script to a node in the editor.
editor_bake_lightmaps
Trigger lightmap baking.
editor_bake_navigation
Bake navigation meshes for all NavigationRegion nodes in current scene.
editor_clear_errors
Clear the bridge error-capture buffer (always empty). Does not clear the editor console, which the plugin cannot read.
editor_close_scene
Close the currently open scene in the editor (Godot 4.6+).
editor_connect_signal node, signal, target, method
Connect a signal between nodes in the editor.
editor_copy
Copy selected nodes to the editor clipboard.
editor_create_camera name, parent, properties
Create a Camera3D node in the open scene.
editor_create_csg_box name, parent, properties
Create a CSGBox3D node in the open scene.
editor_create_csg_cylinder name, parent, properties
Create a CSGCylinder3D node in the open scene.
editor_create_csg_merge name, parent, properties
Create a CSGCombiner3D node in the open scene.
editor_create_csg_polygon name, parent, properties
Create a CSGPolygon3D node in the open scene.
editor_create_csg_sphere name, parent, properties
Create a CSGSphere3D node in the open scene.
editor_create_folder path
Create a directory in the project via editor filesystem.
editor_create_gpu_particles name, parent, properties
Create a GPUParticles3D node in the open scene.
editor_create_mesh_instance name, parent, properties
Create a MeshInstance3D node in the open scene.
editor_create_multiplayer_spawner name, parent, properties
Create a MultiplayerSpawner3D node in the open scene.
editor_create_multiplayer_synchronizer name, parent, properties
Create a MultiplayerSynchronizer3D node in the open scene.
editor_create_scene path, root_type, root_name
Create and open a new scene in the editor.
editor_create_script path, extends, template
Create and open a new GDScript in the editor.
editor_cut
Cut selected nodes to the editor clipboard (with undo).
editor_debug_break
Stop execution (break) in debugger.
editor_debug_continue
Resume execution in debugger.
editor_debug_step
Step into next line in debugger.
editor_debug_step_over
Step over current line in debugger.
editor_delete_asset path
Delete a file or folder via editor.
editor_delete_selected
Delete currently selected nodes.
editor_disable_plugin plugin
Disable a named editor plugin.
editor_disconnect_signal node, signal, target, method
Disconnect a signal between nodes.
editor_duplicate_asset from, to
Duplicate a file via editor filesystem.
editor_duplicate_node path, name
Duplicate a node with children, scripts, and signals.
editor_enable_plugin plugin
Enable a named editor plugin.
editor_evaluate_expression expression
Evaluate a GDScript expression in debugger/editor context.
editor_focus
Bring the Godot editor window to the foreground.
editor_get_3d_snap
Return 3D editor snap settings (grid step, rotation step, snap enabled).
editor_get_autoloads
List autoload singletons via editor API.
editor_get_breakpoints
List all breakpoints.
editor_get_camera
Get the 3D editor viewport camera position.
editor_get_class_doc class
Open Godot documentation for a class in browser.
editor_get_class_list filter, extends
List all Godot classes, optionally filtered.
editor_get_class_properties class
List all editor-visible properties of a class.
editor_get_class_signals class
List all signals of a Godot class.
editor_get_debug_variables
Get local variables from debugger.
editor_get_dependencies path
Get all resource dependencies for a file.
editor_get_editor_setting key
Read an editor preference value.
editor_get_errors
Read the bridge error-capture buffer. NOTE: the editor console is NOT intercepted, so an empty result does not mean 'no errors' — use validate_script / read_game_log / monitor_output instead.
editor_get_filesystem_selection
Return the editor filesystem dock selection (directory, current path, selected paths).
editor_get_info
Get editor status info.
editor_get_input_map
Read the Input Map via editor API.
editor_get_method_list class
List all methods of a Godot class.
editor_get_node_properties path
Read all editor-visible properties of a node.
editor_get_open_scene
Get currently open scene path.
editor_get_open_scenes
List all scenes currently open in the editor.
editor_get_paths
Return editor data/config/cache/project-settings directory paths.
editor_get_performance
Get FPS, draw calls, memory usage while game is running.
editor_get_playing_scene
Return the path of the scene currently being played, if any.
editor_get_plugin_list
List all installed editor plugins with enabled state.
editor_get_project_directory
Get project res:// and user:// paths.
editor_get_project_setting key
Read a project setting via editor API.
editor_get_recent_scenes
List recently opened scene paths.
editor_get_rect
Get editor window dimensions.
editor_get_running_scene_tree
Get the live scene tree while the game is running.
editor_get_scene_changes
Check if current scene has unsaved changes.
editor_get_selection
Get selected nodes in editor.
editor_get_stack_trace
Get current call stack from debugger.
editor_get_unsaved_scenes
List scenes that have unsaved changes.
editor_health_check
Check if the Godot editor plugin is reachable.
editor_instantiate_scene scene, parent, name
Instantiate a PackedScene into the current scene.
editor_is_playing
Return whether the editor is currently playing a scene and which scene.
editor_list_filesystem path, recursive, pattern
List files and directories in the editor filesystem.
editor_list_node_signals node
List signals and their connections on a node.
editor_mark_scene_unsaved
Mark the current scene as having unsaved changes.
editor_move_asset from, to
Move a file to a new location via editor.
editor_move_node node_path, position
Move a 2D/3D node to a new position.
editor_open_asset path
Open an asset in editor.
editor_open_dock dock
Open a dock: filesystem, inspector, scene, output.
editor_open_script_at_line path, line, column, grab_focus
Open a script in the editor and jump to a given line/column.
editor_paste parent
Paste clipboard nodes into the scene (at selected node or root).
editor_pause
Pause the editor scene tree (note: only affects the editor tree, not a separately running game).
editor_play
Play project from editor.
editor_play_current_scene
Play the currently edited scene from the editor.
editor_read_current_scene
Read live editor scene tree.
editor_redo
Redo last undone action.
editor_reimport_asset path
Force reimport of an asset.
editor_reload_scene
Save and reload current scene.
editor_remove_autoload name
Remove an autoload singleton via editor API.
editor_remove_breakpoint script, line
Remove a breakpoint from a script.
editor_remove_input_action name
Remove an input action via editor API.
editor_remove_node path
Remove a node from the currently open scene.
editor_rename_asset from, to
Rename a file via editor filesystem.
editor_rename_node path, name
Rename a node in the editor.
editor_reparent_node path, new_parent
Move a node to a new parent.
editor_restart confirm, save
Restart the editor (requires confirm=true; optional save). Destructive.
editor_run_gdscript code
Execute arbitrary GDScript code in editor context.
editor_run_specific_scene scene
Run a specific scene (not just main).
editor_save
Save current scene in editor.
editor_save_all
Save all open scenes.
editor_save_scene_as path, with_preview
Save the current scene under a new res:// path (optionally with preview).
editor_search_help query
Search Godot documentation in browser.
editor_select_node node_path, property, value
Select a node in the edited scene (optionally set a property on it).
editor_set_animated_sprite_param node_path, param, value
Set a property on an AnimatedSprite node in the open scene.
editor_set_area_param node_path, param, value
Set a property on an Area2D/3D node in the open scene.
editor_set_audio_listener_param node_path, param, value
Set a property on an AudioListener node in the open scene.
editor_set_audio_player_param node_path, param, value
Set a property on an AudioStreamPlayer node in the open scene.
editor_set_breakpoint script, line
Set a breakpoint in a script.
editor_set_camera position
Set the 3D editor viewport camera position.
editor_set_camera_param node_path, param, value
Set a property on a Camera node in the open scene.
editor_set_character_body_param node_path, param, value
Set a property on a CharacterBody node in the open scene.
editor_set_container_param node_path, param, value
Set a property on a Container node in the open scene.
editor_set_decal_param node_path, param, value
Set a property on a Decal node in the open scene.
editor_set_distraction_free enabled
Enable or disable distraction-free mode (pass enabled to set, omit to read).
editor_set_editor_setting key, value
Set an editor preference.
editor_set_main_scene scene
Set the project main scene.
editor_set_marker_param node_path, param, value
Set a property on a Marker node in the open scene.
editor_set_movie_maker enabled
Enable or disable the movie maker mode (pass enabled to set, omit to read).
editor_set_multiplayer_spawner_param node_path, param, value
Set a property on a MultiplayerSpawner3D node in the open scene.
editor_set_multiplayer_synchronizer_param node_path, param, value
Set a property on a MultiplayerSynchronizer3D node in the open scene.
editor_set_node_properties path, properties
Set multiple properties on a node at once.
editor_set_occluder_param node_path, param, value
Set a property on an Occluder node in the open scene.
editor_set_parallax_param node_path, param, value
Set a property on a ParallaxBackground node in the open scene.
editor_set_particles_param node_path, param, value
Set a property on a particle system node in the open scene.
editor_set_project_setting key, value
Set a project setting via editor API (auto-saves).
editor_set_rich_text_param node_path, param, value
Set a property on a RichTextLabel node in the open scene.
editor_set_selection node_path, property, value
Select node in editor.
editor_set_soft_body_param node_path, param, value
Set a property on a SoftBody3D node in the open scene.
editor_set_tab_container_param node_path, param, value
Set a property on a TabContainer/TabBar node in the open scene.
editor_set_video_player_param node_path, param, value
Set a property on a VideoStreamPlayer node in the open scene.
editor_set_viewport_param node_path, param, value
Set a property on a Viewport node in the open scene.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | AGPL-3.0-or-later |
|---|---|
| Needs | node >=20.0.0 |
| Source | github.com/yanhuifair/Godot-MCP |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-k5EyAya8zbjrWX1/YW7AKLAKQQYrHhfBPmuO866N5bNrl7dVxR90vYqJCl6vyaaiVlk1M89lQq5PUI7ZIt2AkA== |
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.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40yanhuifair/godot-mcp)
New version out? Ask for a fresh report.