Luxaudica speaks MCP — the open standard that lets AI assistants like Claude
use real tools. Connect once, and the assistant becomes a VJ who can see the screen, hear the
state of the desk, move every control, and build entirely new scenes — while you talk to it
like a colleague. This page is the complete guide to that surface.
What this actually means
An assistant connected to Luxaudica isn't pasting keystrokes — it has the same first-class
controls you do, plus judgment tools you don't: it can privately preview any look at
four musical moments before daring to show it, and it reads honest performance numbers so it
never puts something heavy on a struggling machine. You stay the director; it's the fastest
pair of hands you've ever worked with.
Connecting (once, two minutes)
Step 1 — allow control. In Luxaudica's settings, turn on Allow local control. The app only ever listens on your own Mac — nothing is exposed to the network or the internet.
Step 2 — install the connector. The app's Connect screen hands you a one-file connector (a .mcpb bundle). Double-click installs it into Claude Desktop. Other MCP-capable assistants point at the same connector file.
Step 3 — say hello. Ask Claude: "What's on screen in Luxaudica right now?" If it answers with the scene and the tempo, you're connected.
The app must be running for the assistant to reach it. If the connection drops, the assistant
says so plainly — nothing fails silently.
House rules for a good session
It looks before it leaps. A well-behaved assistant reads the state first, auditions before switching, and checks a snapshot after changing things. Claude does this on its own; if it doesn't, ask it to.
You own taste. Tell it what you feel, not which slider to move: "too frantic", "warmer", "make the drop land harder". Translating feeling into parameters is its job.
Safety is yours, always. Blackout and panic work from the panel no matter what the assistant is doing. Its slider moves are clamped to the same safe ranges yours are.
Deletions ask twice. Anything destructive (deleting a scene or look) requires explicit confirmation.
The full surface
Everything below is a real capability, listed under the name the assistant will use when it
narrates its work. The "say this" lines are starters — copy one into Claude and edit.
Seeing — how the assistant knows what's happening
These are the assistant's eyes. It never has to guess what's on screen.
Read the deskgetState
One call returns everything: the current scene and every slider, the saved-look list, whether a show is playing, the live music (tempo, key, energy), and honest performance numbers.
A good assistant calls this first, before touching anything — like a stagehand looking at the desk before moving a fader.
What's playing right now, and how does the look sound to you?
See the screenrenderSnapshot
Returns the actual current frame as an image — what the audience sees this second. The assistant uses it to check its own changes.
Show me what the output looks like right now.
Audition a sceneauditionScene · auditionPreset · auditionStatus
The killer feature: the assistant renders any scene offline at four musical moments — quiet, groove, build-up, drop — and gets back a four-panel contact sheet. It can judge a look the way a curator would, without ever putting a bad frame on your wall.
This is how the AI iterates safely during a live night: audition in private, show only when it's good.
Audition Kaleido before you switch to it — I don't want surprises.
List what existslistScenes · listAuthoredScenes · getSceneSource
The scene menu, readable by the assistant — including any scenes it has authored itself, which it can re-open and refine.
Learn the house rulesgetAuthoringGuide
The app's built-in manual for making new scenes: what the music inputs are, the visual conventions, worked examples. Assistants read this before creating anything, so new scenes feel native.
Shaping the look
Everything you can do on the panel, the assistant can do by name.
Switch scenessetScene
Change the visual world instantly (with your crossfade). Case doesn't matter — "kaleido" works.
Put Dunes on, slow crossfade.
Move the sliderssetControl
Every slider from the control room by name: intensity, speed, warp, glow, trails, punch, ambient, brightness, the full color grade (exposure, contrast, lift, gamma, gain), the film pack (grain, halation, vignette…), and more. Values are clamped to safe ranges — an assistant cannot push anything somewhere dangerous.
More punch, a touch less glow, and warm the grade up slightly.
Colors & moodssetPalette · setLUT · setToggle
Pick one of the six palettes, apply a film LUT (Noir, Teal Orange, Warm Film, or your own), and flip the reactivity modes — macro reactive, key color, timbre glow.
Make the colors follow the song's key, and give it the Noir treatment.
Surprisesurprise
The same curated one-press variation you have on the panel — matched to the music's current energy.
Surprise me, something that fits this track.
Words on screensetOverlayText
Set or clear the one-line text overlay — artist name, dedication, "happy birthday maya".
Put "LUNA — live" on screen in time for her set.
Transitions & pacesetCrossfade · setMaxFPS
How long look changes take (hard cut to ten-second dissolve), and an optional frame-rate cap for quiet fans on long nights.
Safety — always available, always wins
The two red buttons exist here too, so "kill it" works no matter who's driving.
BlackoutsetBlackout
Instant cut to black, fully restorable — the picture comes back exactly as it was.
Blackout until I say otherwise.
Panicpanic
The guaranteed-sane reset: blackout cleared, full brightness, autopilot and show playback stopped, manual control returned. An assistant told "something's wrong, fix it" reaches for this.
Panic — give me manual control, everything visible.
Looks, cues & the show
The whole performance layer is scriptable by conversation.
Saved lookspresets
List, apply, save, rename, reorder, delete — the entire look gallery. "Save this as Peak Hour" is one sentence.
Save the current look as "Golden Hour", and put it in slot one.
Cuescues
Build and edit the show timeline: add a cue from a look, set its hold time, reorder, rename, enable/disable, jump to any cue live.
Build a four-cue show: Dunes 2 minutes, Kaleido 90 seconds, Solar 2 minutes, end on Smoke.
Transportshow
Play, pause, loop, jump — the show's tape deck. Also reads back where the playhead is.
Start the show, loop it, and tell me when it wraps.
Auto-pilotautoPilot
Turn hands-free mode on/off, set how often it changes (seconds or beats), how adventurous it is, and which looks it may draw from.
Auto-pilot every 64 beats, only from my saved looks, nothing too wild.
Creating — new scenes from a sentence
The deepest capability: the assistant can author brand-new visual worlds into your library.
Create a scenecreateScene
From a description — yours in English, translated by the assistant into the app's scene language. It can build simple shader pieces, multi-layer scenes with persistent feedback, particle/fluid simulations with millions of particles, and even declarative 3D scenes with real materials and cameras.
New scenes appear in your menu alongside the built-ins and are saved with the app.
Make me a scene: a lighthouse beam sweeping through slow rain, mostly darkness, the beam widens on the drop.
Refine itupdateScene · validateScene
The assistant iterates: check the scene compiles, audition it at the four musical moments, look at the sheet, adjust, repeat — the same taste loop a human designer runs, in seconds per lap.
The rain reads too busy — thin it out and make the quiet panels darker.
HousekeepingdeleteScene
Remove an authored scene. Destructive, so assistants are asked to confirm before it happens. Built-in scenes can't be deleted.
Three sessions to steal
The art director
Look at what's on screen. I'm playing slow house all evening — tune the look so it feels expensive: darker floor, warmer highlights, drops that swell instead of strobe. Check your work with a snapshot after each change.
The scene commission
Read the authoring guide, then build me a scene called "Harbor": navy darkness, a slow lighthouse beam, rain that thickens with the music's energy. Audition it at all four moments and iterate until the quiet panel is genuinely dark and the drop feels like the beam catching you. Then save a look for it called Harbor Night.
The night shift
Build a 45-minute looping show from my saved looks — calm ones first, peak in the middle, land soft. 3-second crossfades. Start it, then check the performance numbers and tell me if anything's heavy.