context

context

MCP tool wrappers for Houdini scene-understanding / context operations.

Each tool delegates to the corresponding handler running inside Houdini via the HTTP bridge.

Functions:

Name	Description
compare_snapshots	Take or compare scene state snapshots.
explain_node	Explain a node in human-readable form.
get_cook_chain	Trace the cook dependency chain for a node.
get_network_overview	Get a compact overview of a network.
get_node_errors_detailed	Get detailed error analysis for nodes.
get_scene_summary	Get a high-level summary of the scene.
get_selection	Get the current node selection.
set_selection	Set the node selection.

Functions

compare_snapshots async

compare_snapshots(
    ctx: Context, action: str = "take", snapshot_name: str = "default"
) -> dict

Take or compare scene state snapshots.

Parameters:

Name	Type	Description	Default
action	str	"take" or "compare".	'take'
snapshot_name	str	Snapshot name.	'default'

explain_node async

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

Explain a node in human-readable form.

Parameters:

Name	Type	Description	Default
node_path	str	Node path.	required

get_cook_chain async

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

Trace the cook dependency chain for a node.

Parameters:

Name	Type	Description	Default
node_path	str	Node path.	required

get_network_overview async

get_network_overview(ctx: Context, path: str = '/obj', depth: int = 2) -> dict

Get a compact overview of a network.

Parameters:

Name	Type	Description	Default
path	str	Network path.	'/obj'
depth	int	Recursion depth.	2

get_node_errors_detailed async

get_node_errors_detailed(
    ctx: Context, node_path: Optional[str] = None, root_path: str = "/"
) -> dict

Get detailed error analysis for nodes.

Parameters:

Name	Type	Description	Default
node_path	Optional[str]	Node to analyze, or scan from root_path if omitted.	None
root_path	str	Root path to scan.	'/'

get_scene_summary async

get_scene_summary(ctx: Context) -> dict

Get a high-level summary of the scene.

get_selection async

get_selection(ctx: Context) -> dict

Get the current node selection.

set_selection async

set_selection(ctx: Context, node_paths: Optional[list] = None) -> dict

Set the node selection.

Parameters:

Name	Type	Description	Default
node_paths	Optional[list]	Node paths to select.	None