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