Assimilate MCP

Control Assimilate Live FX / SCRATCH — professional color grading, compositing, and virtual production software — via MCP. Complete 1:1 integration of the Assimilate REST API with 88 tools across 14 categories.

Prerequisites

• Assimilate Live FX or SCRATCH with REST API enabled
• Node.js v18+
• Live FX HTTP server enabled: System Settings → General → Enable HTTP Server (default port 8080)

Setup

MCPorter

mcporter config add assimilate --command npx --args '["-y", "assimilate-mcp"]'
mcporter list assimilate

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "assimilate": {
      "command": "npx",
      "args": ["-y", "assimilate-mcp"]
    }
  }
}

Claude Code

claude mcp add assimilate -- npx -y assimilate-mcp

Configuration

| Flag | Env Var | Default | Description |

|------|---------|---------|-------------|

| --host | ASSIMILATE_HOST | 127.0.0.1 | Live FX host |

| --port | ASSIMILATE_PORT | 8080 | REST API port |

| --key | ASSIMILATE_KEY | — | Authorization key |

| --timeout | ASSIMILATE_TIMEOUT | 30000 | HTTP timeout (ms) |

Example with custom port:

{
  "mcpServers": {
    "assimilate": {
      "command": "npx",
      "args": ["-y", "assimilate-mcp", "--port=9090"]
    }
  }
}

Tools (88)

| Category | Count | Key Tools |

|----------|:-----:|-----------|

| System | 8 | get_system check_connection list_users select_user |

| Projects | 7 | list_projects enter_project create_project |

| Groups | 9 | list_groups get_current_group create_group |

| Constructs | 10 | list_constructs create_construct enter_construct |

| Slots | 5 | list_slots get_slot set_slot create_slot |

| Versions | 5 | list_versions get_version set_version |

| Shots | 7 | get_shot set_shot create_shot import_media |

| Inputs | 4 | get_inputs get_input set_input |

| Color Grading | 5 | get_grade set_grade get_framing set_framing |

| Player | 8 | enter_timeline set_playmode enter_shot exit_player |

| Render | 10 | start_render stop_render get_render_status |

| Outputs | 6 | list_outputs create_output set_output |

| Snapshots | 2 | render_snapshot get_shot_metadata |

| Files | 2 | list_directory find_media |

Usage Examples

Talk to your AI assistant in natural language:

• *"What projects are available?"*
• *"Import the ARRIRAW files from /Volumes/Shuttle/Day_14"*
• *"Warm up the gamma on this shot"*
• *"Set up ProRes 4444 output and render the timeline"*
• *"Take a snapshot of this frame"*

MCPorter CLI

mcporter call assimilate.check_connection
mcporter call assimilate.list_projects
mcporter call 'assimilate.enter_project(name: "Commercial_Nike_Q3")'
mcporter call assimilate.get_grade

Remote Access

Live FX accepts connections on localhost by default. For remote machines, use an SSH tunnel:

ssh -f -N -L 8080:127.0.0.1:8080 user@livefx-host

Links

• GitHub
• npm
• Assimilate REST API
• Assimilate Inc