set_master_volume
Adjust master track output volume in dB. Set the final mix level to a specific dB value.
Instructions
Set the master track output volume in dB.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| volume_db | Yes |
Implementation Reference
- src/reaper_mcp/mastering_tools.py:66-75 (handler)The tool handler that sets the master track volume by assigning volume_db to master.volume via reapy, returning success or error.
@mcp.tool() def set_master_volume(volume_db: float) -> dict: """Set the master track output volume in dB.""" try: project = get_project() master = project.master_track master.volume = volume_db return {"success": True, "volume_db": master.volume} except Exception as e: return {"success": False, "error": str(e)} - Input schema: expects a float parameter volume_db (dB value). Returns a dict.
def set_master_volume(volume_db: float) -> dict: - src/reaper_mcp/server.py:17-27 (registration)Registration: mastering_tools.register_tools is imported and called with the mcp FastMCP instance, which uses the @mcp.tool() decorator to register set_master_volume.
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) - src/reaper_mcp/connection.py:27-29 (helper)Helper that ensures REAPER connection and returns a reapy.Project object, used by set_master_volume to access the master track.
def get_project() -> reapy.Project: ensure_connected() return reapy.Project()