Command line
start hello-demo
60-second ambient-techno demo you can hear immediately
start first-song
Build a multi-section arrangement from a vibe preset
Vibe preset to build from (e.g. ambient-techno, lofi-house) — maps to a verified genre+preset pair
How to treat existing MIDI tracks, if the wizard’s inner genre-song step finds any: replace (delete them) or append (keep, add after). Required only when the Live set already has MIDI tracks.
Directory the new .vibrai project file is minted into (default: current directory)
Prompt for a choice instead of exiting when input is needed
start genre-song
Build an arrangement from the installed genre catalog
Genre id from the installed catalog (e.g. techno, house, deep_house, downtempo)
Narrow presets to this sub-genre before picking one
Preset id within the chosen genre (e.g. hypnotic_1)
How to treat existing MIDI tracks: replace (delete them) or append (keep, add after last MIDI track). Required only when the Live set already has MIDI tracks.
Directory the new .vibrai project file is minted into (default: current directory)
Prompt for a choice instead of exiting when input is needed
Target scale root: note name (C, C#, Db, …, B) or pitch class 0–11. Omit to use the genre’s own default scale.
Target scale: Major, Ionian, Dorian, Phrygian, Lydian, Mixolydian, Minor, Aeolian, Locrian. Omit to use the genre’s own default scale.
MCP tools
start_hello_demo
Start the Vibrai 60-second hello demo: spin up an ambient-techno beat in Live’s session view in under a minute. Call this when the user asks for a ‘hello demo’ / ‘quick demo’ / ‘showcase’ / wants to hear something fast / says ‘show me what Vibrai can do.’ Executes the flow directly (tempo, tracks, a clip, notes, an instrument, then fires the clips) and returns a structured result — narrate it. If any step’s action is load_device_failed, that track has no instrument and will play silently; tell the user.
start_first_song
Start the Vibrai first-song wizard: build a multi-section arrangement from a vibe preset. Call this when the user asks to ‘build a song’ / ‘make a track’ / ‘create music with Vibrai’ / wants the full guided flow. Executes the flow directly. An omitted or unrecognized vibe returns a needs_input result naming the missing option and listing valid choices — present them to the user and call this tool again with the chosen value. Call get_skill first to load the Vibrai operational playbook.
String
Optional vibe preset. One of: ambient-techno, lofi-house, deep-house, ambient-downtempo, minimal-techno. Omit to receive a needs_input result listing the choices.
String
Optional. How to treat MIDI tracks already in the Live set, if the wizard’s inner genre-song step finds any: “replace” deletes the existing MIDI tracks (audio/return tracks untouched) or “append” keeps them and adds the new tracks after the last MIDI track. IMPORTANT: “append” does NOT re-render onto the existing tracks — it creates a DUPLICATE track set — so never guess between the two; ask the user if you don’t know which they want. Required only when this tool’s needs_input result names on_existing_tracks (i.e. the Live set already has MIDI tracks); omit on a fresh set.
String
Optional. Directory the new .vibrai project file is minted into. Omit to use Vibrai’s per-user data directory (always writable) rather than this process’s working directory.
start_genre_song
Start the Vibrai genre-song wizard: build a full arrangement in a genre and sub-genre picked from the installed genre catalog, via the deterministic apply_genre preset path. Call this when the user names a specific genre or sub-genre (‘make me a techno track’, ‘something deep house’) — for the vibe-preset flow with no genre named, use start_first_song instead. Executes the flow directly. Any unresolved option (genre, sub_genre, or preset when several match) returns a needs_input result naming it and listing valid choices read live from the installed catalog — present them and call this tool again with the chosen value. Call get_skill first to load the Vibrai operational playbook.
String
Optional genre — a slug or display name from the live catalog (list_genres). Omit to receive a needs_input result listing the catalog.
String
Optional sub-genre label from the chosen genre’s presets. Omit to receive a needs_input result listing the choices.
String
Optional preset id within the chosen genre/sub-genre (e.g. hypnotic_1). Required only when several presets match; omitting it then returns a needs_input result listing them.
String
Optional. How to treat MIDI tracks already in the Live set: “replace” deletes the existing MIDI tracks (audio/return tracks untouched) or “append” keeps them and adds the new tracks after the last MIDI track. IMPORTANT: “append” does NOT re-render onto the existing tracks — it creates a DUPLICATE track set — so never guess between the two; ask the user if you don’t know which they want. Required only when this tool’s needs_input result names on_existing_tracks (i.e. the Live set already has MIDI tracks); omit on a fresh set.
String
Optional. Directory the new .vibrai project file is minted into. Omit to use Vibrai’s per-user data directory (always writable) rather than this process’s working directory.
String
Optional target scale root: note name (C, C#, Db, …, B) or pitch class 0–11. Omit to use the genre’s own default scale.
String
Optional target scale: Major, Ionian, Dorian, Phrygian, Lydian, Mixolydian, Minor, Aeolian, Locrian. Omit to use the genre’s own default scale.