scene.read

Since 0.6

[editor or disk] The scene as canonical JSON (argus://contract/scene): the editor's document (unsaved edits too), else the file.

Plain text

pointer: one value. id (* wildcard), tag, component: matching entities with their index, a row each when many; pointer then reads each. summary: counts, a large scene's answer unless full.


Title	Read a scene
Mode
Token cost	about 228 tokens (in the default list, paid on every call)
Toolset	core

Arguments

Argument	Type	Required	Description
`component`	`string`	no
`full`	`boolean`	no	`true` returns every finding.
`id`	`string`	no
`page`	`integer`	no	A page of the last findings, counted from 0, read without running the check again.
`pointer`	`string`	no	/entities/@door/transform: @x is the element whose id, else type, is x
`resolved`	`boolean`	no	Prefabs expanded, project defaults merged, sources marked
`scene`	`string`	no	The open scene when absent
`summary`	`boolean`	no
`tag`	`string`	no

Example

An MCP tools/call with the required arguments (placeholders in angle brackets).

{
  "name": "scene.read",
  "arguments": {}
}