remove_fx
Eliminate unwanted FX plugins from REAPER tracks by specifying the track and FX index. Maintain an organized mixing environment with targeted removal.
Instructions
Remove an FX plugin from a track by its index.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes | ||
| fx_index | Yes |
Implementation Reference
- src/reaper_mcp/fx_tools.py:39-49 (handler)The remove_fx tool handler. It takes a track_index and fx_index, looks up the FX name, then calls RPR.TrackFX_Delete to remove the FX plugin from the track. Returns success/failure dictionary.
@mcp.tool() def remove_fx(track_index: int, fx_index: int) -> dict: """Remove an FX plugin from a track by its index.""" try: project = get_project() track = project.tracks[track_index] fx_name = track.fxs[fx_index].name RPR.TrackFX_Delete(track.id, fx_index) return {"success": True, "track_index": track_index, "removed": fx_name} except Exception as e: return {"success": False, "error": str(e)} - src/reaper_mcp/fx_tools.py:11-11 (registration)The register_tools function is where @mcp.tool() decorates remove_fx, registering it as an MCP tool.
def register_tools(mcp): - src/reaper_mcp/fx_tools.py:40-41 (schema)The input schema for remove_fx: accepts track_index (int) and fx_index (int). Returns a dict with success/error or success, track_index, removed (fx name).
def remove_fx(track_index: int, fx_index: int) -> dict: """Remove an FX plugin from a track by its index.""" - src/reaper_mcp/server.py:13-13 (registration)Import of register_tools from fx_tools module (aliased as _reg_fx) into the server.
from reaper_mcp.fx_tools import register_tools as _reg_fx - src/reaper_mcp/server.py:23-23 (registration)Invocation of _reg_fx(mcp) which registers all FX tools including remove_fx.
_reg_fx(mcp)