get_scene_tree
Lists a USD stage's prims under a root with paths, types, and world positions, helping you find prim paths before inspecting or editing them. Use filters or include properties to write details to a file.
Instructions
List the stage's prims under root as prim blocks: each one's path, type and world position, to max_depth.
Use it to find prim paths before acting on them: it is the lightest look at a scene. A prim at max_depth that has children says how many, as children = N (truncated), and nothing below it is listed. The prims inside an instanceable prim are not listed (get_mesh_stats looks inside). With include_properties, filter_types or property_filter, Kit writes the blocks to mcp_output/scene_dump.txt instead, replacing the last, each with the prim's rotation, world box and physics flags, and its applied API schemas, variant sets, attribute values and relationship targets with include_properties or property_filter; the answer gives the file's path, how many prims it holds and how deep it went: grep it, or read it in parts. Kit writes that file itself, so with Kit on another machine it lands there. get_prim_properties reads one prim inline.
The positions and rotations follow the simulation, where physics has each rigid body while it plays or after a pause, so one call with property_filter=["physics:"] gives where every body under root came to rest, whatever the filter keeps of the rest.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_scene_tree"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root | No | Prim path to start from | / |
| max_depth | No | How many levels below root: 5 when left out, or 15 with properties or a filter; in the list, a prim on the last level says how many children it has | |
| filter_types | No | Only prims of these types, e.g. ["Mesh", "Xform"], written to the file; the others' children are still walked | |
| property_filter | No | Only properties whose names hold one of these, e.g. ["joint"], written to the file; it takes the properties with it. ["variant_sets"] lists every prim's variant sets: a scene's switches | |
| include_properties | No | Each prim's rotation, world box, applied API schemas, variant sets, attribute values and relationship targets, written by Kit to mcp_output/scene_dump.txt |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |