list_fx
Retrieve all FX plugins on a track in REAPER, including name, index, parameter count, and enabled status. Use track_index=-1 for the master track.
Instructions
List all FX plugins on a track (name, fx_index, n_params, enabled). Use track_index=-1 for the master track.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/reaper_mcp/server.py:495-502 (handler)MCP tool registration and handler for listing FX on a track.
@mcp.tool() def list_fx(track_index: int) -> dict[str, Any]: """List all FX plugins on a track (name, fx_index, n_params, enabled). Use track_index=-1 for the master track.""" try: return _wrap(adapter.list_fx(track_index=track_index)) except Exception as exc: return _err(exc) - Adapter method that calls the bridge client to retrieve FX list.
def list_fx(self, track_index: int) -> list[dict[str, Any]]: return self._client.call("list_fx", track_index=track_index)