Health check to verify Houdini is connected and responsive. Returns server status info or an error if Houdini is unreachable.

Returns the current connection status to Houdini, including whether connected, port, command count, and timing info.

Ask Houdini for scene info. Returns JSON as a string.

Create a new node in Houdini.

Last execute_code payload stored in the Houdini session (errors included).

Modify an existing node — rename, reposition, or change parameters.

Delete a node from the Houdini scene by path.

Get detailed info about a node: type, parameters, inputs, outputs.

Connect two nodes: src output -> dst input.

Disconnect a specific input on a node.

Set display, render, and/or bypass flags on a node.

Save the current Houdini scene, optionally to a new file path.

Load a .hip file into Houdini.

Set the current frame in Houdini's playbar.

Auto-layout child nodes in the network editor.

Scan the node hierarchy for cook errors and warnings.

Get an overview of all nodes in a network with their connections.

Get the cook dependency chain for a node (inputs all the way up).

Get a human-readable explanation of a node: type, non-default parms, connections.

Get the currently selected nodes in Houdini.

Set the node selection to the given list of node paths.

Get a single parameter's value, type, expression, and metadata.

Set a single parameter value on a node.

Set multiple parameters at once on a node.

File/path parms on a node (alembic, usd, texture, fbx, vdb). No new importer.

Set a node's file parm. create_node + set_file — not import_alembic/import_volume.

Get the full parameter schema (all parm templates) for a node.

KineFX skeleton joints (point name + P) on a SOP. Mixamo/character inspect.

kinefx::fbxcharacterimport under mcp_* geo. Mixamo/character rest pose.

kinefx::fbxanimimport — Mixamo clip. Attach to a character SOP geo.

Skin + capture pose + clip → kinefx::jointdeform under mcp_*.

source='capybara' uses testgeometry_capybara (outputclip + motionclipevaluate).
source='nodes' wires rest_path / capture_path / anim_path.
map_joints remaps Mixamo-like clip names onto the capture skeleton.
proof hashes deform geo at clip start vs end — must differ (not T-pose).

Map Mixamo-like clip joint names onto a rest skeleton. Unmapped names error.

List all children of a node, optionally recursive.

Find nodes matching a name pattern, optionally filtered by type.

List node types. category e.g. 'Sop'/'Lop'/'Object'; pattern is a glob matched against the type name or label, e.g. 'intersect'.

Execute an HScript command and return stdout/stderr.

Evaluate a Houdini expression and return the result.

Get USD stage info from a LOP node: prims, layers, time codes.

Get details of a specific USD prim.

Search for USD prims matching a pattern.

Get USD layer stack info from a LOP node.

Import a USD file via reference or sublayer.

Execute multiple operations in one undo group.

Each operation: {"type": "create_node", "params": {...}}.

Not a transaction. Unknown command types are rejected before anything
runs, but if an operation raises, the ones before it stay applied and
the error reports `completed` and `failed_index`. Check those before
retrying.

Houdini Python-shell noise. quiet (default) hides per-command connect/execute/disconnect. verbose restores it. HOUDINIMCP_LOG=verbose also works. Does not restart the TCP listener.

Reload houdinimcp handler modules in the live houdini-bin.

After `scripts/install.py --houdini-version 22.0`, call this so new
command keys exist without restarting H22. Does not restart the TCP
listener. If this 404s, the process still has the old table — run
execute_code: `from houdinimcp.handlers.plugin import bootstrap_reload; bootstrap_reload()`
once, then this tool works.

List all pane tabs in the Houdini desktop.

Viewport camera, shading, Hydra delegate. viewer= pane name (optional).

Look through an OBJ camera or a USD prim (e.g. /world/cam).

Set viewport display options (shading, guides, grid, isolate).

LOP Hydra delegate (xpu, cpu, vk, storm) or OBJ view type (persp/top).

List Hydra delegates on the LOP Scene Viewer and the current one.

Set LOP viewport renderer: 'xpu', 'cpu', 'vk', 'storm', or exact name.

Does not restart or wait — XPU converges asynchronously. Poll
list_hydra_renderers, then capture_screenshot later.

Rebuild the active LOP Hydra delegate. Can stall the UI; prefer not to.

Pause or resume the active LOP Hydra delegate.

USD purpose vis on the LOP viewer: proxy/guide/render/materials/procedurals.

Frame the viewport on the current selection.

Frame the viewport on all geometry.

Refuses if isolate matches no OBJ (that framed the infinite grid).
Use frame_bbox for a character/hero.

Frame a world-space bbox or a node's geometry. Does not home the grid.

Frame the LOP viewer on a USD prim bbox (hero, not the infinite grid).

Karma viewport quality. H22 has no pixel-sample HOM; LOP settings are the knob.

Reports viewport sample API as unavailable instead of pretending.
paused goes through setRendererPaused and returns pause_honored.

Set viewport direction: front, back, left, right, top, bottom, persp.

Capture the current Scene Viewer and return the pixels in-band.

source='viewport' is a flipbook snapshot of the current Hydra buffer
(does not wait for Karma XPU to converge; restores renderer pause).
source='opengl' uses an OpenGL ROP (OBJ-centric beauty).
For a full desktop/UI grab, use capture_desktop (runs outside houdini-bin).

Returns JSON metadata plus an MCP image of the PNG. Path is still in the JSON.

Grab the Houdini window from the OS — does not run inside houdini-bin.

Use this to verify network editor / UI. Viewport beauty should use
capture_screenshot instead.

Set the current network path in the network editor.

List USD prims up to a given depth.

Get a specific USD attribute value.

Set a USD attribute value.

Get stats about a USD prim: child count, attr count, active, payload.

Get recently modified prims from the edit target layer.

Create a LOP node.

Get composition arcs (references, payloads, inherits, specializes) for a prim.

Get variant sets and selections for a USD prim.

Inspect a specific USD layer by index in the stack.

Create/edit a Dome Light LOP under mcp_* isolation.

USD Preview Surface + assignmaterial under mcp_*.

Set primvars:displayColor on a USD mesh (not a full material).

Place a LOP Camera looking at a prim bbox. Look through the USD prim string.

List all light prims in a USD stage.

Search Houdini documentation offline using BM25. Returns ranked results with path, title, preview, and relevance score. Does NOT require a Houdini connection.

Get the full content of a Houdini documentation page by its relative path (as returned by search_docs). Does NOT require a Houdini connection.

Check if a Karma (husk) or Mantra (mantra-bin) render is still running. Optionally pass output_path to also report file existence and size. No Houdini connection needed — runs on the bridge side.