add_reference_image

What add_reference_image does on Cocos

AI agents use add_reference_image to create or update resources in Cocos, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Cocos environment.

Why add_reference_image is rated Medium

This tool creates or adds new reference images to a Cocos Creator scene. This is a reversible modification (Write category) rather than a destructive action, as reference images can be removed or modified later. Severity is medium because unintended addition of reference images could clutter the scene or introduce unintended visual elements, but the impact is containable and reversible.

From the tool's definition Tool name 'add_reference_image' and description 'Add reference image(s) to scene' indicate creation of new scene elements. The action modifies the scene by introducing new reference image objects, which is a reversible write operation.

The rule that runs add_reference_image safely

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

{
  "version": "1",
  "default": "deny",
  "tools": {
    "add_reference_image": {
      "limits": [
        {
          "counter": "add_reference_image_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

Questions about add_reference_image