Godot MCP

Tools 60 of 71

26 only read, 32 change things, 2 can delete or overwrite. A ? marks an optional parameter.

get_godot_status

Reports whether the editor plugin is connected and which versions run

get_guide

Lists the built-in markdown guides or returns one by slugslug?: string

list_dir

Lists files and folders under a project pathpath?: stringinclude_hidden?: boolean

read_file

Reads a project text file, optionally a line rangepath: stringstart_line?: numberend_line?: numbermax_bytes?: number

search_project

Finds text across project files with line numbersquery: stringglob?: stringmax_results?: numbercase_sensitive?: boolean

create_script changes

Creates a new GDScript file with the given codepath: stringcontent: string

edit_script changes

Replaces one snippet of text in an existing scriptpath: stringold_text: stringnew_text: stringcontext_before?: stringcontext_after?: string

validate_script

Checks a GDScript file for parse errorspath: string

write_file changes

Writes a text file, replacing an existing one only with overwrite=truepath: stringcontent: stringoverwrite?: booleancreate_dirs?: booleanforce?: boolean

rename_file changes

Renames or moves a file and updates references to itold_path: stringnew_path: stringupdate_references?: boolean

delete_file deletes

Deletes a file when confirm=true is passed. A .bak copy is made by defaultpath: stringconfirm: booleancreate_backup?: booleanforce?: boolean

create_folder changes

Creates a folder in the projectpath: string

delete_folder deletes

Deletes a folder once confirm=true is passed, non-empty ones only with recursive=truepath: stringconfirm: booleanrecursive?: booleanforce?: booleanforce_orphan?: booleanallow_no_undo?: boolean

list_scripts

Lists the GDScript files in the project

create_scene changes

Creates a .tscn scene with a whole node tree in one callscene_path: stringroot_node_name?: stringroot_node_type: stringnodes?: arrayattach_script?: string

read_scene

Returns the node tree of a scene filescene_path: stringinclude_properties?: boolean

get_scene_node_properties

Returns every property of one node in a scene filescene_path: stringnode_path?: string

add_node changes

Adds a node, with optional properties, script and children, to a scenescene_path: stringnode_name: stringnode_type: stringparent_path?: stringproperties?: objectscript?: stringgroups?: arraychildren?: array

remove_node changes

Removes a node from a scenescene_path: stringnode_path: string

rename_node changes

Renames a node in a scenescene_path: stringnode_path: stringnew_name: string

move_node changes

Moves a node under another parent or to another indexscene_path: stringnode_path: stringnew_parent_path: stringsibling_index?: number

set_node_properties changes

Sets one or more properties on a node, including textures, shapes and materialsscene_path: stringnode_path?: stringproperties: object

attach_script changes

Attaches a script to a nodescene_path: stringnode_path?: stringscript_path: string

detach_script changes

Removes the script from a nodescene_path: stringnode_path: string

instance_scene changes

Adds another scene as a child instancescene_path: stringinstance_path: stringnode_name?: stringparent_path?: stringproperties?: object

get_node_spatial_info

Returns positions, rotation, scale and bounds of a Node3Dscene_path: stringnode_path?: stringinclude_bounds?: boolean

snap_node_to_grid changes

Snaps a Node3D position to a gridscene_path: stringnode_path?: stringgrid_size: numberaxes?: arrayspace?: string

find_nodes

Searches a scene for nodes by name pattern, type or groupscene_path?: stringname_pattern?: stringtype?: stringin_group?: stringrecursive?: boolean

set_node_groups changes

Sets, adds or removes the groups a node belongs toscene_path: stringnode_path?: stringgroups: arraymode?: enum

get_resource_info

Inspects a resource on disk or one held by a nodepath?: stringscene_path?: stringnode_path?: stringresource_property?: string

save_resource_to_file changes

Saves a node resource to its own .tres file and points the node at itscene_path: stringnode_path?: stringresource_path: stringsave_to: string

list_signal_connections

Lists signal connections of a node in the scene file or the running gamesource?: enumscene_path?: stringnode_path: stringinclude_outgoing?: booleaninclude_incoming?: boolean

connect_signal changes

Connects a node signal to a method in a scene filescene_path: stringfrom_node_path: stringsignal: stringto_node_path: stringmethod: stringflags?: number

disconnect_signal changes

Removes a signal connection from a scene filescene_path: stringfrom_node_path: stringsignal: stringto_node_path: stringmethod: string

call_method changes

Calls a method on a node in a scene or in the running gamenode_path: stringmethod: stringargs?: arrayscene_path?: stringruntime?: booleanexpect_return?: booleanconfirm?: boolean

get_project_settings

Summarises main scene, window, physics and render settingsinclude_render?: booleaninclude_physics?: boolean

list_settings

Lists project settings in a categorycategory?: string

update_project_settings changes

Changes one or more project settingssettings: object

get_input_map

Returns the input actions and their bindingsinclude_deadzones?: boolean

configure_input_map changes

Adds, removes or changes an input action and its eventsaction: stringoperation: stringdeadzone?: numberevents?: array

get_node_properties

Lists the properties a Godot node type hasnode_type: string

classdb_query

Looks up a class in the engine ClassDBclass_name: stringquery?: stringinclude_virtual?: boolean

setup_autoload changes

Registers, removes or lists autoload singletonsname?: stringoperation: stringpath?: string

get_console_log

Returns recent lines from the editor Output panelmax_lines?: numberdebug?: boolean

get_errors

Returns errors and warnings from the editormax_errors?: numberinclude_warnings?: booleanwait_ms?: number

scene_tree_dump

Prints the live tree of the scene open in the editor, unsaved edits includedsubtree_root?: stringmax_depth?: numberoffset?: numberlimit?: number

get_editor_selection

Returns the nodes selected in the editor

rescan_filesystem changes

Makes the editor rescan the project files

run_scene changes

Starts a scene, or the main scene, in play modescene_path?: stringblock_until_started?: booleanwait_for_runtime?: booleanstartup_timeout_ms?: numberclear_output?: boolean

stop_scene changes

Stops the running game

take_screenshot changes

Saves the running game viewport as a PNGsave_to?: stringreturn_base64?: boolean

send_input changes

Sends a key, mouse or action event to the running gameevent: object

query_runtime_node

Reads the live state of a node in the running gamenode_path: stringproperties?: arrayinclude_children?: booleaninclude_groups?: boolean

get_performance_monitors

Returns performance counters from the running game

get_runtime_log

Returns lines the game pushed to the in-game MCPRuntime loglimit?: numbersince_ms?: number

generate_2d_asset changes

Renders SVG code to a PNG file in the projectsvg_code: stringfilename: stringsave_path?: stringwidth?: numberheight?: numberscale?: number

map_project

Opens a browser map of scripts and scenes on localhost:6510path?: stringinclude_addons?: boolean

mcp_undo changes

Reverts the last changes made through the servercount?: numberpreview?: boolean

mcp_redo changes

Reapplies changes that mcp_undo revertedcount?: numberpreview?: boolean

batch_execute changes

Runs a list of tool calls as one change, rolled back on failure by defaultcommands: arrayatomic?: booleanstop_on_error?: boolean

Resources 7

godot-mcp://guide/testing-loop

Guide to testing a running game

godot-mcp://guide/scene-editing

Guide to editing scenes and property values

godot-mcp://guide/asset-generation

Guide to generating 2D assets

godot-mcp://guide/troubleshooting

Guide to common failures

godot-mcp://guide/batching

Guide to batching changes with batch_execute

godot-mcp://guide/selection-workflow

Guide to working with the editor selection

godot-mcp://guide/tool-index

Index of tools by goal