list_fx_presets
Retrieve available presets for an existing track effect, including factory presets and saved preset files, to streamline audio effect management in REAPER.
Instructions
List available presets for an FX already on a track. Returns two lists:
factory_presets: presets exposed by the plugin itself (CLAP, VST3, VST2 banks). Each entry has {index, name, source='factory'}. These can be loaded by name with set_fx_preset().
file_presets: .ffp/.fxp files found on disk under standard vendor preset dirs. Each entry has {name, category, path, source='file'}. Load via the 'path' field.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes | ||
| fx_index | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/reaper_mcp/server.py:584-600 (handler)The tool handler for 'list_fx_presets' which is registered with FastMCP.
@mcp.tool() def list_fx_presets( track_index: int, fx_index: int ) -> dict[str, Any]: """ List available presets for an FX already on a track. Returns two lists: - factory_presets: presets exposed by the plugin itself (CLAP, VST3, VST2 banks). Each entry has {index, name, source='factory'}. These can be loaded by name with set_fx_preset(). - file_presets: .ffp/.fxp files found on disk under standard vendor preset dirs. Each entry has {name, category, path, source='file'}. Load via the 'path' field. """ try: return _wrap(adapter.list_fx_presets(track_index=track_index, fx_index=fx_index)) except Exception as exc: return _err(exc) - src/reaper_mcp/reaper_adapter.py:330-337 (handler)The underlying adapter method that calls the bridge client to list FX presets in REAPER.
def list_fx_presets( self, track_index: int, fx_index: int ) -> dict[str, Any]: return self._client.call( "list_fx_presets", track_index=track_index, fx_index=fx_index, )