### Claude Desktop

Add to `claude_desktop_config.json`:

## 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:

## 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

## Remote Access

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

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

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

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