io.github.salvo10f/godotiq MCP Server

An MCP server focused on Godot 4, providing “spatial intelligence” and code analysis. The catalog entry describes it as an “intelligent MCP server” with many available tools (35 listed in metadata, 38 stated in the readme excerpt).

🛠️ Key Features

Godot 4 oriented
Spatial intelligence
Code analysis
Tool availability: 35 tools (metadata) and 38 tools (readme excerpt)
Version: 0.5.16

🚀 Use Cases

Analyze Godot 4 code via an MCP-capable AI client
Support tasks involving spatial intelligence in Godot 4 projects

⚡ Developer Benefits

Install via Python: pip install godotiq==0.5.16
For AI clients, auto-install is supported using uvx in MCP config
Uses GODOTIQ_PROJECT_ROOT to point to the Godot project root

⚠️ Limitations

Tool count is not consistent across provided fields (35 vs 38), so exact availability may depend on the referenced version/documentation
License key configuration is only partially shown in the provided excerpt

Install

bash

pip install godotiq==0.5.16

For AI clients, no manual install is required. Use uvx in your MCP config so the client auto-installs GodotIQ on first use:

json

{
  "mcpServers": {
    "godotiq": {
      "command": "uvx",
      "args": ["godotiq"],
      "env": {
        "GODOTIQ_PROJECT_ROOT": "/path/to/your/godot/project"
      }
    }
  }
}

For Pro, add "GODOTIQ_LICENSE_KEY": "YOUR_POLAR_LICENSE_KEY" to the same env block. Do not wrap uvx with the Unix-only env command; this config works on Windows, macOS, and Linux.

Install the Godot addon into a project:

bash

uvx godotiq install-addon /path/to/your/godot/project

Or clone and install the Godot addon directly from godot-addon/addons/godotiq/.

Pro tier

The full suite of analysis tools (dependency graphs, impact checks, scene/spatial mapping, signal/flow tracing) ships as an optional Pro bundle. Community mode shows rich previews of every Pro tool so you can see what you'd unlock before upgrading.

Pro activation uses a signed-receipt model — no network I/O on the hot path once activated. Commerce is powered by polar.sh.

Install

Configuration

Environment variables

GODOTIQ_PROJECT_ROOTrequired

Path to your Godot project root

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

io.github.salvo10f/godotiq