add_master_fx
Add a specified FX plugin to the master track for global audio processing in REAPER.
Instructions
Add an FX plugin to the master track.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fx_name | Yes |
Implementation Reference
- src/reaper_mcp/mastering_tools.py:21-32 (handler)The add_master_fx tool implementation: adds an FX plugin to the master track using reapy, returns success/failure with fx_index, name, and n_params.
def add_master_fx(fx_name: str) -> dict: """Add an FX plugin to the master track.""" try: project = get_project() master = project.master_track fx_index = master.add_fx(fx_name) if fx_index < 0: return {"success": False, "error": f"Plugin not found: '{fx_name}'"} fx = master.fxs[fx_index] return {"success": True, "fx_index": fx_index, "name": fx.name, "n_params": fx.n_params} except Exception as e: return {"success": False, "error": str(e)} - src/reaper_mcp/mastering_tools.py:18-20 (registration)Registration of add_master_fx via @mcp.tool() decorator inside register_tools(mcp).
def register_tools(mcp): @mcp.tool() - src/reaper_mcp/server.py:17-28 (registration)Server imports and calls register_tools from mastering_tools module to register all mastering tools including add_master_fx.
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) _reg_audio(mcp) _reg_mixing(mcp) _reg_render(mcp) _reg_mastering(mcp) _reg_analysis(mcp) - src/reaper_mcp/connection.py:27-29 (helper)Helper function used by add_master_fx to get the current REAPER project via reapy.
def get_project() -> reapy.Project: ensure_connected() return reapy.Project()