Blender Add-on
Generate from a prompt or image inside Blender, receive models from Studio and your agent over the local Bridge, and let Hydrilla Agent or your own MCP agent build the open scene.
Install
Blender 3.0 or newer, on Windows, macOS or Linux.
- Download hydrilla-blender.zip from https://hydrilla.ai/plugins/hydrilla-blender.zip.
- In Blender, open Edit › Preferences › Add-ons.
- Open the menu at the top right and choose Install from Disk (on Blender 4.1 and older, click Install…).
- Select hydrilla-blender.zip and tick the box to enable Hydrilla.
- In the 3D Viewport, press N and open the Hydrilla tab.
You install it once. The add-on checks https://hydrilla.ai/plugins/hydrilla-blender.json when Blender starts and updates itself in place without reinstalling the zip. The Check button in the Hydrilla tab looks again, and Auto turns automatic updates off.
API key
Paste a hyd_live_ key from hydrilla.ai/app/api-keys into the Hydrilla tab. It is checked as soon as you paste it and the tab shows Key saved. The key is saved in ~/.hydrilla/config.json (readable only by you), not in the .blend file, and the other Hydrilla plugins and the MCP server on this computer use it too. There is no browser sign-in.
Generate
Under Generate, choose Text and describe the model, or choose Image and pick a file or paste an https:// image link, then click Generate. The tab shows the phase and progress; Cancel stops the task and refunds unused credits. The finished GLB is imported into the open scene. Your models lists recent generations so you can import any of them again.
Bridge
The Bridge is a small local server that receives models from Send to DCC in Studio and from the MCP server. It listens on 127.0.0.1:7345. Start with Blender is on by default, so the Bridge section shows Bridge on whenever Blender is open; Run and Stop turn it on and off by hand.
GET /healthreturns{ "ok": true, "service": "hydrilla-bridge", "app": "blender", … }.POST /import(or/import-file) takesmesh_urlorfile_base64, plus optionalnameandjob_id. GLB only.
curl -X POST http://127.0.0.1:7345/import \
-H "Content-Type: application/json" \
-d '{"mesh_url": "https://…/model.glb", "name": "treasure-chest"}'A request that carries an Origin header (a web page) is accepted only from Hydrilla's own sites or a site served on this computer; everything else gets 403.
Hydrilla Agent
Once the API key is saved, Connect to Hydrilla Agent (on by default, add-on 2.3 or newer) links this Blender to Hydrilla Agent at hydrilla.ai/app/agent. The add-on connects out to the Hydrilla backend with your key and waits for commands, so nothing listens on the network for it. The agent can read the scene, import models and capture the viewport. Scripts that change the scene also need Let AI edit this scene.
Scene tools for MCP agents
With the MCP server connected, Claude Code, Cursor, Codex and other agents can work in the open scene through the Bridge (add-on 2.1 or newer). No second Blender server or port is needed.
hydrilla_blender_scene_info: Objects in the open Blender scene with world location, rotation, scale and bounding-box size. Read-only.hydrilla_blender_run_python: Run Python (bpy) on Blender's main thread and return what it printed. Needs Let AI edit this scene. Each call is one Ctrl+Z step.hydrilla_blender_screenshot: The 3D viewport as an image. Read-only.
Let AI edit this scene
hydrilla_blender_run_python only runs while Let AI edit this scene is on in the Bridge section (off by default). Save your work before turning it on and only use it with an agent you trust. Each script is one Ctrl+Z step.
The command endpoint (POST /command) is stricter than /import: it refuses every request that carries Origin or Sec-Fetch-Site, so no web page can send one, and each request needs the X-Hydrilla-Token header. The add-on writes a fresh random token to ~/.hydrilla/bridge/blender.token (mode 600) each time the Bridge starts and deletes it when the Bridge stops. The MCP server reads it on every call.
Troubleshooting
- Key not accepted: create a new key and paste it into the Hydrilla tab.
- Nothing arrives from Studio or the agent: check that the Bridge section says Bridge on (click Run if it says Bridge off) and Blender is open on a scene.
- The agent says it may not change the scene: turn on Let AI edit this scene.
- Hydrilla Agent says Blender is not connected: check that the key is saved and Connect to Hydrilla Agent is on, and that the add-on is 2.3 or newer.
- Wrong size: Blender works in meters with Z up.
MCP Server
Connect Claude Code, Cursor or Codex.
3ds Max Plugin
Let your agent read and edit the open 3ds Max scene.