assimilate-mcp

// Control Assimilate Live FX / SCRATCH — professional color grading, compositing, and virtual production software — via MCP. 88 tools across 14 categories.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

nameassimilate-mcp

descriptionControl Assimilate Live FX / SCRATCH — professional color grading, compositing, and virtual production software — via MCP. 88 tools across 14 categories.

homepagehttps://github.com/amac-roguelabs/assimilate-mcp

metadata[object Object]

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