inspect_prim
Captures a prim from up to 14 cube-face and corner angles, framed to fill each image, saving PNGs so you can review an object from every side.
Instructions
Capture a prim from up to 14 angles around it, each framed so the prim fills the image, and save each as a PNG in mcp_output/captures/.
Use it to see one object from every side; capture_viewport takes one picture from a camera as it stands. The angles are the 6 face centres and 8 corners of a cube around the prim, all 14 unless angles names some. The distance is fitted to the prim's size at width x height, then moved by zoom_offset. It moves whichever camera the viewport looks through, a scene camera included, and leaves it at the last angle. isolate hides everything but the prim and the lights while it captures, then shows them again. A call has about 80 s: an angle that fails says why, and the angles after it say Not captured. An orthographic camera is refused. An all-black angle, or lighting that lights nothing (mode off, or stage with no scene lights) though Kit's grid shows, comes with a warning, once a call, saying what to change with viewport_light.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prim_path": "<prim_path>"
},
"name": "inspect_prim"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | Image width in pixels, up to 4096; the camera is rendered at this size | |
| angles | No | Angle names, all 14 when omitted. Face centres: "front", "back", "right", "left", "top", "bottom". Cube corners: "top_front_right", "top_front_left", "top_back_right", "top_back_left", "bottom_front_right", "bottom_front_left", "bottom_back_right", "bottom_back_left" | |
| height | No | Image height in pixels, up to 4096; the camera is rendered at this size | |
| isolate | No | Hide everything else while capturing, then restore it | |
| prim_path | Yes | Full USD path of the prim, e.g. "/World/Robot" | |
| zoom_offset | No | Adjusts the fitted distance: negative closer, positive further (-0.3 is 30% closer) | |
| include_segmentation | No | Also capture instance segmentation at each angle |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |