set_send_volume
Adjust the volume of a specific audio send in decibels by defining the source track index, send index, and target volume level.
Instructions
Set the volume of a send in dB.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source_track_index | Yes | ||
| send_index | Yes | ||
| volume_db | Yes |
Implementation Reference
- src/reaper_mcp/mixing_tools.py:121-135 (handler)The main tool handler for set_send_volume. Converts dB to linear using _db_to_linear helper and sets the send volume via RPR.SetTrackSendInfo_Value.
@mcp.tool() def set_send_volume(source_track_index: int, send_index: int, volume_db: float) -> dict: """Set the volume of a send in dB.""" try: project = get_project() track = project.tracks[source_track_index] RPR.SetTrackSendInfo_Value(track.id, 0, send_index, "D_VOL", _db_to_linear(volume_db)) return { "success": True, "source_track_index": source_track_index, "send_index": send_index, "volume_db": volume_db, } except Exception as e: return {"success": False, "error": str(e)} - src/reaper_mcp/mixing_tools.py:17-17 (registration)Registration entry point: mixing_tools.register_tools() is called from server.py, which registers all @mcp.tool() decorated functions including set_send_volume.
def register_tools(mcp): - src/reaper_mcp/server.py:15-25 (registration)server.py imports mixing_tools.register_tools and calls it with the mcp instance to register all mixing tools.
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) _reg_audio(mcp) _reg_mixing(mcp) - src/reaper_mcp/mixing_tools.py:11-14 (helper)Helper function used by set_send_volume to convert decibel values to linear scale for REAPER's API.
def _db_to_linear(db: float) -> float: if db <= -150: return 0.0 return 10 ** (db / 20.0) - src/reaper_mcp/connection.py:27-29 (helper)Helper used by set_send_volume to get the REAPER project connection.
def get_project() -> reapy.Project: ensure_connected() return reapy.Project()