# set_reference_image_opacity

A write tool on the Cocos MCP server.

Agent View of the PolicyLayer registry record for `set_reference_image_opacity`. HTML page: https://policylayer.com/tools/caravanglory-cocos-mcp-server/set-reference-image-opacity

## Facts

- Tool: `set_reference_image_opacity`
- Server: Cocos (`caravanglory/cocos-mcp-server`) — https://policylayer.com/tools/caravanglory-cocos-mcp-server.md
- Homepage: https://github.com/caravanglory/cocos-mcp-server
- Risk category: Write (Medium risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 0
- Recommended policy verdict: Rate-limited

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_reference_image_opacity",
    "arguments": {}
  }
}
```

## Why set_reference_image_opacity is rated Medium

This tool creates or modifies editor state (reference image opacity) reversibly without destroying data or executing arbitrary code. While it affects visual properties in the editor, the change is non-destructive and can be undone. It does not execute code, trigger external operations, delete data, or involve financial transactions.

From the tool's own definition: "set_reference_image_opacity modifies the opacity property of a reference image in Cocos Creator, which is a reversible change to scene state."

## Use case

AI agents use set_reference_image_opacity 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.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Cocos:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "set_reference_image_opacity": {
      "limits": [
        {
          "counter": "set_reference_image_opacity_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on Cocos (156)

- `batch_delete_assets` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/batch-delete-assets.md
- `clear_all_reference_images` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/clear-all-reference-images.md
- `clear_broadcast_log` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/clear-broadcast-log.md
- `clear_console` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/clear-console.md
- `delete_asset` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/delete-asset.md
- `delete_node` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/delete-node.md
- `remove_component` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/remove-component.md
- `remove_reference_image` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/remove-reference-image.md
- `revert_prefab` — Destructive — https://policylayer.com/tools/caravanglory-cocos-mcp-server/revert-prefab.md
- `align_view_with_node` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/align-view-with-node.md
- `build_project` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/build-project.md
- `change_gizmo_tool` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/change-gizmo-tool.md
- `change_view_mode_2d_3d` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/change-view-mode-2d-3d.md
- `execute_component_method` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/execute-component-method.md
- `execute_scene_script` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/execute-scene-script.md
- `execute_script` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/execute-script.md
- `focus_camera_on_nodes` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/focus-camera-on-nodes.md
- `listen_broadcast` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/listen-broadcast.md
- `open_asset_external` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/open-asset-external.md
- `open_preferences_settings` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/open-preferences-settings.md
- `refresh_assets` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/refresh-assets.md
- `refresh_reference_image` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/refresh-reference-image.md
- `reimport_asset` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/reimport-asset.md
- `run_project` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/run-project.md
- `scene_snapshot_abort` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/scene-snapshot-abort.md
- `soft_reload_scene` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/soft-reload-scene.md
- `start_preview_server` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/start-preview-server.md
- `stop_listening` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/stop-listening.md
- `stop_preview_server` — Execute — https://policylayer.com/tools/caravanglory-cocos-mcp-server/stop-preview-server.md
- `format_mcp_request` — Other — https://policylayer.com/tools/caravanglory-cocos-mcp-server/format-mcp-request.md
- …and 126 more: https://policylayer.com/tools/caravanglory-cocos-mcp-server.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=caravanglory-cocos-mcp-server · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/caravanglory-cocos-mcp-server