Relay a command to Houdini and normalize the response envelope.

Return the hou.Node at 'path' or raise a clear error.

Send a JSON command to Houdini's server and wait for the JSON response. Protocol: each message is a 4-byte big-endian length

Get or create a persistent HoudiniConnection object.

Close socket if open.

Force-cook a node and return a structured pass/fail report.

Stop listening; close sockets and timers.

Convert HOM values (vectors, tuples, ...) to JSON-friendly types.

Evaluate a parm tuple; single-component parms come back as scalars.

Helper to validate and return metadata for a rendered image file. Returns the file path so the caller can open it directly — avoids

Connect to the Houdini plugin (which is listening on self.host:self.port).

Rotate the camera center null node by the specified angles around each axis. Args: null_node: The null node to rotate ro

Create a render node based on the specified render engine. Args: render_engine: The render engine to use ("opengl", "karma", or

Resolve 'path' to a SOP node that owns geometry. Accepts a SOP path directly, or a geometry container (OBJ node) whose display SOP is

Adjust camera's distance or ortho width to fully encompass the bounding box, accounting for any rotation of the parent null node. Ar

Calculate the collective bounding box of all given nodes.

Deletes a node from the scene.

Find all displayed geometry nodes in the scene.

Set up a null and camera rig at the given position. Args: bbox_center: The center position for the null orthographic: If

Download from 'url' to local 'dest_folder', returning local filepath. Helper for import_opus_url.

Internal dispatcher that looks up 'cmd_type' from the JSON, calls the relevant function, and returns a JSON-friendly dict.

Timer callback to accept connections and process any incoming data. This runs in the main Houdini thread to avoid concurrency issues.

Set a single parameter (or parm tuple). Returns (previous, new). Resolves menu tokens/labels for string values on menu parms, and

Match 'run_over' against the wrangle's class menu (token or label).

Unzip 'zip_path' into 'dest_folder'. Return list of extracted file paths. Helper for import_opus_url. Validates each

Entry point for executing a JSON command from the client.

Summarize a node's geometry: element counts, bounding box, attributes and group names. Accepts a SOP or a geometry container path.

Query OPUS API via RapidAPI for latest job info (including download URLs). Uses GET_JOB_RESULT_URL constructed from RapidAPI env vars. Re

Run the MCP server on stdio.

Create four standard views and render them: - Front view (0,0,0) - Left view (0,-90,0) - Top view (-90,0,0) - Perspective view (-

Set up camera rig and render a single view with specified rotation. Args: orthographic: If True, create an orthographic camera

Render using a specific camera that already exists in the scene. Args: camera_path: Path to the camera node (e.g., "/obj/mycamer

Set multiple parameters on a node in one call. Values: scalar for single parms, list for tuples (e.g. "t": [0, 1, 0]), menu t

Begin listening on the given port; sets up a QTimer to poll for data.

Wire one node's output into another node's input. Both nodes must live in the same network. input_index selects which input of to_path to con

Wire from_path's output into to_path's input.

Force-cook a node and report whether it cooked cleanly, with errors, warnings and cook time. The definitive way to verify a node works.

Force-cook a node and report errors, warnings and cook time.

Create a new node in Houdini.

Creates a new node in the specified parent.

Create an Attribute Wrangle SOP with the given VEX snippet, optionally wiring input_node into its first input. run_over: points, primitives,

Create a wrangle SOP, set its VEX snippet, optionally wire an input, then cook it so VEX compile errors are reported immediately.

Delete a node from the scene by path.

Disconnect one input of a node.

Disconnect one input of a node (reports what it was connected to).

Executes arbitrary Python code within Houdini.

Execute arbitrary Python code in Houdini's environment. LAST RESORT: prefer the dedicated tools (connect_nodes, set_parameters, create_wrangl

Scan the network under root_path for nodes whose last cook produced errors (optionally warnings too). Fast — reads existing error state w

Walk the network under root_path and report nodes whose last cook produced errors (and optionally warnings). Does not force cooks.

Placeholder for an asset library feature (e.g., Poly Haven).

Checks if the user toggled asset library usage in hou.session.

Read actual attribute values from geometry, paginated (limit capped at 500 — use start to page through large geometry). element: 'points' or

Read actual attribute values from geometry, paginated. element: 'points' or 'primitives'. attributes: list of names (default:

Summarize a node's geometry: point/primitive/vertex counts, bounding box, attribute listings per class, and group names. Accepts a SOP path o

Returns detailed information about a single node.

Describe a node's parameters: names, labels, types, tuple sizes, current values, defaults, numeric ranges and menu options. Use this to disco

Describe a node's parameters: name, label, type, size, current value, defaults, ranges and menu options. Filter with a glob 'pattern'

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

Returns basic info about the current .hip file and top-level nodes per context.

Downloads a ZIP file from URL, unzips it, finds a USD file, and imports it into a new subnet in Houdini.

Handles the 'render_quad_view' command.

Handles the 'render_single_view' command.

Handles the 'render_specific_camera' command.

Placeholder for asset import logic.

Auto-layout all children of a network node.

Auto-layout all children of a network node for a tidy graph.

Modifies an existing node.

Checks the status of an OPUS batch job directly via the API. Requires the batch_id returned by opus_create_model or opus_variate_model. R

Starts a batch job to create one or more 3D models using the OPUS API. Requires the model structure name and a dictionary of parameters.

Returns a list of available OPUS component/structure names.

Retrieves the parameter schema or format instructions for a given OPUS model structure. Returns a dictionary, which might contain 'result' (J

Asks Houdini to download a model (zip containing USD) from a URL and import it into the scene. Requires the download URL (likely obtained fro

Starts a batch job to create variations of an existing OPUS model result. Requires the result_id of the base model. Returns a dictionary

Render 4 canonical views from Houdini and return the image paths.

Render a single view inside Houdini and return the rendered image path.

Render from a specific camera path in the Houdini scene.