assimilate-mcp

# Assimilate MCP

Control [Assimilate Live FX / SCRATCH](https://assimilateinc.com) — professional color grading, compositing, and virtual production software — via MCP. Complete 1:1 integration of the [Assimilate REST API](https://github.com/Assimilate-Inc/Assimilate-REST) with 88 tools across 14 categories.

## Prerequisites

- [Assimilate Live FX or SCRATCH](https://assimilateinc.com) with REST API enabled
- [Node.js](https://nodejs.org) v18+
- Live FX HTTP server enabled: **System Settings → General → Enable HTTP Server** (default port 8080)

## Setup

### MCPorter

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

### Claude Desktop

Add to `claude_desktop_config.json`:

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

### Claude Code

```bash
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:

```json
{
  "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` |...