scene

scene

MCP tool wrappers for Houdini scene operations.

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

Functions:

Name	Description
export_file	Export a node's output to a file on disk.
get_context_info	Get information about a Houdini network context.
get_scene_info	Get information about the current Houdini scene.
import_file	Import a geometry, USD, or Alembic file into the scene.
load_scene	Open or merge a Houdini hip file.
new_scene	Create a new empty Houdini scene.
save_scene	Save the current Houdini scene to disk.

Functions

export_file async

export_file(
    ctx: Context,
    node_path: str,
    file_path: str,
    frame_range: Optional[list] = None,
) -> dict

Export a node's output to a file on disk.

Parameters:

Name	Type	Description	Default
node_path	str	Path to the node to export.	required
file_path	str	Destination file path.	required
frame_range	Optional[list]	Frame range as [start, end] or [start, end, step].	None

get_context_info async

get_context_info(ctx: Context, context: str) -> dict

Get information about a Houdini network context.

Parameters:

Name	Type	Description	Default
context	str	Context path, e.g. "/obj", "/stage", "/out".	required

get_scene_info async

get_scene_info(ctx: Context) -> dict

Get information about the current Houdini scene.

import_file async

import_file(
    ctx: Context,
    file_path: str,
    parent_path: str = "/obj",
    node_name: Optional[str] = None,
) -> dict

Import a geometry, USD, or Alembic file into the scene.

Parameters:

Name	Type	Description	Default
file_path	str	Path to the file to import.	required
parent_path	str	Network path for the import node.	'/obj'
node_name	Optional[str]	Name for the created node.	None

load_scene async

load_scene(ctx: Context, file_path: str, merge: bool = False) -> dict

Open or merge a Houdini hip file.

Parameters:

Name	Type	Description	Default
file_path	str	Path to the hip file to open.	required
merge	bool	Merge into the current scene instead of replacing it.	False

new_scene async

new_scene(ctx: Context, save_current: bool = False) -> dict

Create a new empty Houdini scene.

Parameters:

Name	Type	Description	Default
save_current	bool	Save the current scene before clearing.	False

save_scene async

save_scene(ctx: Context, file_path: Optional[str] = None) -> dict

Save the current Houdini scene to disk.

Parameters:

Name	Type	Description	Default
file_path	Optional[str]	Destination path; defaults to the current hip file.	None