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, and report whether a cache actually appeared.

Functions:

clear_cache async

clear_cache(
    ctx: Context, node_path: str, frame_range: list[int] | None = 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	list[int] | None	[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: list[int] | None = None
) -> dict

Execute a cache node, and report whether a cache actually appeared.

success and wrote_files reflect the files on disk and the errors of the node that did the writing -- a filecache delegates to an internal ROP and stays silent itself, so a failed write used to be reported as success. Errors are named with the node they came from.

Parameters:

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