list_track_fx
Retrieve all FX plugins applied to a specific track in REAPER by providing the track index. Use this tool to inspect or manage audio effects on individual tracks.
Instructions
List all FX plugins on a track.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes |
Implementation Reference
- src/reaper_mcp/fx_tools.py:102-119 (handler)The actual handler function for the 'list_track_fx' tool. It takes a track_index, iterates over all FX plugins on that track, and returns their index, name, enabled status, and parameter count.
@mcp.tool() def list_track_fx(track_index: int) -> dict: """List all FX plugins on a track.""" try: project = get_project() track = project.tracks[track_index] fx_list = [] for i in range(track.n_fxs): fx = track.fxs[i] fx_list.append({ "index": i, "name": fx.name, "enabled": fx.is_enabled, "n_params": fx.n_params, }) return {"success": True, "track_index": track_index, "fx": fx_list} except Exception as e: return {"success": False, "error": str(e)} - src/reaper_mcp/fx_tools.py:102-103 (registration)The tool is registered via the @mcp.tool() decorator on the list_track_fx function inside register_tools(mcp).
@mcp.tool() def list_track_fx(track_index: int) -> dict: - src/reaper_mcp/fx_tools.py:103-103 (schema)Input schema: track_index (int). Output schema: dict with success bool, track_index int, fx list (each with index, name, enabled, n_params).
def list_track_fx(track_index: int) -> dict: - src/reaper_mcp/server.py:23-23 (registration)The fx_tools module's register_tools is called via _reg_fx(mcp) in server.py, which registers all tools including list_track_fx.
_reg_fx(mcp)