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_houdini_connection_status	Check the Codex-to-Houdini bridge without raising on disconnect.
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.

Classes

Functions:

export_file async

export_file(
    ctx: Context,
    node_path: str,
    file_path: str,
    frame_range: Optional[list[float]] = 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[float]]	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_houdini_connection_status async

get_houdini_connection_status(ctx: Context) -> dict

Check the Codex-to-Houdini bridge without raising on disconnect.

Returns structured connection diagnostics, including the configured bridge URL and Houdini health payload when reachable. Use this before live viewport workflows when Houdini may have restarted or its hwebserver may not be running.

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