cache

cache

MCP tool wrappers for Houdini cache management operations.

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

Functions:

Name	Description
clear_cache	Delete cached files on disk for a cache node.
get_cache_status	Get the detailed status of a cache node.
list_caches	List all cache-type nodes under a root path.
write_cache	Execute a cache node to write files to disk.

Functions

clear_cache async

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

Delete cached files on disk for a cache node.

Parameters:

Name	Type	Description	Default
ctx	Context	MCP context.	required
node_path	str	Path to the cache node.	required
frame_range	Optional[list[int]]	[start, end] frame range to limit deletion.	None

get_cache_status async

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

Get the detailed status of a cache node.

Parameters:

Name	Type	Description	Default
ctx	Context	MCP context.	required
node_path	str	Path to the cache node.	required

list_caches async

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

List all cache-type nodes under a root path.

Parameters:

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

write_cache async

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

Execute a cache node to write files to disk.

Parameters:

Name	Type	Description	Default
ctx	Context	MCP context.	required
node_path	str	Path to the cache node.	required
frame_range	Optional[list[int]]	[start, end] frame range to render.	None