Skip to content

hda

hda

MCP tool wrappers for Houdini Digital Asset (HDA) operations.

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

Functions:

Name Description
create_hda

Create a new HDA from an existing subnet node.

get_hda_info

Get detailed information about an HDA definition.

get_hda_section_content

Read the content of a specific section in an HDA definition.

get_hda_sections

List all sections in an HDA definition.

install_hda

Install an HDA file into the current session.

list_installed_hdas

List all installed HDA files and their definitions.

reload_hda

Reload an HDA file from disk.

set_hda_section_content

Write content to a specific section in an HDA definition.

uninstall_hda

Uninstall an HDA file from the current session.

update_hda

Save the current node contents back to its HDA definition.

Functions

create_hda async

create_hda(
    ctx: Context,
    node_path: str,
    hda_file: str,
    type_name: str,
    label: str,
    version: str = "1.0",
) -> dict

Create a new HDA from an existing subnet node.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
node_path
str

Subnet node path.

required
hda_file
str

Destination HDA file path.

required
type_name
str

Operator type name.

required
label
str

Human-readable label.

required
version
str

Version string.

'1.0'

get_hda_info async

get_hda_info(
    ctx: Context,
    node_path: Optional[str] = None,
    hda_file: Optional[str] = None,
    type_name: Optional[str] = None,
) -> dict

Get detailed information about an HDA definition.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
node_path
Optional[str]

Node path.

None
hda_file
Optional[str]

HDA file path.

None
type_name
Optional[str]

HDA type name.

None

get_hda_section_content async

get_hda_section_content(
    ctx: Context, node_path: str, section_name: str
) -> dict

Read the content of a specific section in an HDA definition.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
node_path
str

Node path.

required
section_name
str

Section name.

required

get_hda_sections async

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

List all sections in an HDA definition.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
node_path
str

Node path.

required

install_hda async

install_hda(ctx: Context, file_path: str, force: bool = False) -> dict

Install an HDA file into the current session.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
file_path
str

HDA file path.

required
force
bool

Force reinstall even if already loaded.

False

list_installed_hdas async

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

List all installed HDA files and their definitions.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
filter
Optional[str]

Substring filter for type names or file paths.

None

reload_hda async

reload_hda(ctx: Context, file_path: str) -> dict

Reload an HDA file from disk.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
file_path
str

HDA file path.

required

set_hda_section_content async

set_hda_section_content(
    ctx: Context, node_path: str, section_name: str, content: str
) -> dict

Write content to a specific section in an HDA definition.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
node_path
str

Node path.

required
section_name
str

Section name.

required
content
str

Section content.

required

uninstall_hda async

uninstall_hda(ctx: Context, file_path: str) -> dict

Uninstall an HDA file from the current session.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
file_path
str

HDA file path.

required

update_hda async

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

Save the current node contents back to its HDA definition.

Parameters:

Name Type Description Default
ctx
Context

MCP context.

required
node_path
str

Node path.

required