A local Model Context Protocol server and MIDI bridge for FL Studio 2026 on macOS. Among the FL Studio MCPs reviewed for this release, Postfader is the only one that verifies persistent writes actually landed. Reads are always available; writes stay off until enabled inside FL Studio, Master is protected, persistent mutations use absolute targets and report explicit undo evidence, and the hermetic suite runs without FL Studio.

An illustration of the shape of a session — not a captured transcript:

You:     the vocal is fighting the synth around 3k
Client:  → fl_list_mixer_tracks        reads the mixer and its routing
         → audio_analyze_masking       measures the overlap between two bounces
         → fl_set_track_eq             cuts one EQ band on one track
                                       verified: true

Why another FL Studio MCP server

FL Studio accepts scripted writes and then silently ignores some of them. Most connectors report the write as sent. For state writes, Postfader reads the control back on a later idle tick and tells you verified: true or verified: false — and treats a false as the headline of the result, not a footnote.

Mixer and plug-in handlers may repeat an FL-facing setter inside one dispatched command because FL drops a lone call. Transport, direct Channel Rack state, routing, and step setters are issued once. No mutating command is dispatched again after an ambiguous transport outcome; an unverified result is not retried for you, a write that landed is never rolled back, and where FL's own undo cannot be relied on the response says so instead of assuming.

Status

A macOS-only beta, validated on Apple silicon with FL Studio 2026 Producer Edition 26.1.3 build 5336, MIDI scripting API 44, and Python 3.10 or newer. Other FL Studio editions and Intel Macs may work but are not currently validated; Windows is not supported by this release.

This repository contains no user-created FL Studio projects, recordings, stems, samples, presets, mix exports, or session-derived evidence. Its three audio fixtures are deterministic and generated by a script in the repository.

What it provides

The server exposes 36 MCP tools:

• 12 inspection tools for capabilities, project and transport state, Playlist selection observations, mixer tracks and routing, loaded effects, Channel Rack state, current-pattern step cells, and bounded plug-in parameter maps.
• 19 opt-in, readback-verified state tools for transport, mixer, Channel Rack, current-pattern steps, and plug-in parameters. Multi-field changes report every field and an aggregate AND verdict.
• 1 bounded live-note audition tool that reports note-on/note-off dispatch without fabricating state verification.
• 4 audio tools for file analysis, reference comparison, vocal/instrument masking measurements, and recent-bounce discovery.

The FL Studio scripting API exposes controls but no live audio buffers. Audio tools therefore operate on files you explicitly export or record to disk.

Safety model

Writes are disabled by default. When enabled, mutating tools apply changes immediately to the open FL Studio project. Readback verifies whether a control moved; it is not an automatic rollback, and FL may not create a usable undo point. Work on a copy until you trust the workflow.

The write surface is intentionally narrow:

1. Each state write names an absolute target rather than exposing a nudge or toggle. The option search and bounded note audition disclose their special behavior explicitly.
2. FL Studio is read back on a later idle tick and the result reports verified: true or verified: false.
3. Mixer track 0 (Master) is refused unless allow_master is explicitly true.
4. Each mutation reports undo_point_created. Commands that request an undo point report whether it was observed; transient actions may truthfully report null.
5. The bridge never calls saveProject; changes can still be saved later by FL Studio or by the user.
6. The packaged bridge source hash must match the running bridge; stale, missing, or malformed provenance fails closed for writes while reads retain an explicit warning.
7. Optional bridge-session and expected-before guards reject stale decisions immediately before mutation.
8. Writes are absent from the active bridge allowlist unless FL Studio itself was launched with FL_BRIDGE_ENABLE_WRITES=1.

fl_set_plugin_param_option must sweep an enumerated control to discover the available option text because FL Studio exposes no enumeration API. Do not use write tools while recording or on irreplaceable material.

Plug-in compatibility

Effects use mixer track plus slot addressing. Channel Rack instruments use a separate, explicit channel_generator target with a global channel index; their FL slot remains -1 internally and the mixer slot contract stays 0–9.

Within that, there is no supported-plug-in list and no per-plug-in profiles: parameters are discovered at runtime, so a plug-in needs no support added for it. What varies is how much of a large parameter map a bounded scan can see, and whether FL reports a given control at all. See Plug-in support for those bounds, how to raise them, and the validated plug-in matrix for published evidence. The matrix records observations; it never enables or disables a plug-in.

Requirements

• macOS with CoreMIDI and an enabled IAC Driver bus
• FL Studio 2026 version 26.1.3 build 5336 or newer
• MIDI scripting API 44 or newer
• Python 3.10 or newer
• An MCP-compatible client

Launch FL Studio once before installing so its user settings folders exist.

Install

Claude Desktop extension

Download the .mcpb asset from the 0.12.0 GitHub Release and open it with Claude Desktop. The extension registers and runs the MCP server locally. It does not silently configure FL Studio: deploy the FL-side bridge and configure the IAC input/output pair using the steps below. Writes remain disabled because the extension never sets FL_BRIDGE_ENABLE_WRITES.

Python package or source checkout

Two setup paths put the same bridge in the same place — scripts/install.sh calls the same installer the console command does, so they cannot drift.

From PyPI, if you just want to use it:

pip install postfader-fl-studio-mcp
postfader-install-bridge

From a clone, if you want the test suite and the validation scripts:

git clone https://github.com/synopsys0/postfader-fl-studio-mcp.git
cd postfader-fl-studio-mcp
./scripts/install.sh

If FL Studio's user-data folder is somewhere other than ~/Documents/Image-Line/FL Studio, say so — every entry point honours it:

postfader-install-bridge --user-data-dir "/absolute/path/to/FL Studio"

FL_STUDIO_USER_DATA_DIR="/absolute/path/to/FL Studio" ./scripts/install.sh

Then, in FL Studio:

1. Open Audio MIDI Setup → Window → Show MIDI Studio.

2. Open IAC Driver, enable Device is online, and apply the change.

3. In FL Studio, open Options → MIDI settings → Input.

4. Select the IAC port, enable it, and set Controller type to Universal Bridge. Note the Port number it is given.

5. In the same dialog, under Output, select the same IAC port and give it the same Port number. The bridge replies over MIDI, so it refuses to start without this and Script output will say so.

6. Open View → Script output and press Reload script. The output should end with ready: MIDI SysEx.

7. Verify the installation:

   postfader-doctor
   

   From a clone, ./.venv/bin/python scripts/doctor.py runs the same checks, and ./scripts/inspect_readonly.py --capabilities prints what the server can currently see.

See Setup and usage for detailed client configuration and troubleshooting.

MCP client configuration

The installer writes a .mcp.json inside this checkout, with relative paths. That is deliberately the narrow case: it works when your client is launched from the connector directory, and it is the quickest way to try the server. It is not how you would normally live with it.

Using it from your own projects

To reach FL Studio while working anywhere else, register the server once at user scope with absolute paths. For Claude Code:

claude mcp add fl-studio --scope user \
    --env FL_BRIDGE_ENABLE_MIDI=1 \
    -- /absolute/path/to/postfader-fl-studio-mcp/.venv/bin/python \
       -m fl_studio_mcp.mcp_server

--scope user is the part that matters: a project-scoped entry only loads inside the directory it belongs to, which is why the installer's .mcp.json does not follow you around. Substitute your real checkout path — the venv interpreter must be named absolutely, because a relative command resolves against wherever the client happened to start.

For a client with no CLI, put the same absolute-path block in whichever config file that client treats as global rather than per-project:

{
  "mcpServers": {
    "fl-studio": {
      "command": "/absolute/path/to/postfader-fl-studio-mcp/.venv/bin/python",
      "args": ["-m", "fl_studio_mcp.mcp_server"],
      "cwd": "/absolute/path/to/postfader-fl-studio-mcp",
      "env": {
        "FL_BRIDGE_ENABLE_MIDI": "1"
      }
    }
  }
}

Do not assume that an MCP client expands ~ or shell variables in JSON paths; write them out in full. .mcp.json.example in this repository shows the same shape with relative paths, for the launched-from-the-checkout case only.

The Python distribution is postfader-fl-studio-mcp. The import path remains fl_studio_mcp, the MCP server command is fl-studio-mcp, and the MCP server ID is fl-studio. Installed utilities are postfader-install-bridge, postfader-doctor, and postfader-plugin-report.

Only one process can own the IAC port at a time, so if you register the server at user scope, close any project-scoped copy of it first.

Enabling writes

Quit FL Studio, then launch it from Terminal with:

FL_BRIDGE_ENABLE_WRITES=1 open -a "FL Studio 2026"

The bridge reads this variable once when its script loads. In write mode, ping reports bridge_mode: "write_test" and verified_writes_enabled: true. Launch FL Studio normally to return to its read-only mode. Do not put FL_BRIDGE_ENABLE_WRITES in the MCP server's environment; it must be present in the FL Studio process.

Important limitations

• Plug-in insertion, removal, and reordering are unavailable through the public MIDI scripting backend. This does not mean those operations are impossible in FL Studio itself.
• Playback-speed control is not exposed because the public backend provides a setter but no authoritative getter for later-tick verification.
• Step reads observe up to 512 cells. Verified step writes refuse grids longer than 256 cells and enforce step_count + update_count + 8 <= 320 so the final digest check and batch stay atomic below the idle-tick call ceiling. A 256-cell grid therefore permits at most 56 updates per call; refresh the digest between split batches.
• FL Studio's scripted per-slot bypass and wet/dry setters are not reliable on the validated host and are not exposed as MCP tools.
• The bridge cannot render or access live audio; audio analysis requires a file on disk.
• Playlist selection endpoints are returned as raw observations and are marked unsafe for automated rendering.
• Unprofiled plug-in parameters are readable, but the bridge does not claim to know their musical meaning or whether a target value is appropriate.
• Readback verifies observed control movement, not audible correctness.
• The local IAC transport is shared and unauthenticated, and only one bridge client can own it at a time.

See FL Studio constraints for the technical details.

Privacy and security

The MCP server and bridge run locally and implement no telemetry or hosted service. Your MCP client may send tool arguments and results to its model provider; review that client's privacy policy.

Audio measurement tools can read an absolute audio-file path supplied by the MCP client. Results include measurements, a canonical path, and a file hash, but not the audio samples themselves. Recent-bounce discovery searches a bounded set of FL Studio output folders. Run the bridge only with a trusted MCP client on a trusted, single-user Mac. See SECURITY.md for the complete trust model.

Documentation

• Setup and usage
• Tool and command reference
• Capability and evidence matrix
• Deferred demo plan
• Plug-in support
• Validated plug-in matrix
• Architecture
• FL Studio constraints
• Security policy
• Contributing

Development

Run the hermetic safe suite with:

./.venv/bin/python scripts/run_safe_tests.py

The 0.12.0 release candidate runs 865 checks across 18 explicitly allowlisted test files. The safe suite uses a fake FL API and deterministic synthetic audio. It does not require FL Studio, a MIDI device, a user project, or user audio, and it does not touch the physical IAC bus.

Non-affiliation

FL Studio is a trademark of Image-Line Software. Postfader is an independent, unofficial project and is not affiliated with, endorsed by, or sponsored by Image-Line Software. FL Studio is not distributed with this repository.