Godot MCP
This is a comprehensive bridge between Claude and the Godot 4.x engine, exposing 149 tools for manipulating games at runtime and editing project files headless. You get runtime code execution via game_eval with await support, full node inspection and property manipulation by path, signal connection management, and animation control. It extends beyond the original 20-tool godot-mcp with physics raycasting, shader parameters, multiplayer networking via ENet, procedural mesh generation, and HTTP/WebSocket clients. The headless operations let you parse and modify .tscn files, manage autoloads and input maps, and trigger exports without opening the editor. Reach for this when you want Claude to prototype game mechanics, debug running scenes, or generate entire Godot projects from natural language descriptions.
- GitHub stars
- 259
- tools
- 80
- transport
- STDIO
- last updated
- Mar 7, 2026
Tools
80 toolsPublic tool metadata for what this MCP can expose to an agent.
rename_fileRename or move a file within the project
Rename or move a file within the project
No parameter schema in public metadata yet.
manage_resourceRead or modify .tres/.res resource files
Read or modify .tres/.res resource files
No parameter schema in public metadata yet.
create_scriptCreate a GDScript file from a template
Create a GDScript file from a template
No parameter schema in public metadata yet.
validate_scriptCheck a GDScript file for syntax/type errors headlessly (no run needed)
Check a GDScript file for syntax/type errors headlessly (no run needed)
No parameter schema in public metadata yet.
validate_scriptsBatch-check GDScript files: git-changed ones by default, or all
Batch-check GDScript files: git-changed ones by default, or all
No parameter schema in public metadata yet.
manage_scene_signalsList/add/remove signal connections in .tscn files
List/add/remove signal connections in .tscn files
No parameter schema in public metadata yet.
manage_layersList/set named layer definitions in project
List/set named layer definitions in project
No parameter schema in public metadata yet.
manage_pluginsList/enable/disable editor plugins
List/enable/disable editor plugins
No parameter schema in public metadata yet.
manage_shaderCreate or read .gdshader files
Create or read .gdshader files
No parameter schema in public metadata yet.
manage_theme_resourceCreate/read/modify Theme .tres resources
Create/read/modify Theme .tres resources
No parameter schema in public metadata yet.
set_main_sceneSet the main scene in project.godot
Set the main scene in project.godot
No parameter schema in public metadata yet.
manage_scene_structureRename/duplicate/move nodes within .tscn scenes
Rename/duplicate/move nodes within .tscn scenes
No parameter schema in public metadata yet.
manage_translationsList/add/remove translation files in project
List/add/remove translation files in project
No parameter schema in public metadata yet.
game_localeSet/get locale and translate strings at runtime
Set/get locale and translate strings at runtime
No parameter schema in public metadata yet.
launch_editorLaunch Godot editor for a project
Launch Godot editor for a project
No parameter schema in public metadata yet.
run_projectRun a Godot project and capture output
Run a Godot project and capture output
No parameter schema in public metadata yet.
stop_projectStop the running project
Stop the running project
No parameter schema in public metadata yet.
get_debug_outputGet console output and errors
Get console output and errors
No parameter schema in public metadata yet.
get_godot_versionGet installed Godot version
Get installed Godot version
No parameter schema in public metadata yet.
list_projectsFind Godot projects in a directory
Find Godot projects in a directory
No parameter schema in public metadata yet.
get_project_infoGet project metadata
Get project metadata
No parameter schema in public metadata yet.
create_sceneCreate a new scene with a root node type
Create a new scene with a root node type
No parameter schema in public metadata yet.
add_nodeAdd a node to an existing scene
Add a node to an existing scene
No parameter schema in public metadata yet.
load_spriteLoad a texture into a Sprite2D node
Load a texture into a Sprite2D node
No parameter schema in public metadata yet.
export_mesh_libraryExport a scene as MeshLibrary
Export a scene as MeshLibrary
No parameter schema in public metadata yet.
save_sceneSave a scene (with optional variant path)
Save a scene (with optional variant path)
No parameter schema in public metadata yet.
get_uidGet UID for a file (Godot 4.4+)
Get UID for a file (Godot 4.4+)
No parameter schema in public metadata yet.
update_project_uidsResave resources to update UIDs
Resave resources to update UIDs
No parameter schema in public metadata yet.
read_sceneRead full scene tree as JSON
Read full scene tree as JSON
No parameter schema in public metadata yet.
modify_scene_nodeModify node properties in a scene file
Modify node properties in a scene file
No parameter schema in public metadata yet.
remove_scene_nodeRemove a node from a scene file
Remove a node from a scene file
No parameter schema in public metadata yet.
attach_scriptAttach a GDScript to a scene node
Attach a GDScript to a scene node
No parameter schema in public metadata yet.
create_resourceCreate a .tres resource file
Create a .tres resource file
No parameter schema in public metadata yet.
read_project_settingsParse project.godot as JSON
Parse project.godot as JSON
No parameter schema in public metadata yet.
modify_project_settingsChange a project setting
Change a project setting
No parameter schema in public metadata yet.
list_project_filesList/filter project files
List/filter project files
No parameter schema in public metadata yet.
game_screenshotCapture a screenshot (base64 PNG)
Capture a screenshot (base64 PNG)
No parameter schema in public metadata yet.
game_clickClick at a position
Click at a position
No parameter schema in public metadata yet.
game_key_pressSend key press or input action
Send key press or input action
No parameter schema in public metadata yet.
game_mouse_moveMove the mouse
Move the mouse
No parameter schema in public metadata yet.
game_get_uiGet all visible UI elements
Get all visible UI elements
No parameter schema in public metadata yet.
game_get_scene_treeGet full scene tree structure
Get full scene tree structure
No parameter schema in public metadata yet.
game_get_node_infoDetailed node introspection
Detailed node introspection
No parameter schema in public metadata yet.
game_evalExecute arbitrary GDScript with return values
Execute arbitrary GDScript with return values
No parameter schema in public metadata yet.
game_get_propertyGet any node property
Get any node property
No parameter schema in public metadata yet.
game_set_propertySet any node property (auto type conversion)
Set any node property (auto type conversion)
No parameter schema in public metadata yet.
game_call_methodCall any method on a node
Call any method on a node
No parameter schema in public metadata yet.
game_instantiate_sceneAdd a PackedScene to the running tree
Add a PackedScene to the running tree
No parameter schema in public metadata yet.
game_remove_nodeRemove a node from the tree
Remove a node from the tree
No parameter schema in public metadata yet.
game_change_sceneSwitch to a different scene
Switch to a different scene
No parameter schema in public metadata yet.
game_reparent_nodeMove a node to a new parent
Move a node to a new parent
No parameter schema in public metadata yet.
game_connect_signalConnect a signal to a method
Connect a signal to a method
No parameter schema in public metadata yet.
game_disconnect_signalDisconnect a signal
Disconnect a signal
No parameter schema in public metadata yet.
game_emit_signalEmit a signal with arguments
Emit a signal with arguments
No parameter schema in public metadata yet.
game_list_signalsList all signals on a node with connections
List all signals on a node with connections
No parameter schema in public metadata yet.
game_await_signalAwait a signal with timeout and return args
Await a signal with timeout and return args
No parameter schema in public metadata yet.
game_play_animationControl AnimationPlayer
Control AnimationPlayer
No parameter schema in public metadata yet.
game_tween_propertyTween a property with easing
Tween a property with easing
No parameter schema in public metadata yet.
game_pausePause/unpause the game
Pause/unpause the game
No parameter schema in public metadata yet.
game_performanceGet FPS, memory, draw calls
Get FPS, memory, draw calls
No parameter schema in public metadata yet.
game_waitWait N frames
Wait N frames
No parameter schema in public metadata yet.
game_get_nodes_in_groupQuery nodes by group
Query nodes by group
No parameter schema in public metadata yet.
game_find_nodes_by_classFind nodes by class type
Find nodes by class type
No parameter schema in public metadata yet.
read_fileRead a text file from a Godot project
Read a text file from a Godot project
No parameter schema in public metadata yet.
write_fileCreate or overwrite a text file
Create or overwrite a text file
No parameter schema in public metadata yet.
delete_fileDelete a file from a project
Delete a file from a project
No parameter schema in public metadata yet.
create_directoryCreate a directory inside a project
Create a directory inside a project
No parameter schema in public metadata yet.
game_get_errorsGet new errors/warnings since last call
Get new errors/warnings since last call
No parameter schema in public metadata yet.
game_get_logsGet new print output since last call
Get new print output since last call
No parameter schema in public metadata yet.
game_key_holdHold a key down (no auto-release)
Hold a key down (no auto-release)
No parameter schema in public metadata yet.
game_key_releaseRelease a held key
Release a held key
No parameter schema in public metadata yet.
game_scrollMouse scroll wheel event
Mouse scroll wheel event
No parameter schema in public metadata yet.
game_mouse_dragDrag between two points over N frames
Drag between two points over N frames
No parameter schema in public metadata yet.
game_gamepadGamepad button or axis input
Gamepad button or axis input
No parameter schema in public metadata yet.
game_touchSimulate touch press/release/drag and gestures
Simulate touch press/release/drag and gestures
No parameter schema in public metadata yet.
game_input_stateQuery pressed keys, mouse position, connected pads
Query pressed keys, mouse position, connected pads
No parameter schema in public metadata yet.
game_input_actionManage runtime InputMap actions and strength
Manage runtime InputMap actions and strength
No parameter schema in public metadata yet.
create_projectCreate a new Godot project (supports dotnet: true for C#)
Create a new Godot project (supports dotnet: true for C#)
No parameter schema in public metadata yet.
create_csharp_scriptCreate a C# script in a Godot .NET project
Create a C# script in a Godot .NET project
No parameter schema in public metadata yet.
manage_autoloadsAdd, remove, or list autoloads
Add, remove, or list autoloads
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Godot MCP - Full Control
A comprehensive Model Context Protocol (MCP) server that gives AI assistants full control over the Godot game engine. 157 tools spanning networking, 3D/2D rendering, UI controls, audio effects, animation trees, file I/O, runtime code execution, property inspection, scene manipulation, signal management, physics, project creation, and more.
Acknowledgments
Details
- Repository
- github.com/tugcantopaloglu/godot-mcp
- Website
- github.com/tugcantopaloglu/godot-mcp
- Category
- Design & Creative
- Package
@tugcantopaloglu/godot-mcp- Transport
- STDIO
- Registry
- MCP registry, active
Related Design & Creative MCP servers
View all
Illustrator Mcp Serverie3jp/illustrator-mcp-serverAdobe Illustrator MCP with 68 tools — more than the official Illustrator MCP. macOS | Windows.220stars
Better Godot Mcpn24q02m/better-godot-mcpComposite MCP server for Godot Engine -- 17 composite tools for AI-assisted game development.36stars
Plateau Creative Mcppixelx-jp/plateau-creative-mcpPLATEAU 3D city data as scene-editing and glTF export tools for creative LLM agents.29stars
Ludo AI Game Assetsludo-ai/ludo-mcpGenerate game assets with AI: sprites, animations, 3D models with rigging, video, music, SFX, voices8stars
Figma Context Mcp Aircompassalessandrolorenz/figma-context-mcp-airFigma MCP server for AI agents. 9 tools: design context, variables, screenshots, and FigJam.1stars
Godotcoding-solo/godot-mcpMCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.3.7Kstars