add_fx
Adds audio effects plugins to tracks in REAPER, including master track support, using REAPER's FX browser naming conventions.
Instructions
Add an FX plugin to a track.
track_index: 0-based track index, or -1 for the master track
fx_name: any string REAPER's FX browser accepts ("ReaComp", "VST: Serum", etc.)
input_fx: True to add to the input FX chain
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes | ||
| fx_name | Yes | ||
| input_fx | No |
Implementation Reference
- src/reaper_mcp/reaper_adapter.py:266-277 (handler)The `add_fx` method in the `ReaperAdapter` class, which dispatches the call to the underlying bridge client.
def add_fx( self, track_index: int, fx_name: str, input_fx: bool = False, ) -> dict[str, Any]: return self._client.call( "add_fx", track_index=track_index, fx_name=fx_name, input_fx=input_fx, ) - src/reaper_mcp/server.py:478-492 (registration)The MCP tool registration and handler wrapper for `add_fx` in `server.py`.
def add_fx( track_index: int, fx_name: str, input_fx: bool = False, ) -> dict[str, Any]: """ Add an FX plugin to a track. - track_index: 0-based track index, or -1 for the master track - fx_name: any string REAPER's FX browser accepts ("ReaComp", "VST: Serum", etc.) - input_fx: True to add to the input FX chain """ try: return _wrap(adapter.add_fx(track_index=track_index, fx_name=fx_name, input_fx=input_fx)) except Exception as exc: return _err(exc)