{"report":{"v":1,"package":"@npgamedev/godot-mcp-server","version":"1.1.2","ranAt":"2026-11-16T11:30:12.848Z","install":{"ok":true,"integrity":"sha512-B/hUVU/AjoB2NoE2JuOkGuCfFUbHzrMDvACIUOipLAUMkiZ7Rk0UNjm83g4HE/ZjBf8SU55W9uHUhUlqm0takQ==","deps":96,"scripts":[],"bins":["godot-mcp-server"],"license":"MIT","engines":"node >=22","repository":"git+https://github.com/NPGameDev/godot-mcp-server.git","bin":"godot-mcp-server"},"start":{"ok":true,"ms":234,"serverName":"godot-mcp-toolkit","serverVersion":"1.1.2","protocol":"2025-06-18","stderr":"[godot-mcp] port config: editor=6550 [default], runtime=auto [discovery], lsp=auto [discovery]\n[godot-mcp] WARNING: no GODOT_MCP_CONFIG_VERSION in env. Config may be from a pre-release build — regenerate .mcp.json from the toolkit dock.\n[bridge] ws://127.0.0.1:6550 disconnected; reconnect in 1000ms (attempt 1)\n[godot-mcp] readOnly=false tools=36 hooks=1 caps=project/project\n[bridge] ws://127.0.0.1:6550 disconnected; reconnect in 2000ms (attempt 2)\n[bridge] ws://127.0.0.1:6550 disconnected; reconnect in 4000ms (attempt 3)\n[godot-mcp] tool=scene_get_tree duration=1ms isError=true\n[godot-mcp] tool=project_get_settings duration=1ms isError=true\n[godot-mcp] tool=debugger_get_log duration=2ms isError=true\n"},"tools":[{"name":"scene_get_tree","description":"Return the current edited scene's node tree as nested JSON { name, class, path, children }. Paths use \".\" for root — pass them directly to other editor commands.","params":["max_depth","include_properties"]},{"name":"scene_create_node","description":"Create a node of class_name under parent. Supports engine + user-defined class_name classes. Idempotent: 'returned' on collision, 'created' on fresh.\n\nExample: class_name: \"CharacterBody2D\", parent_path: \".\", node_name: \"Player\"","params":["class_name","parent_path","node_name","layout_mode","unique_name","properties"]},{"name":"scene_delete_node","description":"Delete the node at path (NodePath). Refuses to delete the edited scene root.","params":["node_path"]},{"name":"scene_create","description":"Create .tscn at file_path. Root name = filename stem at '.'. root_type default Node. Idempotent: created|returned|replaced. if_exists: return|fail|replace. Use scene_open afterward to edit.","params":["file_path","root_type","root_name","if_exists"]},{"name":"node_get_property","description":"Read a property from the node at path. Returns { value } (engine types are dict-wrapped).","params":["node_path","property"]},{"name":"node_set_property","description":"Set a property on a node in the EDITOR scene tree (saved to .tscn files). Does NOT affect the running game — for runtime property changes during playtesting, use runtime_set_property.\n\nNode paths are relative to the edited scene root: \".\" is root, \"./Player\" is a direct child, \"./Player/Sprite2D\" for deeper nodes.\n\nEngine types: {type:'Vector2',x,y}. Inline sub-resources: {type:'NewResource',class:'CircleShape2D',properties:{radius:50}}. External resources (textures, audio, tilesets, materials): {type:'Resource', path:'res://path/to/file.tres'}. Packed arrays: {type:'PackedVector2Array', values:[{type:'Vector2',x:0,y:0}, ...]}. Collision layers: {type:'LayerMask', layers:[1,4,6]} (by number) or {type:'LayerMask', layers:['player','walls']} (by name from layer_names_set); optional category defaults to '2d_physics'. All supported type tags: Vector2, Vector3, Vector4, Vector2i, Vector3i, Color, Rect2, Rect2i, Transform2D, Transform3D, NodePath, Resource, NewResource, PackedVector2Array, PackedVector3Array, PackedColorArray, LayerMask. Unknown type tags are rejected with an error listing supported types.\n\nAnchor presets: setting anchors_preset alone may not auto-apply underlying values. For reliable layout, set anchor_left/top/right/bottom and offset_left/top/right/bottom explicitly.\n\nBatch mode: pass batch:[{node_path, property, value, make_unique?}, ...] to set multiple properties at once.","params":["node_path","property","value","make_unique","batch"]},{"name":"node_get_property_list","description":"Introspect node properties. mask: common (default), all, groups, script. 'script' returns all script variables with public/private label; use visibility param to filter.","params":["node_path","mask","visibility"]},{"name":"node_set_script","description":"Attach a script (.gd/.cs) to a node. On Godot 4.2.2+, a .gd changed on disk since it was loaded is reloaded first, for every node running it. Returns @export properties. Empty script_path detaches.","params":["node_path","script_path"]},{"name":"control_set_layout","description":"Set anchor preset + optional margins on a Control node in one call. Uses set_anchors_and_offsets_preset(). Returns final_rect.","params":["node_path","preset","resize_mode","margins"]},{"name":"node_call_method","description":"Call method with args on an edited-scene node (editor-only; for runtime nodes use execute_code).","params":["node_path","method_name","args"]},{"name":"script_read","description":"Read a script file (res:// only). Returns the file content as text in an <untrusted> envelope. Read large scripts in successive line windows via start_line/end_line (1-indexed, inclusive). Paged: returned, total_lines, has_more. When has_more, page via next_start_line until has_more is false. ","params":["file_path","start_line","end_line"]},{"name":"script_write","description":"Write .gd/.cs/.gdshader/.gdshaderinc at file_path (res:// only, creates or overwrites). For .gd files, returns inline diagnostics (valid: bool, diagnostics: [...]) — check valid before proceeding. Not idempotent. Use script.delete to remove; resource.create for .tres; scene.create for .tscn.","params":["file_path","content"]},{"name":"script_edit","description":"Surgically replace a span in an existing .gd/.cs/.gdshader/.gdshaderinc file (res:// only) — the MCP analogue of the native Edit tool. old_string must match the file byte-for-byte (whitespace and indentation included); no regex, no fuzzy match. old_string not found -> NOT_FOUND; matches more than once without replace_all -> NOT_UNIQUE. new_string:'' deletes the span. replace_all replaces every occurrence and returns replacements:N. edits applies several edits in order in one call, writing nothing if any fails. Prefer this over rewriting the whole file with script_write for a small change — it keeps the editor undo entry, reindexing, and inline diagnostics. For .gd files, returns inline diagnostics (valid: bool, diagnostics: [...]) — check valid before proceeding.","params":["file_path","old_string","new_string","replace_all","edits"]},{"name":"script_check","description":"Offline GDScript validation — pass/fail + diagnostics. A class_name clash always carries its line (1-based); a compile error only on 4.5+. Columns are lsp_diagnostics' domain. Works headless.","params":["file_path"]},{"name":"editor_save_scene","description":"Save the current edited scene. Optional file_path triggers save-as.","params":["file_path"]},{"name":"scene_open","description":"Open a scene (.tscn / .scn) as the active edited scene. res:// only; NOT_FOUND if the file doesn't exist.","params":["file_path"]},{"name":"project_get_settings","description":"List ProjectSettings keys + values. Optional prefix filter. Keys matching /password|token|secret|key/i are dropped (MVP filter).","params":["prefix"]},{"name":"editor_get_console","description":"Tail editor Output. source='buffer' (default): live editor console on 4.5+, game-log tail on 4.2-4.4. source='file': the newest log — the game's, or the editor's own when launched with --log-file (4.3+; not 4.4 on Windows). level_filter, since_id, text_filter (is_regex=true for regex). Carries returned/total_lines/has_more + next_id — page via since_id. Primary post-crash diagnostic tool — reads runtime errors even after game_stop.","params":["limit","level_filter","since_id","source","text_filter","is_regex","clear_buffer"]},{"name":"project_set_setting","description":"Write a ProjectSettings key and persist via ProjectSettings.save. Refuses mcp_toolkit/*, mcp/*, and editor/* prefixes. Returns previous_value. Update (no status).","params":["setting","value"]},{"name":"folder_create","description":"Create directory at res:// path (recursive — parents auto-created). Idempotent: status created on fresh, returned if pre-existing.","params":["path"]},{"name":"game_start","description":"Start playtest. Blocks until runtime is ready by default; wait_for_runtime:false launches without blocking. scene_path:'main'|'current'(default)|res://path. if_running:'return' for idempotent mode.","params":["scene_path","wait_for_runtime","runtime_poll","if_running"]},{"name":"game_stop","description":"Stop the currently-playing scene (idempotent — returns was_running:false if nothing was running). No params.","params":[]},{"name":"runtime_screenshot","description":"Capture the running game window. Requires an active playtest (game_start). Use editor_screenshot for the editor viewport. image_response_mode 'disk' saves the PNG and returns only its path.","params":["save_path","image_response_mode","image_detail","force_foreground_game"]},{"name":"debugger_get_log","description":"Game output log. Works during gameplay AND after crash (auto-serves cached output). print()/push_* from a running game are captured here on every version (4.2-4.7) — the 'read my own prints to validate a flow' path. Compile errors will NOT appear here (the game must run); use script_check (one file) or lsp_project_diagnostics (whole project). source='buffer'|'file'. limit=200. text_filter + is_regex for search. +returned/total_lines/has_more (capped tail). Right after game_stop the first call may return GAME_NOT_RUNNING while the session registry settles — retry once (the cache serves the next call).","params":["limit","source","text_filter","is_regex"]},{"name":"input_simulate","description":"Inject input into the running game. events: single {event_type, event_data?, delay_before_ms?, delay_after_ms?} for one action, or an array for a sequence of actions (prefer a single call with multiple events over separate calls). Types: key|mouse_button|mouse_motion|action|click|click_node|send_text. click is a composite: press + 50ms delay + release via push_input (no OS focus/warp; parallel-safe). click_node takes {node_path} — calls grab_focus + emits pressed on BaseButtons (no coordinate guessing). send_text types a string into the focused text field (or the event_data.node_path-targeted Control) by synthesizing per-character key events via push_input, firing the real text_changed/text_submitted signals that setting .text skips. send_text event_data: text (required), node_path? (a Control to focus first), submit? (append Enter); it returns focus_target, focus_source, text_changed, text_after (secret fields redacted), chars_sent, and a hint.\n\nMouse coordinate modes:\n- position: {x, y} — raw viewport/screen coordinates (default). Use for UI elements (buttons, menus).\n- world_position: {x, y} — game-world coordinates, auto-translated via canvas transform (accounts for camera offset and zoom). Use for clicking at specific in-game locations.\n\nMouse events route through push_input (position + global_position) for CanvasLayer/GUI hit-testing — no OS focus/warp, parallel-safe. Returns per-event diagnostics.","params":["events","summary"]},{"name":"runtime_get_script_vars","description":"Get script variables (names, values, public/private) for a live game node. Complements runtime_get_node_state (engine props only). visibility param filters.","params":["node_path","visibility"]},{"name":"execute_code","description":"DANGER: evaluates a GDScript expression. Expression-only — no var/return/if/for statements, no = assignment.\n\nchannel: 'runtime' (default) runs in the running game, 'editor' runs in the editor process.\n\nTo set properties: get_node('/root/Main/Player').set('speed', 400)\nTo call methods: get_node('/root/Main/Player').call('take_damage', 25)\nTo read values: get_node('/root/Main/Player').position\n\nPrefer runtime_set_property for single property changes (safer, no expression syntax). Use execute_code for complex multi-step operations or method calls with specific arguments. If C# project, managed methods are callable at runtime (channel:'runtime').\n\nLIMITATION: Expression cannot access engine singletons (EditorInterface, Engine, OS, Input) or call load()/preload(). Property chaining on method return values (get_node('X').position) may fail due to Variant type erasure — use scope_path to bind the node as self, or use .get('property') instead (get_node('X').get('position') works reliably).","params":["code","scope_path","channel"]},{"name":"signal_list","description":"List signals on a node. include_connections=true adds targets ({target_path, method_name, flags}). flags & 2 = CONNECT_PERSIST (saved in .tscn).","params":["node_path","include_connections"]},{"name":"signal_manage","description":"Connect or disconnect a signal (editor-time, CONNECT_PERSIST — saved in .tscn, survives save/load). Idempotent connect (status 'returned' on collision).","params":["action","node_path","signal_name","target_path","method_name"]},{"name":"node_manage","description":"Structural node operations on the edited scene tree.\n\naction: rename — requires new_name.\naction: reparent — requires new_parent_path, optional keep_global_transform (default true).\naction: reorder — requires new_index (0-based sibling index).\naction: duplicate — optional new_name, parent_path, properties (overrides like {position:{x,y}}).","params":["action","node_path","new_name","new_parent_path","keep_global_transform","new_index","parent_path","properties"]},{"name":"node_groups","description":"Manage node group membership. Groups are the idiomatic Godot way to tag and query game objects (e.g. 'coins', 'enemies').\n\nSingle mode: node_path + group (node_path required for add/remove/list). Batch mode: entries array of {node_path, group} carries per-item paths, and the top-level node_path/group are ignored.\n\naction: add — requires group. action: remove — requires group. action: list — returns all groups (single only).","params":["action","node_path","group","persistent","entries"]},{"name":"autoload_manage","description":"Manage project autoload singletons (GameManager, AudioManager, etc.). Writes to project.godot; takes effect on next game launch.\n\naction: register — requires name + script_path. action: unregister — requires name. action: list — returns all.","params":["action","name","script_path","enabled"]},{"name":"scene_query","description":"Search scene tree with filters (class, group, name glob, property conditions). Returns matching nodes. Faster than scene_get_tree + manual filtering. Paged: returned, total_matches, has_more. When has_more, page via next_offset until has_more is false. Stable only if the source is unchanged between calls. Results are returned in deterministic depth-first order; nodes echoes offset/limit. limit is 1-200 (default 50, clamped above 200). If the tree changes between paged reads (nodes added, removed, or reordered) results may skip or repeat — re-query from offset 0.","params":["class_filter","group_filter","name_pattern","property_filters","root_path","max_depth","include_properties","offset","limit"]},{"name":"scene_spatial_map","description":"Spatial layout of the current scene: per-node world position, bounds (2D Rect2 / 3D AABB), size, plus computed overlaps/gaps/containment. Call before placing or moving nodes to find clear space. Paged: returned, total_nodes, has_more. Cursor-less — narrow with subtree/class/region/radius or raise max_nodes for more. ","params":["detail","class","subtree","region","radius","center","max_nodes"]},{"name":"discover_tools","description":"Find and activate tool groups by name or domain keyword. Activate only the groups needed for your current task (up to ~5) — loading many groups at once floods the tool list and degrades response quality. No params → full catalog. reset: true → deactivate ALL groups; reset: ['group_a'] → deactivate only group_a. Groups: runtime_advanced [available] — Inspect live node state, set node properties, and control AnimationPlayer during playtests; signals [available] — Emit signals on scene nodes at editor-time or runtime; animation_authoring [available] — Inspect and author keyframes, edit tracks, and configure AnimationTree state machines; input_map [available] — List, create, and edit input actions and their key/controller bindings; resource_io [available] — Load and write Godot resources (.tres/.res) programmatically; asset_ops [available] — List assets, query dependencies, and import binary files into the project; placeholders [available] — Generate placeholder/prototype assets procedurally — textures (shapes, patterns, labels) and sound effects (tones, noise). No art or network needed.; cleanup [available] — Delete files, scripts, scenes, resources, and folders; close open scenes; user_data [available] — Read, write, delete, and list user:// save files; scene_advanced [available] — Diff scenes and batch-instantiate nodes from packed scenes; editor_advanced [available] — Capture editor screenshots, refresh the filesystem, and wait for idle; tilemap [available] — Read and paint cells on TileMap/TileMapLayer nodes — cell queries, bulk fills, and region operations; tileset [available] — Create TileSet resources, add atlas sources, configure layers, and manage tile alternatives; tileset_edit [available] — Edit per-tile properties: physics, terrain, navigation, visuals, and custom data; theme [available] — Edit UI theme overrides: styleboxes, fonts, colors, and constants; layer_naming [available] — Get and set physics, render, and navigation layer names; path_editing [available] — Edit Path2D curves and generate collision shapes from sprite textures; 3d_tools [available] — Create 3D primitives, lights, cameras, and environment setups; procedural [available] — Edit gradients, curves, and FastNoiseLite resources for procedural generation; scene_inheritance [available] — Create inherited scenes (variants) from base scenes; audio [available] — List and configure audio buses, effects, and volume settings; spriteframes [available] — List, create, and edit SpriteFrames animations and import from spritesheets; particles [available] — Create and configure GPU particle systems for visual effects; navigation [available] — Set up navigation regions, meshes, and obstacle avoidance; lsp_code_analysis [available] — GDScript diagnostics, symbols, hover info, and a project-wide compile check via the language server; lsp_code_navigation [available] — Code completion, go-to-definition, and find references via the language server; debugger [available] — Inspect debugger sta","params":["request","activate","include_schemas","reset"]},{"name":"extensions_refresh","description":"Force a filesystem rescan and re-discover extension scripts. Call after creating, modifying, or deleting extension files from outside the Godot editor. Returns the updated list of extension commands.","params":[]}],"toolsHash":"4b0665120e56da83c82a1aa4ff0c4e1bfa8afb6372a975a53ccab2319f73f5af","wrote":[],"callsAt":"2026-11-16T11:30:19.352Z","calls":[{"tool":"scene_get_tree","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: {\"success\":false,\"error\":\"WebSocket error: connect ECONNREFUSED 127.0.0.1:6550\",\"code\":\"CONNECT_FAILED\",\"hint\":\"Could not connect to the Godot editor plugin. Ensure Godot is running with the plugin en"},{"tool":"project_get_settings","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: {\"success\":false,\"error\":\"WebSocket error: connect ECONNREFUSED 127.0.0.1:6550\",\"code\":\"CONNECT_FAILED\",\"hint\":\"Could not connect to the Godot editor plugin. Ensure Godot is running with the plugin en"},{"tool":"debugger_get_log","ok":false,"ms":3,"bytes":0,"error":"tool reported an error: {\"success\":false,\"error\":\"no runtime_port in registry — start the game in the editor (F5) with a debug build\",\"code\":\"GAME_NOT_RUNNING\",\"hint\":\"No running game. Call editor_get_console(level_filter:['"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"very-long","tool":"discover_tools","quote":"3000 characters or more"}],"tools":36,"wrote":0,"callsTried":3,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@npgamedev/godot-mcp-server","version":"1.1.2","ranAt":"2026-11-16T11:30:12.848Z","outcome":"started","tools":36,"contacts":0,"flags":1,"serious":0,"toolsHash":"4b0665120e56da83c82a1aa4ff0c4e1bfa8afb6372a975a53ccab2319f73f5af"}],"page":"https://bragproof.smaverk.com/r/%40npgamedev/godot-mcp-server"}