GodotIQ gives your AI 35 specialized tools for understanding and controlling Godot projects. They’re organized into 11 categories across two tiers:
15 Free tools parse .tscn, .tres, and .gd files directly from disk — no Godot addon needed. They provide spatial intelligence, code analysis, flow tracing, project memory, asset management, and animation analysis.20 Pro tools connect to the running Godot editor via the bridge addon, enabling scene editing, visual debugging, runtime monitoring, editor integration, and I/O operations.
Tool Description scene_mapSpatial understanding of .tscn: positions, distances, directions, bounds placementFind safe placement positions for new objects spatial_auditAutomated 3D scene linter: floating objects, scale mismatches, z-fighting
Tool Description dependency_graphComplete dependency graph: what file emits, who listens, what it imports signal_mapProject-wide signal wiring: who emits, who listens, orphan/missing signals impact_checkPredict what breaks BEFORE making a change validateConvention check: missing type hints, missing class_name, orphan signals
Tool Description trace_flowTrace execution flow from function or signal through entire codebase
Tool Description project_summaryArchitecture, autoloads, conventions, file counts file_contextFile’s public API, dependencies, signals, who imports this file
Tool Description asset_registryComplete asset inventory: find unused assets, missing references, by type suggest_scaleRecommend scale and position for model based on similar assets in scene
Tool Description animation_infoAnimation data: tracks, keyframes, length, looping, state machine transitions animation_auditFind animation problems: broken tracks, missing transitions, wrong loop settings
Tool Description node_opsBatch scene editing with Ctrl+Z undo: move, rotate, scale, set_property, add_child, delete, duplicate, reparent build_sceneCreate multiple nodes using high-level patterns save_scenePersist editor changes to disk script_opsRead, write, or patch GDScript files with convention validation
Tool Description screenshotVisual verification of game or editor viewport cameraEditor 3D camera control: get position, reposition, focus on node
Tool Description runStart or stop the Godot game from the editor state_inspectQuery runtime property values (cheaper than screenshots) watchPersistent property monitoring across game interactions verify_motionVerify node property changes over time (proves movement/animation) perf_snapshotFPS, draw calls, memory, node count from running game
Tool Description editor_contextEditor state: open scenes, selected nodes, is game running, project path scene_treeLive editor scene tree with transforms, scripts, groups, visibility undo_historyReview what was changed — undo/redo state and action history check_errorsCheck GDScript files for compilation/parse errors execExecute GDScript code (last resort — prefer dedicated tools)
Tool Description file_opsFilesystem operations within Godot project: list, read, write, move, delete, search inputSimulate player input: actions, keys, UI taps, waits ui_mapMap all UI elements: positions, text, interactivity, visibility nav_queryLive pathfinding via NavigationServer3D
Tool Description pingHealth check — returns server status and version
Free tools provide the intelligence layer. They parse your project files to build spatial maps, dependency graphs, signal chains, flow traces, asset inventories, and animation analysis. They work with any MCP client and need nothing installed in Godot.
Pro tools add the runtime bridge. The Godot addon creates a TCP connection between your AI and the running editor, enabling scene editing, visual debugging, runtime monitoring, editor integration, and I/O operations. Pro requires a one-time $19 license.
Start with the free tools — they cover spatial analysis, code intelligence, flow tracing, project memory, asset management, and animation analysis. Upgrade to Pro when you need runtime access or scene editing.
Code Analysis Dependency graphs, signal maps, impact analysis, and validation. Flow Tracing Trace execution flow from any function or signal. Project Memory Project summaries and file-level context for AI sessions. Assets Asset inventory and scale recommendations. Animation Animation data inspection and problem detection. Bridge & Addon Scene editing, visual debugging, runtime monitoring, editor integration, and I/O. UI Mapping Map live UI trees from the running game. 
