Flstudio MCP

Propose per-track fader trims so each track's peak sits in a healthy band (~-12..-6 dBFS, aim -9) and the Master keeps -3..-6 dB headroom. READ-ONLY proposals -- apply approved ones via fl_apply_mix_fix (rollback). Uses FULL-SONG peaks from a recent watch (fl_mix_watch_start -> play -> fl_mix_watch_stop) when available; else a ~1.2s snapshot (prefer watch). FL's fader is POST-chain, so this sets a track's OUTPUT level, not a true pre-plugin input trim.

Which mixer track each channel-rack channel is linked to: {total, channels:[{channel, name, target_mixer_track, target_name}]}.

All channel-rack channels (index, name, volume, pan, mute, solo).

All mixer tracks (index, name, volume, pan, mute, solo). Names in this overview are truncated; use a single-track read for the full name.

Return whether FL is currently playing and / or recording.

Tempo, transport state, pattern/channel/mixer counts.

Which destination tracks this mixer track sends to: {track, name, routes_to:[{dst, dst_name, level?}]}.

Routing for every mixer track (paginated under the hood, returned whole): {total, routing:[{i, name, routes_to:[...]}]}.

Return the current playhead position in beats from the song start.

Return the current FL Studio project tempo in beats per minute.

Measure a mixer track's level by sampling meter peaks over a short window. Requires PLAYBACK -- returns playing=False (avg/peak null) when stopped/silent. {track, playing, avg_db, peak_db}.

Group sources into a bus, EXCLUSIVELY: each source -> bus ON and its direct -> Master OFF; bus -> Master ON; optional bus rename. Applied as ONE rollback unit -- fl_rollback_last_change undoes the whole grouping.

List the built-in genre processing-chain recipes (vocal, drum_bus, bass, master) and their ordered steps.

Read FL's installed-plugin DATABASE from disk (the .fst shortcuts FL writes for every scanned plugin) -> a de-duped, categorized list of what you OWN. Bypasses the FL API (which only sees LOADED plugins). FL still can't LOAD these -- it's for library-aware suggestions. effects_by_role is a rough keyword grouping (Claude should apply its own plugin knowledge). Read-only (directory listing only).

Read preset NAMES from disk: FL Presets\ (per-plugin 'Plugin presets', plus Channel/Mixer presets) + Serum 2 Presets (.serumpreset). With NO filter -> a SUMMARY (which plugins have presets + counts). With plugin_filter -> that plugin's full preset list. Read-only. FL can't LOAD presets via the API -- this is for suggestions (you load the named preset, then Claude can tweak it).

Begin a peak-HOLD watch: continuously sample every mixer track's peak, keeping a RUNNING MAX per track, until fl_mix_watch_stop. Tell the user to PLAY the whole song (or at least the loudest section / the drop) while this runs -- then stop for full-song-accurate level diagnosis. Read-only.

Is a peak watch running, and for how long / how many polls so far?

Stop the peak watch and diagnose on the FULL-SONG running-max peaks captured across the whole watch (accurate clipping/headroom/imbalance vs the ~1.2s snapshot). Read-only -- proposes fixes, applies nothing.

Mute a group of tracks (leaves the others as they are). Use category or explicit tracks. One rollback unit; reverse with fl_clear_mute_solo.

Check that FL Studio is running and the controller script is loaded. Returns the controller's reported FL Studio version, the age of the last heartbeat in seconds, and the MIDI port names in use. Call this first when something seems wrong.

Start playback. Idempotent — calling while already playing is a no-op.

Every named parameter of the plugin in this slot: index, name, normalised value (0..1) and FL's display string (e.g. '3.6dB', '500Hz'). Returns {"total", "params":[{"i","name","v","s"}, ...]}.

List the filled effect slots (0-9) on a mixer track, with plugin names. We cannot load NEW plugins (FL API limit) -- this only reports plugins already present in the project.

Set one plugin parameter (normalised 0..1). ``param`` may be an index or a name; names are resolved from the live param list. The change is logged and undo-able via fl_rollback_last_change. Returns before/after plus the resolved {index, name}.

Quantize the notes ALREADY in the open Piano roll: reads the score, snaps note starts (and optionally lengths) to the grid, rewrites -- via the pyscript bridge, no dialog. Needs the Piano roll open + MCP_Apply armed once this session (same setup as note writing).

Toggle FL Studio's record-arm state.

Compare your mix's LEVEL + rough tonal BALANCE to a reference track. READ-ONLY. Analyzes the reference FILE (overall level + low/mid/high spectral-band shares) and your mix (Master peak for level + a ROUGH name-based band estimate). HONEST: a level/balance compare, NOT a spectral match -- FL doesn't expose its output audio, so the your-mix balance is estimated from track names + peaks. Suggests adjustments; applies nothing.

Undo the most recent write by replaying its pre-change snapshot.

Set the color of channel-rack channels (separate from mixer-track color). Target by index or name substring. ONE rollback unit -- fl_rollback_last_change reverts it.

Mute or unmute a channel-rack channel (state=True mutes).

Set a channel-rack channel's pan position (-1 left .. +1 right).

Solo or unsolo a channel-rack channel (state=True solos).

Set a channel-rack channel's volume. unit='db' uses 0.8=unity (0 dB).

When on, write tools return a 'planned' preview without changing FL.

Mute or unmute a mixer track (state=True mutes).

Rename a mixer track.

Set a mixer track's pan position (-1 left .. +1 right).

Solo or unsolo a mixer track (state=True solos).

Set a mixer track volume. unit='db' uses 0.8=unity (0 dB).

Enable/disable a send from src -> dst (calls afterRoutingChanged on the FL side). Snapshot + readback; undo with fl_rollback_last_change.

Move the playhead to the given beat position.

Set the FL Studio project tempo. Range is 10-999 BPM (FL's own limits).

Set the color of mixer tracks. Pick targets by category ('drums', 'bass', ...) or an explicit tracks list; choose a color by name or hex. All writes are ONE rollback unit -- fl_rollback_last_change reverts them. (Master is never colored.)

Plan a genre-appropriate processing chain over a track's EXISTING plugins. READ-ONLY plan: returns the ordered intent calls (each with the matched plugin + slot) and which steps are MISSING because the needed plugin isn't loaded (FL can't load plugins -- add those manually). After the user approves, apply each step by calling its 'apply' tool+args (fl_apply_eq_intent / fl_apply_compression_intent / fl_apply_reverb_intent -- each logged + rollback-able). e.g. vocal: HP -> comp -> presence -> air -> reverb.

Isolate a group so only it is audible -- mutes every OTHER (non-Master) track. Use category ('drums', etc.) or explicit tracks. Implemented as mute-the-rest (reliable; FL's multi-solo is inconsistent). Reverse with fl_clear_mute_solo. One rollback unit.

Stop playback. Idempotent.

Suggest presets from YOUR library matching a description, for a given plugin. Reads the plugin's preset NAMES from disk + ranks by name match. Name-only (can't hear the sound) -- apply your own knowledge of preset naming. FL can't LOAD presets via the API: recommend which to load in the plugin manually; AFTER the user loads it you can tweak its params via fl_plugin_set_param / fl_apply_*_intent.

Read current state for a scope (for your own before/after diffing).

Toggle between play and stop, mirroring the spacebar in FL.

Write notes into the currently-open FL Piano roll. Each note: {pitch (MIDI), time_bars, length_bars, velocity 0-1}. Set quantize (grid in bars) to snap note starts to a grid before writing. Setup: open the Piano roll and run 'MCP_Apply' once from its Scripting menu (so Run last script again targets it). mode='replace' clears first.

Write CHORDS / a progression (stacked notes sharing start times) into the selected channel via the bridge. YOU stack chord tones drawn from the raga/scale (give simultaneous notes the SAME time_bars). Tool selects the channel + writes. SHOW the user the chords BEFORE calling.

Write a MELODY (single-line, sequential notes) into the selected channel via the piano-roll bridge. YOU (Claude) generate the swaras for the named raga/root -> MIDI notes (use the proper aarohana/avarohana; respect the raga's allowed swaras); this tool only selects the channel + writes. SHOW the user the notes/swaras BEFORE calling. Needs the Piano roll open + MCP_Apply armed once this session (see the note-bridge setup).