Troubleshooting

Bridge not connecting

Symptom: AI assistant says it can’t connect to the bridge.

Check:

  1. Is the M4L device loaded on a track in Ableton Live?
  2. Does the Max console show “Live MCP Bridge listening on port 19740”?
  3. Is another process using port 19740?

“v8: no function” errors in Max console

Symptom: Max console shows v8: no function ... [none].

The v8 script file isn’t loading. Check:

  1. The .amxd file is in the same folder as lom-handler-v8.js
  2. Open the Max console and look for lom-handler-v8.js: script loaded
  3. Double-click the v8 object in the patcher to check for errors

Tools return errors

Symptom: Tools fail with LOM errors.

Check that:

  1. The LOM path is valid — use get_children to explore the object tree
  2. The property exists on the object
  3. The property is readable/writable (some are read-only)

Port conflicts

If port 19740 is in use, set custom ports:

In your MCP client config:

{
  "mcpServers": {
    "live-mcp": {
      "command": "npx",
      "args": ["@mixofreality/live-mcp"],
      "env": {
        "LIVE_MCP_BRIDGE_PORT": "19750"
      }
    }
  }
}

You’ll also need to update the port in the M4L bridge source code and rebuild.