LABSCO SUMMARY

It replaces grep-and-read on a Godot project with calls that already know who calls what.

The design point is that the agent stops guessing: godotiq_impact_check names the callers before a rename, godotiq_placement proposes coordinates instead of inventing them, and godotiq_verify_motion proves a node moved by comparing two state snapshots rather than by reading a picture. Two boundaries are stated in the tools themselves. godotiq_scene_map, godotiq_spatial_audit, godotiq_placement, godotiq_suggest_scale, godotiq_nav_query, godotiq_camera and godotiq_explore are 3D-only and return incomplete or misleading data on a 2D scene. And godotiq_screenshot and godotiq_explore are the expensive visual path the text tools exist to avoid — godotiq_explore also caps its own output.

What it is

A server over a Godot project and its live editor session, 38 tools spanning static analysis of .gd and .tscn files, editor-side scene and script editing, and inspection of the running game.

What you get

Cross-references before an edit: godotiq_file_context returns a file's public API, dependencies, signals and who imports it; godotiq_dependency_graph and godotiq_signal_map trace emitters, listeners, orphan signals and missing ones project-wide; godotiq_impact_check names what a rename would break
Scene editing with Ctrl+Z undo — godotiq_node_ops batches move, reparent, rename, add_child, delete and property assignment; godotiq_build_scene creates many nodes at once in a grid, line or scatter; godotiq_save_scene refuses with SCENE_MISMATCH when the active tab is not the scene you named
Script work through godotiq_script_ops with convention validation and a patch mode that touches only what you specify, plus godotiq_check_errors as a text-only compile check
Spatial reasoning for 3D scenes: godotiq_scene_map for positions, distances and bounds, godotiq_placement for validated spots that respect Marker3D slots, godotiq_suggest_scale from comparable assets, godotiq_spatial_audit for floating objects, z-fighting and scale mismatches
Runtime evidence: godotiq_run starts and stops the game, godotiq_state_inspect reads live property values, godotiq_watch records a value's history across an interaction, godotiq_verify_motion compares two snapshots to prove something moved, godotiq_perf_snapshot reports FPS, draw calls, memory and node count
Errors read as text rather than screenshots — godotiq_read_debug_console pulls the Debugger panel, godotiq_verify_project_runs returns PASS only when scripts compile, Play starts and the console shows no failing errors
Project inventory through godotiq_asset_registry, which finds unused assets and missing references, and godotiq_trace_flow, which follows a function or signal through the codebase

Requirements

GODOTIQ_PROJECT_ROOT pointing at the project, and the Godot editor open for the editor-side tools — godotiq_file_ops blocks .tscn and .scn writes while the editor holds the scene. A .godotiq.json in the project supplies protected files and asset_origins. The runtime tools need the game started through godotiq_run first. MIT licensed.

Setup effort

One command — uvx godotiq

See installation options

USE CASES

Renaming a signal without breaking its listeners

Trace who emits and who listens across the project, ask what the change would break before making it, then edit the script with a patch that touches only the lines you named.

godotiq_signal_mapgodotiq_impact_checkgodotiq_dependency_graphgodotiq_script_ops

Picking up a project you did not write

One summary call replaces manual exploration, the editor context says what is currently open, the live scene tree shows actual node names, and file context gives a file's public API and callers before you touch it.

godotiq_project_summarygodotiq_editor_contextgodotiq_scene_treegodotiq_file_context

Placing a new prop in a 3D scene

Read the scene's real positions and bounds, get candidate spots that respect Marker3D slots and avoid walls and overlaps, take a scale suggested from comparable objects already in the scene, then apply and save.

godotiq_scene_mapgodotiq_placementgodotiq_suggest_scalegodotiq_node_opsgodotiq_save_scene

Proving a change actually works in game

Compile-check the scripts as text first, start the game, read live property values instead of screenshots, and confirm movement by comparing two snapshots rather than by describing a picture.

godotiq_check_errorsgodotiq_rungodotiq_state_inspectgodotiq_verify_motiongodotiq_verify_project_runs

Chasing an error the game just printed

Read the Debugger panel as text rather than asking anyone to copy it out, follow the failing function or signal through the call chain, and check the live values along the way.

godotiq_read_debug_consolegodotiq_trace_flowgodotiq_state_inspect

38 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`godotiq_animation_audit`

Find animation problems: broken tracks, missing transitions, wrong loop settings, unreferenced animations. Run before shipping to catch animation bugs.

Args: scope: "all" (scan entire project) or "scene" (single scene). scene: Path to .tscn file when scope="scene". detail: "brief" (severity counts only), "normal" (+ issue list), "full".

`godotiq_node_ops`

Core scene editing tool. Batch operations with Ctrl+Z undo: move, rotate, scale, set_property, set_anchors (Control nodes, 16 presets like "center"/"full_rect" or explicit [left,top,right,bottom]), add_child, delete, duplicate, reparent, rename, get_property, assign_resource, set_project_setting. All ops in one call = one undo action. add_child accepts inline properties:{name: value} applied and verified together with the node creation (e.g. {"op": "add_child", "parent": "UI", "type": "Button", "name": "Play", "properties": {"text": "Play"}}); a property that cannot apply fails that op with no node added. assign_resource fills typed resource slots (shape/texture/mesh/script): {"op": "assign_resource", "node": "Collision", "property": "shape", "resource": {"type": "RectangleShape2D", "properties": {"size": [32, 32]}}} or resource: {"path": "res://..."}. set_project_setting writes whitelisted project settings (application/run/main_scene first among them, plus window size/stretch) with immediate save: {"op": "set_project_setting", "setting": "application/run/main_scene", "value": "res://main.tscn"} — not undoable via Ctrl+Z. ALWAYS pass scene (the .tscn you intend to edit): the editor refuses the batch if a different scene is active, preventing edits landing in the wrong open tab. ALWAYS add validate:true for 3D spatial operations (move/scale/add_child) to prevent placing objects inside walls or on top of each other — validation is not yet supported on 2D scenes (returns BLOCKED; omit validate there). If ANY validated op is BLOCKED, the entire batch is rejected (atomic). Per-op status can be "ok", "error", or "unverified" (the editor could not confirm the change in the live scene — treat as NOT applied). Exception: an unverified add_child that reports actual_properties means the node IS in the scene but the listed unverified_properties did not stick (e.g. a clamping setter) — fix those with set_property, do NOT re-add the node. Check top-level all_verified/warning before assuming success.

Args: operations: List of operation dicts, each with 'op' key. Max 50 per call. scene: .tscn path you intend to edit — ALWAYS pass it. Forwarded to the editor as a preflight guard and used for spatial validation (auto-detects main scene if omitted). detail: Output verbosity — "brief" (summary), "normal" (default), or "full" (everything).

INSTALLATION

Connect your client

Server setup

Install the Godot addon into a project

TERMINAL

uvx godotiq install-addon <YOUR_GODOTIQ_PROJECT_ROOT>

MCP Clients

Any MCP client

ANY MCP CLIENT · JSON

{
  "mcpServers": {
    "godotiq": {
      "command": "uvx",
      "args": [
        "godotiq"
      ],
      "env": {
        "GODOTIQ_PROJECT_ROOT": "<YOUR_GODOTIQ_PROJECT_ROOT>"
      }
    }
  }
}

GodotIQ

It replaces grep-and-read on a Godot project with calls that already know who calls what.

What it is

What you get

Requirements

Setup effort

Renaming a signal without breaking its listeners

Picking up a project you did not write

Placing a new prop in a 3D scene

Proving a change actually works in game

Chasing an error the game just printed

38 tools

godotiq_animation_audit

godotiq_animation_info

godotiq_asset_registry

godotiq_build_scene

godotiq_camera

godotiq_check_errors

godotiq_dependency_graph

godotiq_editor_context

godotiq_exec

godotiq_explore

godotiq_file_context

godotiq_file_ops

godotiq_impact_check

godotiq_input

godotiq_nav_query

godotiq_node_ops

godotiq_perf_snapshot

godotiq_ping

godotiq_placement

godotiq_project_summary

godotiq_read_debug_console

godotiq_run

godotiq_save_scene

godotiq_scene_map

godotiq_scene_tree

godotiq_screenshot

godotiq_script_ops

godotiq_signal_map

godotiq_spatial_audit

godotiq_state_inspect

godotiq_suggest_scale

godotiq_trace_flow

godotiq_ui_map

godotiq_undo_history

godotiq_validate

godotiq_verify_motion

godotiq_verify_project_runs

godotiq_watch

What to know first

Tools you get

Requires

Optional

Where it runs

Moderate Standing cost

Connect your client

Server setup

MCP Clients

Any MCP client

Same category

Godot MCP

Godot MCP Pro

GoPeak

FreeCAD

`godotiq_animation_audit`

`godotiq_animation_info`

`godotiq_asset_registry`

`godotiq_build_scene`

`godotiq_camera`

`godotiq_check_errors`

`godotiq_dependency_graph`

`godotiq_editor_context`

`godotiq_exec`

`godotiq_explore`

`godotiq_file_context`

`godotiq_file_ops`

`godotiq_impact_check`

`godotiq_input`

`godotiq_nav_query`

`godotiq_node_ops`

`godotiq_perf_snapshot`

`godotiq_ping`

`godotiq_placement`

`godotiq_project_summary`

`godotiq_read_debug_console`

`godotiq_run`

`godotiq_save_scene`

`godotiq_scene_map`

`godotiq_scene_tree`

`godotiq_screenshot`

`godotiq_script_ops`

`godotiq_signal_map`

`godotiq_spatial_audit`

`godotiq_state_inspect`

`godotiq_suggest_scale`

`godotiq_trace_flow`

`godotiq_ui_map`

`godotiq_undo_history`

`godotiq_validate`

`godotiq_verify_motion`

`godotiq_verify_project_runs`

`godotiq_watch`