MCP Server
Connect Claude Code, Cursor, Codex and other MCP clients to Hydrilla. Your agent generates 3D models, places them in your open app, and builds in Blender and 3ds Max.
The server is the npm package hydrilla-mcp, a local stdio Model Context Protocol server. It calls the Hydrilla API with your API key on your agent's behalf. It needs Node.js 20 or newer, works on every plan, and generating uses your credits.
Install
Create an API key at hydrilla.ai/app/api-keys and replace the placeholder below. Run the command in your terminal, not in the agent's chat, so the key never reaches the model. Restart the client afterwards.
claude mcp add -s user hydrilla --env HYDRILLA_API_KEY=hyd_live_your_api_key_here -- npx -y hydrilla-mcp@latestclaude mcp add -s user hydrilla --env HYDRILLA_API_KEY=hyd_live_your_api_key_here "--" cmd /c npx -y hydrilla-mcp@latestcodex mcp add hydrilla --env HYDRILLA_API_KEY=hyd_live_your_api_key_here -- npx -y hydrilla-mcp@latestCursor, VS Code, Claude Desktop, Windsurf and other clients take a JSON entry. In Cursor it goes in ~/.cursor/mcp.json; turn hydrilla on in Settings › MCP afterwards.
{
"mcpServers": {
"hydrilla": {
"command": "npx",
"args": ["-y", "hydrilla-mcp@latest"],
"env": { "HYDRILLA_API_KEY": "hyd_live_your_api_key_here" }
}
}
}Skip the key if a plugin has it
If you already pasted your key into a Hydrilla plugin (Blender, Maya, 3ds Max and others), leave env out. The server reads the key the plugin saved in ~/.hydrilla/config.json.
Then ask the agent:
The step-by-step setup with install links for each client is at hydrilla.ai/integrations/mcp. An agent can also set itself up: paste Read and follow https://hydrilla.ai/agent-onboarding/SKILL.md into it.
Environment variables
HYDRILLA_API_KEY: Your hyd_live_ key. Optional when a Hydrilla plugin on this computer already has the key: the server then reads ~/.hydrilla/config.json on every call.HYDRILLA_API_BASE: API address. Defaults to the production backend.HYDRILLA_MAX_TOOLS: full (default with Hydrilla for 3ds Max installed) lists every 3ds Max tool; progressive lists only three tools that list, describe and run the rest; off hides them.
Tools
hydrilla_me: Plan and credit balance. Free; use it to check the connection.hydrilla_text_to_3d: Generate a textured GLB from a prompt. Uses credits. Optional send_to and name.hydrilla_image_to_3d: Generate a textured GLB from a public image URL. Uses credits. Optional send_to and name.hydrilla_get_task: Status, progress and, once it has succeeded, the mesh URL. Waits up to about 45 seconds per call; wait: false checks instantly.hydrilla_list_tasks: Recent models on the account, newest first. Free.hydrilla_cancel_task: Stop a running task. Unused credits are refunded.hydrilla_list_apps: Which apps on this computer have their Bridge running.hydrilla_send_to_app: Put an existing model into an open app. Free.
Agents pick these tools most reliably when the request names Hydrilla, for example “Use Hydrilla to generate a treasure chest and send it to Blender.”
Long-running generations
A model takes 10 to 20 minutes. No tool call stays open longer than about a minute: a generate call returns the task_id with the progress so far, and the agent calls hydrilla_get_task until the task succeeds, telling you the progress in between. Clients that ask for progress notifications receive them too. Hydrilla fails and refunds a task that runs longer than 20 minutes.
Sending models into an app
Pass send_to to a generate tool or hydrilla_get_task, or call hydrilla_send_to_app with a finished task. The app's Hydrilla plugin downloads the GLB and imports it into the open scene. Each plugin's Bridge listens on its own port on 127.0.0.1. If it is off, the tool says what to click, and the model can be sent again without generating it again.
- Blender:
send_to: "blender", port 7345. Starts with Blender; Run in the Bridge section of the Hydrilla tab. - Maya:
send_to: "maya", port 7346. Run Bridge in the Hydrilla window. - 3ds Max:
send_to: "3dsmax", port 7347. Run Bridge in Hydrilla › Generate and import…. - Unreal Engine:
send_to: "unreal", port 7348. Hydrilla › Run Bridge. - Unity:
send_to: "unity", port 7349. Run Bridge in Window › Hydrilla. - Godot 4:
send_to: "godot", port 7350. Run Bridge in the Hydrilla dock.
Blender tools
With the Blender add-on 2.1 or newer and its Bridge running, the agent can also see and change the open scene through the same Bridge:
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.
Scripts only run after the user turns on Let AI edit this scene in the Bridge section of the add-on's Hydrilla tab (off by default). Reading the scene and the viewport needs no extra permission.
3ds Max tools
On a Windows computer with Hydrilla for 3ds Max installed, the server also lists 178 hydrilla_max_* tools that read and edit the open 3ds Max scene. Everywhere else they are not listed at all. Set HYDRILLA_MAX_TOOLS=progressive for clients with a tool limit or a small context. The agent guide is the MCP resource hydrilla://3dsmax/guide.
Blender Add-on
Generate in Blender and let your agent build the scene.
3ds Max Plugin
Let your agent read and edit the open 3ds Max scene.