Skip to content

tools

tools

MCP tool modules for FXHoudini-MCP.

Importing this package registers all MCP tools with the FastMCP server. Each submodule uses the @mcp.tool() decorator at import time.

Modules:

Name Description
animation

MCP tool definitions for animation operations.

cache

MCP tool wrappers for Houdini cache management operations.

chops

MCP tool wrappers for Houdini CHOP (Channel Operator) operations.

code

MCP tools for code execution inside Houdini.

context

MCP tool wrappers for Houdini scene-understanding / context operations.

cops

MCP tool wrappers for Houdini COP (Copernicus) operations.

dops

MCP tool definitions for DOP (dynamics/simulation) operations.

geometry

MCP tools for SOP geometry inspection and manipulation.

hda

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

lops

MCP tools for LOPs / USD stage inspection and manipulation.

materials

MCP tool wrappers for Houdini materials and shaders operations.

nodes

MCP tool wrappers for Houdini node operations.

parameters

MCP tools for Houdini parameter operations.

rendering

MCP tool definitions for Houdini rendering operations.

scene

MCP tool wrappers for Houdini scene operations.

takes

MCP tool wrappers for Houdini takes (parameter override system).

tops

MCP tool wrappers for Houdini PDG/TOPs operations.

vex

MCP tool wrappers for Houdini VEX operations.

viewport

MCP tool definitions for Houdini viewport and UI operations.

workflows

MCP tool wrappers for higher-level composite workflow operations.

Functions:

Name Description
result_with_image

Convert a handler result dict into MCP content blocks.

Functions

result_with_image

result_with_image(result: dict) -> list[TextContent | ImageContent]

Convert a handler result dict into MCP content blocks.

If the result contains image_base64, an ImageContent block is appended so that MCP clients (e.g. Claude Desktop) can display the image inline. The base64 key is removed from the metadata text.