lops

lops

MCP tools for LOPs / USD stage inspection and manipulation.

Functions:

Name	Description
create_light	Create a USD light in a LOP network.
create_light_rig	Create a preset lighting rig in a LOP network.
create_lop_node	Create a new LOP node.
find_usd_prims	Search USD prims by path pattern.
get_last_modified_prims	Get prims modified by the last LOP node cook.
get_stage_info	Get USD stage info from a LOP node.
get_usd_attribute	Read a USD attribute value from a prim.
get_usd_composition	Get composition arcs for a USD prim.
get_usd_layers	List all layers in a USD stage.
get_usd_materials	List all USD materials on a stage.
get_usd_prim	Get detailed info about a USD prim.
get_usd_prim_stats	Get prim counts by USD type under a root path.
get_usd_variants	Get variant sets and selections for a USD prim.
inspect_usd_layer	Inspect a USD layer by index.
list_lights	List all USD lights on a LOP stage.
list_usd_prims	List USD prims on a stage with filtering.
set_light_properties	Set properties on a USD light prim via an inline Python LOP.
set_usd_attribute	Set a USD attribute value via an inline Python LOP.

Functions

create_light async

create_light(
    ctx: Context,
    parent_path: str = "/stage",
    light_type: str = "dome",
    name: str | None = None,
    intensity: float = 1.0,
    color: list[float] | None = None,
    position: list[float] | None = None,
) -> dict

Create a USD light in a LOP network.

Parameters:

Name	Type	Description	Default
parent_path	str	Parent LOP network path.	'/stage'
light_type	str	"dome", "distant", "rect", "sphere", "disk", or "cylinder".	'dome'
name	str | None	Light node name.	None
intensity	float	Light intensity.	1.0
color	list[float] | None	[r, g, b] color values.	None
position	list[float] | None	[x, y, z] world position.	None

create_light_rig async

create_light_rig(
    ctx: Context,
    parent_path: str = "/stage",
    preset: str = "three_point",
    intensity_mult: float = 1.0,
) -> dict

Create a preset lighting rig in a LOP network.

Parameters:

Name	Type	Description	Default
parent_path	str	Parent LOP network path.	'/stage'
preset	str	"three_point", "studio", "outdoor", or "hdri".	'three_point'
intensity_mult	float	Multiplier for all light intensities.	1.0

create_lop_node async

create_lop_node(
    ctx: Context,
    parent_path: str,
    lop_type: str,
    name: str | None = None,
    prim_path: str | None = None,
) -> dict

Create a new LOP node.

Parameters:

Name	Type	Description	Default
parent_path	str	Parent node path.	required
lop_type	str	LOP node type (e.g. "sphere", "sublayer", "merge").	required
name	str | None	Node name.	None
prim_path	str | None	USD prim path to set on the node.	None

find_usd_prims async

find_usd_prims(ctx: Context, node_path: str, pattern: str) -> dict

Search USD prims by path pattern.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
pattern	str	Glob pattern (supports , *) or substring.	required

get_last_modified_prims async

get_last_modified_prims(ctx: Context, node_path: str) -> dict

Get prims modified by the last LOP node cook.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required

get_stage_info async

get_stage_info(ctx: Context, node_path: str) -> dict

Get USD stage info from a LOP node.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required

get_usd_attribute async

get_usd_attribute(
    ctx: Context,
    node_path: str,
    prim_path: str,
    attr_name: str,
    time: float | None = None,
) -> dict

Read a USD attribute value from a prim.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
prim_path	str	USD prim path.	required
attr_name	str	Attribute name.	required
time	float | None	Time code (frame number).	None

get_usd_composition async

get_usd_composition(ctx: Context, node_path: str, prim_path: str) -> dict

Get composition arcs for a USD prim.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
prim_path	str	USD prim path.	required

get_usd_layers async

get_usd_layers(ctx: Context, node_path: str) -> dict

List all layers in a USD stage.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required

get_usd_materials async

get_usd_materials(ctx: Context, node_path: str) -> dict

List all USD materials on a stage.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required

get_usd_prim async

get_usd_prim(ctx: Context, node_path: str, prim_path: str) -> dict

Get detailed info about a USD prim.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
prim_path	str	USD prim path.	required

get_usd_prim_stats async

get_usd_prim_stats(ctx: Context, node_path: str, prim_path: str = '/') -> dict

Get prim counts by USD type under a root path.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
prim_path	str	Root prim path to gather stats from.	'/'

get_usd_variants async

get_usd_variants(ctx: Context, node_path: str, prim_path: str) -> dict

Get variant sets and selections for a USD prim.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
prim_path	str	USD prim path.	required

inspect_usd_layer async

inspect_usd_layer(ctx: Context, node_path: str, layer_index: int = 0) -> dict

Inspect a USD layer by index.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
layer_index	int	Layer index (0 = root layer).	0

list_lights async

list_lights(ctx: Context, node_path: str) -> dict

List all USD lights on a LOP stage.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required

list_usd_prims async

list_usd_prims(
    ctx: Context,
    node_path: str,
    root_path: str = "/",
    prim_type: str | None = None,
    kind: str | None = None,
    depth: int | None = None,
) -> dict

List USD prims on a stage with filtering.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path.	required
root_path	str	Root prim path to list from.	'/'
prim_type	str | None	USD type filter (e.g. "Mesh", "Xform").	None
kind	str | None	Kind filter (e.g. "component", "group").	None
depth	int | None	Max traversal depth.	None

set_light_properties async

set_light_properties(
    ctx: Context, node_path: str, prim_path: str, properties: dict[str, Any]
) -> dict

Set properties on a USD light prim via an inline Python LOP.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path to connect after.	required
prim_path	str	USD light prim path.	required
properties	dict[str, Any]	Property name-value pairs to set.	required

set_usd_attribute async

set_usd_attribute(
    ctx: Context, node_path: str, prim_path: str, attr_name: str, value: Any
) -> dict

Set a USD attribute value via an inline Python LOP.

Parameters:

Name	Type	Description	Default
node_path	str	LOP node path to connect after.	required
prim_path	str	USD prim path.	required
attr_name	str	Attribute name.	required
value	Any	Value to set.	required