add_fx
Add VST, VSTi, and AU plugins to REAPER tracks. Insert instruments and effects like ReaEQ or ReaComp by specifying track index and exact plugin name for AI-driven production.
Instructions
Add an FX plugin to a track. Works for both instruments (VSTi) and effects (VST/AU). Use the exact plugin name as shown in REAPER's FX browser. Built-in Cockos plugins: ReaEQ, ReaComp, ReaDelay, ReaVerb, ReaLimit, ReaSynth, ReaSamplOmatic5000, ReaTune, ReaGate, ReaFIR, ReaXcomp.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes | ||
| fx_name | Yes |
Implementation Reference
- src/reaper_mcp/fx_tools.py:14-37 (handler)The add_fx tool handler implementation. Adds an FX plugin to a track by index. Takes track_index (int) and fx_name (str) as parameters, returns a dict with success status, fx_index, name, n_params, and track_index. Uses reapy to interact with REAPER's API.
def add_fx(track_index: int, fx_name: str) -> dict: """ Add an FX plugin to a track. Works for both instruments (VSTi) and effects (VST/AU). Use the exact plugin name as shown in REAPER's FX browser. Built-in Cockos plugins: ReaEQ, ReaComp, ReaDelay, ReaVerb, ReaLimit, ReaSynth, ReaSamplOmatic5000, ReaTune, ReaGate, ReaFIR, ReaXcomp. """ try: project = get_project() track = project.tracks[track_index] fx_index = track.add_fx(fx_name) if fx_index < 0: return {"success": False, "error": f"Plugin not found: '{fx_name}'"} fx = track.fxs[fx_index] return { "success": True, "fx_index": fx_index, "name": fx.name, "n_params": fx.n_params, "track_index": track_index, } except Exception as e: logger.error(f"add_fx failed: {e}") return {"success": False, "error": str(e)} - src/reaper_mcp/fx_tools.py:14-20 (schema)The schema for add_fx is defined implicitly through Python type hints and docstring. Input: track_index (int), fx_name (str). Output: dict with success, fx_index, name, n_params, track_index.
def add_fx(track_index: int, fx_name: str) -> dict: """ Add an FX plugin to a track. Works for both instruments (VSTi) and effects (VST/AU). Use the exact plugin name as shown in REAPER's FX browser. Built-in Cockos plugins: ReaEQ, ReaComp, ReaDelay, ReaVerb, ReaLimit, ReaSynth, ReaSamplOmatic5000, ReaTune, ReaGate, ReaFIR, ReaXcomp. """ - src/reaper_mcp/server.py:13-23 (registration)Registration of fx_tools module. The register_tools function from fx_tools is imported as _reg_fx and called with the mcp instance at line 23.
from reaper_mcp.fx_tools import register_tools as _reg_fx from reaper_mcp.audio_tools import register_tools as _reg_audio from reaper_mcp.mixing_tools import register_tools as _reg_mixing from reaper_mcp.render_tools import register_tools as _reg_render from reaper_mcp.mastering_tools import register_tools as _reg_mastering from reaper_mcp.analysis_tools import register_tools as _reg_analysis _reg_project(mcp) _reg_track(mcp) _reg_midi(mcp) _reg_fx(mcp)