find_unused_resources

What find_unused_resources does on Godot

AI agents call find_unused_resources to retrieve information from Godot without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Why find_unused_resources is rated Low

This tool only retrieves and analyzes project metadata to identify unreferenced resources. It has no side effects—it does not modify, delete, execute code, or trigger external operations. The operation is purely informational (Read category). Severity is low because even misuse (e.g., an agent acting on the results) would not directly harm the project without subsequent Write or Destructive actions.

From the tool's definition Tool performs a search/query operation to "find resources in the project that are not referenced" with no modification, deletion, or execution capability mentioned.

The rule that runs find_unused_resources safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Godot, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For find_unused_resources, this is the rule to start with:

{
  "version": "1",
  "default": "deny",
  "tools": {
    "find_unused_resources": {}
  }
}

Questions about find_unused_resources