materials

materials

MCP tool wrappers for Houdini materials and shaders operations.

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

Functions:

Name	Description
create_material_network	Create a new material network in /mat.
get_material_info	Get detailed information about a material node.
list_material_types	List available VOP/material node types.
list_materials	List all material nodes under a root path.

Functions

create_material_network async

create_material_network(
    ctx: Context,
    name: str,
    shader_type: str = "principled",
    params: Optional[dict[str, Any]] = None,
) -> dict

Create a new material network in /mat.

Parameters:

Name	Type	Description	Default
ctx	Context	MCP context.	required
name	str	Name for the new material node.	required
shader_type	str	Shader type name ("principled", "materialx", etc.).	'principled'
params	Optional[dict[str, Any]]	Parameter name-value pairs to set on the shader.	None

get_material_info async

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

Get detailed information about a material node.

Parameters:

Name	Type	Description	Default
ctx	Context	MCP context.	required
node_path	str	Absolute path to the material node.	required

list_material_types async

list_material_types(ctx: Context, filter: Optional[str] = None) -> dict

List available VOP/material node types.

Parameters:

Name	Type	Description	Default
ctx	Context	MCP context.	required
filter	Optional[str]	Substring to filter type names and labels by.	None

list_materials async

list_materials(ctx: Context, root_path: str = '/mat') -> dict

List all material nodes under a root path.

Parameters:

Name	Type	Description	Default
ctx	Context	MCP context.	required
root_path	str	Root path to search for materials.	'/mat'