analyze_master_loudness
Measure the integrated, short-term, and momentary loudness of your master mix within a specified time range using a non-destructive render. Returns LUFS and true peak values for audio mastering.
Instructions
Measure the loudness of the full master mix over a time range using a non-destructive dry-run render (action 42441). No tracks or files are created. Returns:
lufs_i: integrated loudness in LUFS
lufs_s_max: maximum short-term loudness in LUFS
lufs_m_max: maximum momentary loudness in LUFS
true_peak_db: true peak in dBTP
raw_stats: raw key=value string from REAPER for any additional fields
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"start_time": "<start_time>",
"end_time": "<end_time>"
},
"name": "analyze_master_loudness"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start_time | Yes | ||
| end_time | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/reaper_mcp/server.py:727-745 (handler)The MCP tool registration and handler entry point for 'analyze_master_loudness'.
@mcp.tool() def analyze_master_loudness( start_time: float, end_time: float, ) -> dict[str, Any]: """ Measure the loudness of the full master mix over a time range using a non-destructive dry-run render (action 42441). No tracks or files are created. Returns: - lufs_i: integrated loudness in LUFS - lufs_s_max: maximum short-term loudness in LUFS - lufs_m_max: maximum momentary loudness in LUFS - true_peak_db: true peak in dBTP - raw_stats: raw key=value string from REAPER for any additional fields """ try: return _wrap(adapter.analyze_master_loudness(start_time=start_time, end_time=end_time)) except Exception as exc: return _err(exc) - The adapter implementation that forwards the 'analyze_master_loudness' call to the REAPER client.
def analyze_master_loudness(self, start_time: float, end_time: float) -> dict[str, Any]: return self._client.call("analyze_master_loudness", start_time=start_time, end_time=end_time)