{"report":"{\"v\":1,\"package\":\"@mthines/reaper-mcp\",\"version\":\"0.98.0\",\"ranAt\":\"2026-11-16T11:31:41.828Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-col8ePO3X8CVc7M93dzvteeO4UQOZzlS15Z/zOxwWd/ZtiZpvLEgpl7w4tdvHgh0CkQuhU9UoP4CSSNQ7+J4ag==\",\"deps\":320,\"scripts\":[\"protobufjs\"],\"bins\":[\"reaper-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=20.0.0\",\"repository\":\"https://github.com/mthines/reaper-mcp.git\",\"bin\":\"reaper-mcp\"},\"start\":{\"ok\":true,\"ms\":540,\"serverName\":\"reaper-mcp\",\"serverVersion\":\"0.1.0\",\"protocol\":\"2025-06-18\",\"stderr\":\",\\\"msg\\\":\\\"Bridge command get_project_info not sent: the bridge is not running (no_reaper)\\\",\\\"event\\\":\\\"reaper.bridge.command.not_sent\\\",\\\"rpc.method\\\":\\\"get_project_info\\\",\\\"error.type\\\":\\\"bridge_not_running\\\",\\\"reaper.bridge.state\\\":\\\"no_reaper\\\",\\\"trace_id\\\":\\\"87969c18671afd157742612fd7efc18f\\\",\\\"span_id\\\":\\\"5b3eddf7cdd7f882\\\"}\\n{\\\"level\\\":\\\"warn\\\",\\\"msg\\\":\\\"Bridge command get_render_settings not sent: the bridge is not running (no_reaper)\\\",\\\"event\\\":\\\"reaper.bridge.command.not_sent\\\",\\\"rpc.method\\\":\\\"get_render_settings\\\",\\\"error.type\\\":\\\"bridge_not_running\\\",\\\"reaper.bridge.state\\\":\\\"no_reaper\\\",\\\"trace_id\\\":\\\"d612d2ec2b55e9bf31c757996df7c4ee\\\",\\\"span_id\\\":\\\"c2ae7d3d4c6d85c6\\\"}\\n{\\\"level\\\":\\\"warn\\\",\\\"msg\\\":\\\"Bridge command get_project_settings not sent: the bridge is not running (no_reaper)\\\",\\\"event\\\":\\\"reaper.bridge.command.not_sent\\\",\\\"rpc.method\\\":\\\"get_project_settings\\\",\\\"error.type\\\":\\\"bridge_not_running\\\",\\\"reaper.bridge.state\\\":\\\"no_reaper\\\",\\\"trace_id\\\":\\\"06792181e83dbdd9ab78568a4253de02\\\",\\\"span_id\\\":\\\"21b76d910be5f0d0\\\"}\\n{\\\"level\\\":\\\"warn\\\",\\\"msg\\\":\\\"Bridge command list_tracks not sent: the bridge is not running (no_reaper)\\\",\\\"event\\\":\\\"reaper.bridge.command.not_sent\\\",\\\"rpc.method\\\":\\\"list_tracks\\\",\\\"error.type\\\":\\\"bridge_not_running\\\",\\\"reaper.bridge.state\\\":\\\"no_reaper\\\",\\\"trace_id\\\":\\\"595bfbd8e2b301bd3279a713efa2227e\\\",\\\"span_id\\\":\\\"5b936d0c5806cdd8\\\"}\\n{\\\"level\\\":\\\"warn\\\",\\\"msg\\\":\\\"Bridge command get_transport_state not sent: the bridge is not running (no_reaper)\\\",\\\"event\\\":\\\"reaper.bridge.command.not_sent\\\",\\\"rpc.method\\\":\\\"get_transport_state\\\",\\\"error.type\\\":\\\"bridge_not_running\\\",\\\"reaper.bridge.state\\\":\\\"no_reaper\\\",\\\"trace_id\\\":\\\"8ddf0c6619a23cf9281c21780b1d3e75\\\",\\\"span_id\\\":\\\"04526a4e3eb8a663\\\"}\\n\"},\"tools\":[{\"name\":\"get_project_info\",\"description\":\"Get current REAPER project info: name, track count, tempo, time signature, sample rate, transport state\",\"params\":[]},{\"name\":\"undo_project\",\"description\":\"Undo the last undo point in the REAPER project (any edit, including ones made by these tools) and report its label, plus the next undo/redo labels.\",\"params\":[]},{\"name\":\"redo_project\",\"description\":\"Redo the last undone edit in the REAPER project and report its label, plus the next undo/redo labels.\",\"params\":[]},{\"name\":\"save_project\",\"description\":\"Save the REAPER project. Without a path, saves it where it already lives. With path (an absolute .rpp file in an existing directory) it writes a copy there: the open project keeps its own path (savedAsCopy: true), so a never-saved project stays unsaved. Never opens a dialog: a never-saved project without path is refused; an existing different file is refused unless overwrite is true.\",\"params\":[\"path\",\"overwrite\"]},{\"name\":\"get_render_settings\",\"description\":\"Get the project render settings: output directory, file name pattern, format with its bit depth or MP3 bitrate, secondary format, source (master, stems, selected items, region matrix with its rows), bounds (custom/project/time_selection/…), custom start/end, sample rate (0 = project rate), channels, dither and noise shaping, loudness normalization and limiter, embedded metadata, and the target files a render would write.\",\"params\":[]},{\"name\":\"set_render_settings\",\"description\":\"Set any of the project render settings; returns them as read back. All fields are validated before any is written, so an invalid request changes nothing. Covers what is rendered (source: master, stems of the selected tracks, master + stems, selected tracks via the master, the selected media items alone or through the master, the region render matrix), the encoding (bit depth, MP3 bitrate, dither), loudness normalization with a limiter, and embedded metadata.\",\"params\":[\"outputDirectory\",\"filePattern\",\"format\",\"secondaryFormat\",\"source\",\"regionMatrix\",\"bounds\",\"startTime\",\"endTime\",\"sampleRate\",\"channels\",\"bitDepth\",\"mp3Bitrate\",\"dither\",\"noiseShaping\",\"normalize\",\"normalizeTarget\",\"normalizeOnlyTooLoud\",\"limit\",\"limitCeiling\",\"limitTruePeak\",\"metadata\",\"metadataRaw\",\"embedMetadata\"]},{\"name\":\"render_project\",\"description\":\"Render the project with its current render settings (set them with set_render_settings) and return the files written, each measured: duration, integrated LUFS, true peak and sample peak. Synchronous: REAPER is busy until the render finishes, so keep renders short. Refused when a target file already exists (REAPER would ask) unless overwrite is true, when bounds is time_selection with no time selection, and when the format or secondary format is an encoder outside wav/aiff/flac/mp3/ogg/opus (they can open a dialog).\",\"params\":[\"overwrite\",\"tracks\",\"analyze\"]},{\"name\":\"render_versions\",\"description\":\"Render alternate versions in one call (instrumental, a cappella, TV mix, clean): for each version the listed tracks are muted on top of the current mutes, the file pattern gets \\\"-<name>\\\" (or the version's own filePattern), and the project renders with the current settings. Every track, name and target is checked before the first render; mutes and the file pattern are restored afterwards, also when a render fails. Each file comes back measured like render_project.\",\"params\":[\"versions\",\"overwrite\",\"analyze\"]},{\"name\":\"get_project_settings\",\"description\":\"Get project settings: path, sample rate and whether it is forced, title, author, notes, repeat (loop playback), and metronome (a global REAPER option).\",\"params\":[]},{\"name\":\"set_project_settings\",\"description\":\"Set any of: sampleRate, useProjectSampleRate, title, author, notes, repeat, metronome. Returns the settings as read back. metronome is a global REAPER option (it is not stored in the project and undo does not revert it). Invalid values change nothing.\",\"params\":[\"sampleRate\",\"useProjectSampleRate\",\"title\",\"author\",\"notes\",\"repeat\",\"metronome\"]},{\"name\":\"list_tracks\",\"description\":\"List tracks in the current REAPER project with name, index, volume, mute/solo state, and folder structure. In large sessions filter it: parent (a folder track — returns everything inside it), nameContains, compact (index, name, parentIndex, depth, volume, pan, mute, solo, fxCount only), offset/limit. With no params it returns every track as before; with any, it returns { total, offset, returned, hasMore, tracks }.\",\"params\":[\"parent\",\"nameContains\",\"compact\",\"offset\",\"limit\"]},{\"name\":\"get_track_properties\",\"description\":\"Get detailed properties of a specific track including volume, pan, mute, solo, and FX chain\",\"params\":[\"trackIndex\"]},{\"name\":\"set_track_property\",\"description\":\"Set a track property: volume (dB), pan (-1.0 to 1.0), mute/solo/recordArm/phase (0/1), input (REAPER input index), playOffsetMs (track playback offset in ms, negative = earlier; use with measure_track_alignment)\",\"params\":[\"trackIndex\",\"property\",\"value\"]},{\"name\":\"add_fx\",\"description\":\"Add an FX plugin to a track by name (e.g. \\\"ReaEQ\\\", \\\"JS: Schwa's Spectral Analyzer\\\", \\\"VST: Pro-Q 3\\\")\",\"params\":[\"trackIndex\",\"fxName\",\"position\"]},{\"name\":\"remove_fx\",\"description\":\"Remove an FX plugin from a track by its index in the FX chain\",\"params\":[\"trackIndex\",\"fxIndex\"]},{\"name\":\"get_fx_parameters\",\"description\":\"List parameters of an FX plugin with current values and ranges. Supports filtering by name pattern, changed-only filter, and pagination. For a quick summary of active EQ bands or compressor settings, use analyze_fx instead.\",\"params\":[\"trackIndex\",\"fxIndex\",\"namePattern\",\"changedOnly\",\"offset\",\"limit\"]},{\"name\":\"analyze_fx\",\"description\":\"Analyze an FX plugin and return a compact summary: FX name, preset, and notable (non-default) parameters. For EQ plugins, detects active bands with frequency/gain/Q/shape. For compressors, extracts threshold/ratio/attack/release/makeup. Use this before get_fx_parameters to understand what a plugin is doing without reading 500+ parameters.\",\"params\":[\"trackIndex\",\"fxIndex\"]},{\"name\":\"set_fx_parameter\",\"description\":\"Set a specific FX parameter value (normalized 0.0–1.0 for most plugins; use the parameter maxValue from get_fx_parameters when it is above 1)\",\"params\":[\"trackIndex\",\"fxIndex\",\"paramIndex\",\"value\"]},{\"name\":\"set_fx_enabled\",\"description\":\"Enable or disable (bypass) an FX plugin on a track\",\"params\":[\"trackIndex\",\"fxIndex\",\"enabled\"]},{\"name\":\"set_fx_offline\",\"description\":\"Set an FX plugin online or offline. Offline FX uses no CPU but preserves settings.\",\"params\":[\"trackIndex\",\"fxIndex\",\"offline\"]},{\"name\":\"read_track_meters\",\"description\":\"Read real-time peak and RMS levels (in dB) for a track. Returns L/R peak and RMS values.\",\"params\":[\"trackIndex\"]},{\"name\":\"read_track_spectrum\",\"description\":\"Read the real-time frequency spectrum of a track while audio plays. Auto-inserts the MCP Spectrum Analyzer JSFX if not present. Returns 1/3-octave bands (25 Hz-16 kHz, ~0.5 s smoothed), each with raw `db` and K-weighted `kDb` (the BS.1770 weighting LUFS uses). Judge on `kDb`, never `db` (raw levels overstate the lows and understate 2-5 kHz), and compare a band only with the same band on another track or a reference. Pre-fader (the analyzer sits in the track FX chain); each read is a ~0.5 s snapshot, so read several times. Raw FFT bins only with includeBins.\",\"params\":[\"trackIndex\",\"fftSize\",\"includeBins\"]},{\"name\":\"play\",\"description\":\"Start playback in REAPER\",\"params\":[]},{\"name\":\"stop\",\"description\":\"Stop playback/recording in REAPER\",\"params\":[]},{\"name\":\"record\",\"description\":\"Start recording in REAPER. Refused when no track is armed (REAPER would open a dialog that blocks the bridge): arm the target tracks first with set_track_record\",\"params\":[]},{\"name\":\"get_transport_state\",\"description\":\"Get current transport state: play/record/pause status, cursor positions, tempo, time signature\",\"params\":[]},{\"name\":\"set_cursor_position\",\"description\":\"Move the edit cursor to a specific position in seconds from project start\",\"params\":[\"position\"]},{\"name\":\"list_available_fx\",\"description\":\"Enumerate all installed FX plugins in REAPER (VST, VST3, JS, CLAP, AU) with an optional category filter\",\"params\":[\"category\"]},{\"name\":\"search_fx\",\"description\":\"Search installed FX plugins by name (case-insensitive substring match)\",\"params\":[\"query\"]},{\"name\":\"get_fx_preset_list\",\"description\":\"List all available presets for a specific FX plugin on a track. Reads names by loading each preset, then restores the FX state; a MIDI plugin (e.g. ReaControlMIDI) may send each preset's messages while listing. Lists over 256 (generic program slots) are not enumerated (truncated: true).\",\"params\":[\"trackIndex\",\"fxIndex\"]},{\"name\":\"set_fx_preset\",\"description\":\"Apply a named preset to an FX plugin on a track\",\"params\":[\"trackIndex\",\"fxIndex\",\"presetName\"]},{\"name\":\"snapshot_save\",\"description\":\"Save the current mixer state as a named snapshot. Stored in .reaper-mcp/snapshots/ alongside the project file (falls back to global bridge dir for unsaved projects). By default captures ALL tracks' volumes, pans, mutes, solos, FX bypass/offline states, full FX parameter values, preset names, track names/colors, and send levels. Pass trackIndices to scope the snapshot to specific tracks (e.g. just the master bus for an A/B that never touches other tracks). Pass fullChunk (or rely on its default-on when scoped) to capture exact track state chunks, which faithfully reproduce each plugin's internal state on restore — including plugins whose tone is driven by internal snapshots (e.g. Helix Native) that parameter-value capture cannot reproduce. Pass stretchMarkers to also keep the stretch markers of every audio item on the captured tracks (an alignment or a stretch edit): they are stored on their own, so they come back even where REAPER refuses to apply a track chunk (seen on tracks whose items carry Melodyne take FX). A fullChunk snapshot also holds each track's items (the whole chunk comes back on restore); without fullChunk a snapshot holds no items, only the stretch markers when asked for. Response includes storageLocation, scoped, fullChunk, tracksCaptured, and stretchMarkerItems.\",\"params\":[\"name\",\"description\",\"includeFxParams\",\"maxParamsPerFx\",\"trackIndices\",\"fullChunk\",\"stretchMarkers\"]},{\"name\":\"snapshot_restore\",\"description\":\"Restore a previously saved mixer snapshot by name. Reads from .reaper-mcp/snapshots/ alongside the project file (falls back to global bridge dir for unsaved projects). For chunk-based snapshots (saved with fullChunk), restores each captured track exactly via its state chunk — reproducing complete FX internal state (incl. plugin internal snapshots like Helix Native) and affecting only the tracks the snapshot captured. For parameter-based snapshots, restores volumes, pans, mutes, solos, FX bypass states, and FX parameters (parameters only when the plugin name matches, to avoid applying wrong values). Stretch markers saved with the snapshot are put back on their items afterwards, also when a track chunk could not be applied (the reply field stretchMarkers counts restored, unchanged and missing items).\",\"params\":[\"name\",\"restoreTrackMeta\",\"restoreSendLevels\",\"restoreStretchMarkers\"]},{\"name\":\"snapshot_list\",\"description\":\"List all saved mixer snapshots for the current project. Reads from .reaper-mcp/snapshots/ alongside the project file (falls back to global bridge dir for unsaved projects). Response includes storageLocation (\\\"project\\\" or \\\"global\\\").\",\"params\":[]},{\"name\":\"snapshot_delete\",\"description\":\"Delete a named mixer snapshot. Removes the snapshot file from .reaper-mcp/snapshots/ alongside the project file (or global bridge dir for unsaved projects). This action is permanent and cannot be undone.\",\"params\":[\"name\"]},{\"name\":\"snapshot_edit\",\"description\":\"Rename a mixer snapshot and/or change its description. The saved mixer state is kept. A new name whose file belongs to another snapshot is refused.\",\"params\":[\"name\",\"newName\",\"description\"]},{\"name\":\"get_track_routing\",\"description\":\"Get sends, receives, and parent/folder information for a track — useful for understanding bus structure\",\"params\":[\"trackIndex\"]},{\"name\":\"add_send\",\"description\":\"Send one track to another (a bus, a reverb return, or a sidechain input). For a sidechain use mode \\\"pre-fx\\\" and destChannel 3; the destination is widened to 4 channels if needed. Tracks reach the master through their master send (set_track_info masterSend), not through add_send. Returns the new send as get_track_routing reports it.\",\"params\":[\"from\",\"to\",\"volume\",\"pan\",\"mute\",\"mode\",\"srcChannel\",\"destChannel\"]},{\"name\":\"add_hardware_output\",\"description\":\"Route a track straight to an audio interface output (outputChannel is 1-based; mono uses one channel).\",\"params\":[\"track\",\"outputChannel\",\"mono\",\"volume\",\"pan\",\"mute\",\"mode\"]},{\"name\":\"set_send\",\"description\":\"Change a send, receive or hardware output by its index (as get_track_routing reports it). Only the given fields change.\",\"params\":[\"track\",\"category\",\"index\",\"volume\",\"pan\",\"mute\",\"mode\",\"srcChannel\",\"destChannel\",\"outputChannel\",\"mono\"]},{\"name\":\"remove_send\",\"description\":\"Remove a send, receive or hardware output by its index. Removing a receive removes the other track's send.\",\"params\":[\"track\",\"category\",\"index\"]},{\"name\":\"add_track\",\"description\":\"Insert a new track (default: at the end). Returns its index, name and GUID.\",\"params\":[\"name\",\"index\"]},{\"name\":\"delete_track\",\"description\":\"Delete a track with its items, FX and routing (undoable with Ctrl+Z). The master track cannot be deleted. Later tracks move up one index.\",\"params\":[\"track\"]},{\"name\":\"move_track\",\"description\":\"Move a track to a new 0-based position; the other tracks shift around it. The user's track selection is kept.\",\"params\":[\"track\",\"toIndex\"]},{\"name\":\"set_track_folder\",\"description\":\"Make a track a folder parent, the last track of a folder, or a normal track; optionally collapse the folder. Folders nest by position: tracks after a folder parent belong to it until a track marked \\\"last\\\".\",\"params\":[\"track\",\"mode\",\"depth\",\"collapsed\"]},{\"name\":\"set_track_info\",\"description\":\"Rename, color, set the channel count, or switch the master/parent send of a track. Everything is validated before anything is written.\",\"params\":[\"track\",\"name\",\"color\",\"channels\",\"masterSend\"]},{\"name\":\"set_track_group\",\"description\":\"Put a track in (or take it out of) a REAPER track group with given roles. Roles: volume_lead/follow, vca_lead/follow, pan_lead/follow, mute_lead/follow, solo_lead/follow, recarm_lead/follow, polarity_lead/follow, automode_lead/follow. A VCA: one track vca_lead, the others vca_follow.\",\"params\":[\"track\",\"group\",\"roles\",\"enable\"]},{\"name\":\"read_track_lufs\",\"description\":\"Read ITU-R BS.1770 loudness data for a track. Auto-inserts the MCP LUFS Meter JSFX if not present. Returns integrated, short-term (3s), and momentary (400ms) LUFS plus true inter-sample peak levels. Audio must be playing to accumulate data. The meter sits in the track FX chain, so it reads pre-fader: add the track volume (dB) for its level in the mix. Compare tracks in LU against the mix bus over the same section.\",\"params\":[\"trackIndex\",\"targetLufs\"]},{\"name\":\"read_track_correlation\",\"description\":\"Read stereo field correlation and M/S analysis for a track. Auto-inserts the MCP Correlation Meter JSFX if not present. Returns correlation coefficient (-1 to +1), stereo width, and mid/side levels. Audio must be playing to accumulate data.\",\"params\":[\"trackIndex\"]},{\"name\":\"read_track_crest\",\"description\":\"Read crest factor (peak-to-RMS ratio) for a track. Auto-inserts the MCP Crest Factor Meter JSFX if not present. Returns crest factor in dB (higher = more dynamic, lower = over-compressed), peak hold level, and RMS level. Audio must be playing to accumulate data.\",\"params\":[\"trackIndex\"]},{\"name\":\"measure_tracks\",\"description\":\"Play audio and collect analysis measurements (LUFS, crest factor, correlation, spectrum) for one or more tracks in a single call. Handles playback start/stop automatically. LUFS and spectrum (1/3-octave bands) support multi-track; crest/correlation use global gmem and are only reliable for single-track measurement. First call may be slower due to JSFX meter auto-insertion. Readings are pre-fader (meters sit in each track FX chain): add each track volume to compare tracks; a folder/bus reads its children post-fader. Use this to balance tracks in LU and compare spectra on `kDb`. Afterwards it removes the MCP meters on the measured tracks (also ones an earlier call left) unless keepMeters. A meter that received no audio (muted, frozen or silent track, nothing in range) is reported under errors, not as numbers. For whole-song, folder or master numbers without playback, prefer analyze_track_offline.\",\"params\":[\"trackIndices\",\"metrics\",\"durationSeconds\",\"startPosition\",\"fftSize\",\"stopWhenDone\",\"targetLufs\",\"keepMeters\"]},{\"name\":\"create_midi_item\",\"description\":\"Create an empty MIDI item on a track at a given time range (seconds). Use this before inserting notes.\",\"params\":[\"trackIndex\",\"startPosition\",\"endPosition\"]},{\"name\":\"list_midi_items\",\"description\":\"List all MIDI items on a track with position, length, and note/CC counts. ccCount counts CC messages only; channelEventCount and channelEventCounts include pitch bend, program change and pressure events\",\"params\":[\"trackIndex\"]},{\"name\":\"get_midi_notes\",\"description\":\"Get MIDI notes in a MIDI item. Supports pagination with offset/limit for large items. For a high-level overview of a large MIDI item, use analyze_midi instead. Returns pitch (0-127, 60=C4), velocity (0-127), position and duration in beats from item start.\",\"params\":[\"trackIndex\",\"itemIndex\",\"offset\",\"limit\"]},{\"name\":\"analyze_midi\",\"description\":\"Analyze a MIDI item and return summary statistics computed in REAPER. Much more efficient than get_midi_notes for large items. Returns per-pitch stats (count, velocity min/max/avg/stddev), velocity histogram, and machine gun detection (consecutive identical velocities). Use this first to understand the MIDI data before reading individual notes.\",\"params\":[\"trackIndex\",\"itemIndex\"]},{\"name\":\"insert_midi_note\",\"description\":\"Insert a single MIDI note. Pitch: 0-127 (60=C4/Middle C, 48=C3, 72=C5). Velocity: 1-127 (64=medium, 100=strong, 127=max). Position/duration in beats from item start (1.0=quarter, 0.5=eighth, 0.25=sixteenth).\",\"params\":[\"trackIndex\",\"itemIndex\",\"pitch\",\"velocity\",\"startPosition\",\"duration\",\"channel\"]},{\"name\":\"insert_midi_notes\",\"description\":\"Batch insert multiple MIDI notes in a single call. Pass a native array of note objects. Each note: { pitch, velocity, startPosition, duration, channel? }. Positions/durations in beats from item start (1.0=quarter, 0.5=eighth).\",\"params\":[\"trackIndex\",\"itemIndex\",\"notes\"]},{\"name\":\"edit_midi_note\",\"description\":\"Edit an existing MIDI note by index. Only provided fields are changed. Positions/durations in beats from item start.\",\"params\":[\"trackIndex\",\"itemIndex\",\"noteIndex\",\"pitch\",\"velocity\",\"startPosition\",\"duration\",\"channel\"]},{\"name\":\"edit_midi_notes\",\"description\":\"Batch edit multiple MIDI notes in a single call. Much more efficient than calling edit_midi_note repeatedly. Pass a native array of edit objects, each with noteIndex and any fields to change (pitch, velocity, startPosition, duration, channel). Only provided fields are changed.\",\"params\":[\"trackIndex\",\"itemIndex\",\"edits\"]},{\"name\":\"delete_midi_note\",\"description\":\"Delete a MIDI note by index from a MIDI item\",\"params\":[\"trackIndex\",\"itemIndex\",\"noteIndex\"]},{\"name\":\"get_midi_cc\",\"description\":\"Get CC (continuous controller) events from a MIDI item. Optionally filter by CC number (e.g. 1=modulation, 7=volume, 10=pan, 11=expression, 64=sustain).\",\"params\":[\"trackIndex\",\"itemIndex\",\"ccNumber\"]},{\"name\":\"insert_midi_cc\",\"description\":\"Insert a CC (continuous controller) event. Common CC numbers: 1=modulation, 7=volume, 10=pan, 11=expression, 64=sustain, 74=filter cutoff.\",\"params\":[\"trackIndex\",\"itemIndex\",\"ccNumber\",\"value\",\"position\",\"channel\"]},{\"name\":\"delete_midi_cc\",\"description\":\"Delete a CC event from a MIDI item by the ccIndex get_midi_cc returned. ccIndex counts every channel event (pitch bend, program change and pressure too), so CC indexes can skip numbers; only pass an index get_midi_cc listed\",\"params\":[\"trackIndex\",\"itemIndex\",\"ccIndex\"]},{\"name\":\"get_midi_item_properties\",\"description\":\"Get detailed properties of a MIDI item including position, length, note count, CC count (CC messages only), channel-event counts by type, mute state, and loop setting\",\"params\":[\"trackIndex\",\"itemIndex\"]},{\"name\":\"set_midi_item_properties\",\"description\":\"Set MIDI item properties: position (seconds), length (seconds), mute, loop source\",\"params\":[\"trackIndex\",\"itemIndex\",\"position\",\"length\",\"mute\",\"loopSource\"]},{\"name\":\"send_midi_cc\",\"description\":\"Send a MIDI CC (continuous controller) event in real-time to a track's MIDI output. Auto-inserts the MCP MIDI Emitter JSFX if not present. Common CC numbers: 1=modulation, 7=volume, 10=pan, 11=expression, 64=sustain, 74=filter cutoff.\",\"params\":[\"trackIndex\",\"cc\",\"value\",\"channel\"]},{\"name\":\"send_midi_pc\",\"description\":\"Send a MIDI program change in real-time, optionally preceded by bank select (CC0 MSB + CC32 LSB). Auto-inserts the MCP MIDI Emitter JSFX if not present.\",\"params\":[\"trackIndex\",\"program\",\"channel\",\"bankMsb\",\"bankLsb\"]},{\"name\":\"send_midi_note\",\"description\":\"Send a MIDI note-on in real-time to a track's MIDI output. If durationMs is provided, a note-off is automatically scheduled after that many milliseconds. Auto-inserts the MCP MIDI Emitter JSFX if not present.\",\"params\":[\"trackIndex\",\"pitch\",\"velocity\",\"channel\",\"durationMs\"]},{\"name\":\"list_media_items\",\"description\":\"List all media items on a track with position, length, name, volume, mute state, and whether it is MIDI or audio\",\"params\":[\"trackIndex\"]},{\"name\":\"get_media_item_properties\",\"description\":\"Get detailed properties of a media item: position, length, volume, fades, play rate, take info, source file\",\"params\":[\"trackIndex\",\"itemIndex\"]},{\"name\":\"set_media_item_properties\",\"description\":\"Set media item properties: position (seconds), length (seconds), volume (dB), mute, fade in/out lengths, play rate\",\"params\":[\"trackIndex\",\"itemIndex\",\"position\",\"length\",\"volume\",\"mute\",\"fadeInLength\",\"fadeOutLength\",\"playRate\"]},{\"name\":\"set_media_items_properties\",\"description\":\"Batch set properties on multiple media items in a single call. Much more efficient than calling set_media_item_properties repeatedly. Pass a native array of item objects, each with trackIndex, itemIndex, and any properties to change.\",\"params\":[\"items\"]},{\"name\":\"split_media_item\",\"description\":\"Split a media item at a given position (absolute project time in seconds). Returns info about both resulting items.\",\"params\":[\"trackIndex\",\"itemIndex\",\"position\"]},{\"name\":\"delete_media_item\",\"description\":\"Delete a media item from a track\",\"params\":[\"trackIndex\",\"itemIndex\"]},{\"name\":\"move_media_item\",\"description\":\"Move a media item to a new position and/or a different track\",\"params\":[\"trackIndex\",\"itemIndex\",\"newPosition\",\"newTrackIndex\"]},{\"name\":\"trim_media_item\",\"description\":\"Trim a media item edges. Positive trimStart trims from the beginning (makes item shorter/later). Positive trimEnd trims from the end (makes item shorter). Negative values extend.\",\"params\":[\"trackIndex\",\"itemIndex\",\"trimStart\",\"trimEnd\"]},{\"name\":\"add_stretch_marker\",\"description\":\"Add a stretch marker to a media item for time-stretching audio. Position is within the item (seconds from item start). Source position is the corresponding position in the original audio.\",\"params\":[\"trackIndex\",\"itemIndex\",\"position\",\"sourcePosition\"]},{\"name\":\"get_stretch_markers\",\"description\":\"List all stretch markers in a media item with their positions and source positions\",\"params\":[\"trackIndex\",\"itemIndex\"]},{\"name\":\"delete_stretch_marker\",\"description\":\"Delete a stretch marker by index from a media item\",\"params\":[\"trackIndex\",\"itemIndex\",\"markerIndex\"]},{\"name\":\"get_selected_tracks\",\"description\":\"Get all currently selected tracks in REAPER with their indices and names; a selected master track is listed first as index -1\",\"params\":[]},{\"name\":\"get_time_selection\",\"description\":\"Get the current time selection (loop selection) start and end in seconds\",\"params\":[]},{\"name\":\"set_time_selection\",\"description\":\"Set the time selection (loop selection) to a start and end position in seconds\",\"params\":[\"start\",\"end\"]},{\"name\":\"set_selected_tracks\",\"description\":\"Select tracks by 0-based index, exact name, or \\\"{GUID}\\\" — usually before run_action, since most actions act on the selection. Every track is resolved first: an unknown or ambiguous one changes nothing. Returns the selection afterwards.\",\"params\":[\"tracks\",\"mode\"]},{\"name\":\"get_selected_items\",\"description\":\"Get the media items selected right now, as {trackIndex, itemIndex} (the indexes list_media_items and the item tools use) with the track name, position and length in seconds, and mute. Use it when the user says \\\"the selected items\\\", instead of guessing which tracks they mean. Paged: returns {total, hasMore, items}; pass offset to read on.\",\"params\":[\"offset\",\"limit\"]},{\"name\":\"set_selected_items\",\"description\":\"Select media items by track and item index (as list_media_items reports them) — usually before run_action. Every item is resolved first: a missing one changes nothing. Returns the selection afterwards.\",\"params\":[\"items\",\"mode\"]},{\"name\":\"get_record_setup\",\"description\":\"Recording setup: the global record mode (normal, time_selection auto-punch, selected_items auto-punch) with the punch range, the record path, every armed track (or every track with all) with its input (\\\"In 3/4\\\", \\\"MIDI: all inputs\\\"), monitoring, record mode and input FX count, and the audio and MIDI inputs that exist. Read this before arming or recording.\",\"params\":[\"all\"]},{\"name\":\"set_track_record\",\"description\":\"Arm tracks and set their record input, monitoring (off, on, auto = tape style), record mode and monitor-items, for up to 64 tracks in one undo point. Every track and input is checked first (an input the audio device does not have, an unknown MIDI device): a refused call changes nothing. Returns each track's record state and warnings (a MIDI mode on an audio input, an armed track with no input). Modes: input (default), midi_overdub/midi_replace for MIDI, stereo_out/mono_out to print the track output.\",\"params\":[\"tracks\"]},{\"name\":\"set_record_mode\",\"description\":\"Set the global record mode: normal, time_selection (auto-punch: records only inside the time selection; give punchStart/punchEnd to set it) or selected_items (auto-punch on the selected items). Optionally the record path (a folder relative to the project, or absolute). All input is checked first; one undo point.\",\"params\":[\"mode\",\"punchStart\",\"punchEnd\",\"recordPath\"]},{\"name\":\"get_track_lanes\",\"description\":\"A track's fixed lanes (REAPER 7): whether they are on, each lane's name, whether it plays (exclusive, layered or off) and its items (index, position, length, take name; 100 per lane, then itemsMore). Use before comp_lanes to see which take is on which lane.\",\"params\":[\"track\"]},{\"name\":\"set_track_lanes\",\"description\":\"Fixed lanes on a track: turn them on/off, set the lane count, name lanes and choose what plays — one lane alone (play: 2) or several layered (play: [0, 2]). Turning fixed lanes off puts every lane's items on one lane, all playing (the answer warns; undo_project brings the lanes back). A lane count below a lane that has items is refused; every refusal changes nothing. One undo point. REAPER can drop the names of lanes with no items, so name lanes once the takes are on them.\",\"params\":[\"track\",\"fixedLanes\",\"laneCount\",\"names\",\"play\"]},{\"name\":\"comp_lanes\",\"description\":\"Comp takes from fixed lanes: give time ranges and the lane to take each from ({ start, end, lane }, seconds, no overlaps); copies of those parts go onto a new lane (\\\"Comp\\\" by default) with crossfades where one range meets the next, and that lane plays alone. The source lanes stay untouched (silent), so another comp or set_track_lanes play can switch back. A range a lane has no audio for is refused with the gap; every refusal changes nothing. One undo point.\",\"params\":[\"track\",\"ranges\",\"crossfadeMs\",\"name\"]},{\"name\":\"list_markers\",\"description\":\"List all project markers with index, name, position, and color\",\"params\":[]},{\"name\":\"list_regions\",\"description\":\"List all project regions with index, name, start/end positions, and color\",\"params\":[]},{\"name\":\"add_marker\",\"description\":\"Add a project marker at a position in seconds, with optional name and color\",\"params\":[\"position\",\"name\",\"color\"]},{\"name\":\"add_region\",\"description\":\"Add a project region with start/end in seconds, optional name and color\",\"params\":[\"start\",\"end\",\"name\",\"color\"]},{\"name\":\"delete_marker\",\"description\":\"Delete a project marker by its marker index number\",\"params\":[\"markerIndex\"]},{\"name\":\"delete_region\",\"description\":\"Delete a project region by its region index number\",\"params\":[\"regionIndex\"]},{\"name\":\"edit_marker\",\"description\":\"Rename, move or recolor an existing marker by its marker index number (from list_markers). Unspecified fields keep their values; name \\\"\\\" clears the name. Color is a native color int, stored with REAPER's 0x1000000 \\\"custom color\\\" flag. Unknown markers change nothing.\",\"params\":[\"markerIndex\",\"name\",\"position\",\"color\"]},{\"name\":\"edit_region\",\"description\":\"Rename, move/resize or recolor an existing region by its region index number (from list_regions). Unspecified fields keep their values; end must stay after start. Unknown regions change nothing.\",\"params\":[\"regionIndex\",\"name\",\"start\",\"end\",\"color\"]},{\"name\":\"get_tempo_map\",\"description\":\"Get all tempo and time signature change points in the project (tempo map markers)\",\"params\":[]},{\"name\":\"add_tempo_marker\",\"description\":\"Add a tempo / time signature marker at a position in seconds. Returns the updated tempo map (same shape as get_tempo_map, plus tempoMarkerCount). One undo point.\",\"params\":[\"position\",\"bpm\",\"timeSigNumerator\",\"timeSigDenominator\",\"linear\"]},{\"name\":\"edit_tempo_marker\",\"description\":\"Edit a tempo marker by its get_tempo_map index (only tempoMarkerCount > 0 maps have real markers). Unspecified fields keep their values. Returns the updated tempo map.\",\"params\":[\"index\",\"position\",\"bpm\",\"timeSigNumerator\",\"timeSigDenominator\",\"linear\"]},{\"name\":\"delete_tempo_marker\",\"description\":\"Delete a tempo marker by its get_tempo_map index. Returns the updated tempo map.\",\"params\":[\"index\"]},{\"name\":\"set_project_tempo\",\"description\":\"Set the tempo at the project start. With no tempo markers this sets the project BPM; with a marker at 0 it edits that marker; when the first marker is later, it adds a marker at 0 (later markers keep their BPM and their indexes shift by one). Returns the updated tempo map.\",\"params\":[\"bpm\"]},{\"name\":\"get_track_envelopes\",\"description\":\"List all automation envelopes on a track (volume, pan, mute, FX params, sends, etc.) with point and automation item counts. Send envelopes (all named \\\"Send Volume\\\", \\\"Send Pan\\\", ...) carry `send`: the send index and destination track.\",\"params\":[\"trackIndex\"]},{\"name\":\"get_envelope_points\",\"description\":\"Get automation points for a track envelope (or one automation item) with pagination. Returns time, raw value, shape, tension per point, plus `db` on volume envelopes.\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"offset\",\"limit\"]},{\"name\":\"insert_envelope_point\",\"description\":\"Insert an automation point on a track envelope (or inside an automation item) at a time in seconds. Give `db` on volume envelopes (Volume, Trim Volume, Send Volume): it is converted with the envelope's own scaling (fader-scaled volume envelopes store 716.2 for 0 dB, not 1.0). `value` is the raw envelope value (pan -1..1, mute 0/1, FX parameter 0..1).\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"time\",\"value\",\"db\",\"shape\",\"tension\"]},{\"name\":\"insert_envelope_points\",\"description\":\"Batch insert automation points on a track envelope (or inside an automation item). Much faster than repeated insert_envelope_point calls. Give `db` on volume envelopes (Volume, Trim Volume, Send Volume): it is converted with the envelope's own scaling (fader-scaled volume envelopes store 716.2 for 0 dB, not 1.0). `value` is the raw envelope value (pan -1..1, mute 0/1, FX parameter 0..1).\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"points\"]},{\"name\":\"edit_envelope_points\",\"description\":\"Edit existing automation points by index (from get_envelope_points): move them, change their level, shape or tension. Fields left out keep their value; all edits are validated before any is written. Give `db` on volume envelopes (Volume, Trim Volume, Send Volume): it is converted with the envelope's own scaling (fader-scaled volume envelopes store 716.2 for 0 dB, not 1.0). `value` is the raw envelope value (pan -1..1, mute 0/1, FX parameter 0..1).\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"points\"]},{\"name\":\"delete_envelope_point\",\"description\":\"Delete one automation point by its index (from get_envelope_points); returns the deleted point\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"pointIndex\"]},{\"name\":\"create_track_envelope\",\"description\":\"Create/show an automation envelope on a track. Use envelopeName for built-in envelopes (Volume, Pan, Mute, Width, Trim Volume), sendIndex + envelopeName (Volume, Pan, Mute) for a send's envelope (it appears on the track as \\\"Send Volume\\\" etc. and starts at the send's current value), or fxIndex+paramIndex for FX parameter envelopes. The envelope is made visible and active; an existing one is only shown (`created: false`). The track selection is left as it was.\",\"params\":[\"trackIndex\",\"envelopeName\",\"sendIndex\",\"fxIndex\",\"paramIndex\"]},{\"name\":\"set_envelope_properties\",\"description\":\"Set properties (active, visible, armed) on a track envelope. Requires SWS extension for full support.\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"active\",\"visible\",\"armed\"]},{\"name\":\"clear_envelope\",\"description\":\"Delete ALL automation points from an envelope (or from one automation item's pool), resetting it to its default state\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\"]},{\"name\":\"remove_envelope_points\",\"description\":\"Delete automation points in a time range from a track envelope (or automation item). Use to surgically remove a section of automation.\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"timeStart\",\"timeEnd\"]},{\"name\":\"list_automation_items\",\"description\":\"List the automation items on an envelope: index, poolId, pool name, position, length, loop, baseline/amplitude and point count. Items with the same poolId share their points.\",\"params\":[\"trackIndex\",\"envelopeIndex\"]},{\"name\":\"insert_automation_item\",\"description\":\"Insert an automation item on an envelope. Without poolId it starts a new pool, filled from `points` (times in seconds from the item start); with the poolId of an existing item (on any track) it adds a pooled instance with the same points, so editing one edits all; pooledWith counts the other instances in the project (use this for repeated sections such as every chorus). captureEnvelope moves the underlying envelope points in the range into the new item instead. Automation items override the underlying envelope where they sit.\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"position\",\"length\",\"poolId\",\"points\",\"captureEnvelope\",\"startOffset\",\"playRate\",\"baseline\",\"amplitude\",\"loop\",\"name\"]},{\"name\":\"set_automation_item\",\"description\":\"Move, resize or change an automation item: position, length, start offset, play rate, baseline, amplitude, loop, pool name. Points are edited with edit_envelope_points and automationItemIndex.\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"position\",\"length\",\"startOffset\",\"playRate\",\"baseline\",\"amplitude\",\"loop\",\"name\"]},{\"name\":\"delete_automation_item\",\"description\":\"Delete one automation item. Its pool lives on while other instances use it. preservePoints keeps its points on the underlying envelope. Other selections are left as they were.\",\"params\":[\"trackIndex\",\"envelopeIndex\",\"automationItemIndex\",\"preservePoints\"]},{\"name\":\"set_multiple_track_properties\",\"description\":\"Batch set properties (volume, pan, mute, solo, recordArm, phase, input) on multiple tracks in a single call. Much more efficient than calling set_track_property repeatedly. Pass an array of track update objects, each with trackIndex and any properties to change.\",\"params\":[\"tracks\"]},{\"name\":\"setup_fx_chain\",\"description\":\"Add multiple FX plugins to a track with optional initial parameter values in a single call. Returns the FX chain indices of added plugins. More efficient than calling add_fx and set_fx_parameter repeatedly.\",\"params\":[\"trackIndex\",\"plugins\"]},{\"name\":\"set_multiple_fx_parameters\",\"description\":\"Batch set parameters across multiple FX plugins, potentially on different tracks, in a single call. Much faster than repeated set_fx_parameter calls. Pass an array of update objects with trackIndex, fxIndex, paramIndex, and value.\",\"params\":[\"updates\"]},{\"name\":\"run_plan\",\"description\":\"Execute a multi-step edit as ONE bridge call in ONE undo block, all-or-nothing. Use instead of many sequential tool calls. Ops run in order: add_track, set_track, add_fx, set_fx_params, add_send, graft_fxchain (copy a source FX chain onto a track; sends are not copied), select_tracks, copy_items / insert_time / remove_time (as the arrange tools), and run_action (any REAPER action — usually after select_tracks; same safety rules as run_action; only run_action ops may follow a run_action). Target tracks by index, exact name, \\\"{GUID}\\\", or a \\\"$ref\\\" that an earlier add_track/add_fx bound with `as`. Every target is resolved before anything is written: an unknown or ambiguous track rejects the whole plan, and a failure mid-apply reverts it. Use dryRun to preview resolution and conflicts. Pass an idempotencyKey so a retried call is not applied twice.\",\"params\":[\"ops\",\"dryRun\",\"idempotencyKey\",\"snapshotBefore\",\"label\"]},{\"name\":\"search_actions\",\"description\":\"Search REAPER's action list (native, SWS/extensions, scripts, and the user's Custom: macros — ~6k actions) inside REAPER. Every query word must appear in the action name or named id (case-insensitive). Returns id, stable namedId, name, toggle state, keyboard shortcuts, and whether it opens a dialog or is always refused, plus the total match count.\",\"params\":[\"query\",\"section\",\"limit\"]},{\"name\":\"get_action\",\"description\":\"Get one REAPER action: name, ids, toggle state, shortcuts, and its kind. For a Custom: macro, lists the steps it runs by name; for a script, its file path.\",\"params\":[\"action\",\"section\"]},{\"name\":\"run_action\",\"description\":\"Run one REAPER action (like pressing its shortcut) in an undo block, and return its toggle state afterwards. Most actions work on the current selection: set it first with set_selected_tracks / set_selected_items. Actions that open a dialog (name ends in \\\"...\\\") are refused unless allowDialog is true, because a dialog blocks REAPER until a person closes it. Actions that quit REAPER, close/open/replace the project, or open, close or switch project tabs are always refused. A Custom: macro is refused if any step it runs would be. To combine actions with other edits in one undo step, use run_plan's run_action op.\",\"params\":[\"action\",\"section\",\"allowDialog\"]},{\"name\":\"insert_audio_file\",\"description\":\"Insert an audio file (WAV, AIFF, FLAC, MP3, …) onto a track as a new item at a position. The item is as long as the file. Refused, with nothing changed, when the file does not exist or REAPER cannot read it as audio.\",\"params\":[\"trackIndex\",\"filePath\",\"position\"]},{\"name\":\"list_takes\",\"description\":\"List the takes of a media item: name, which one is active, MIDI or audio, source file, and take FX count\",\"params\":[\"trackIndex\",\"itemIndex\"]},{\"name\":\"set_active_take\",\"description\":\"Make one take of a media item the active (playing) take. Returns the item's takes afterwards.\",\"params\":[\"trackIndex\",\"itemIndex\",\"takeIndex\"]},{\"name\":\"get_take_fx\",\"description\":\"List the FX on a take (its own FX chain, separate from the track FX). With fxIndex, also lists that FX's parameters with values and formatted text (paginate large plugins with offset/limit; the result has paramTotal and hasMore).\",\"params\":[\"trackIndex\",\"itemIndex\",\"takeIndex\",\"fxIndex\",\"offset\",\"limit\"]},{\"name\":\"add_take_fx\",\"description\":\"Add an FX to a take's FX chain by name (partial match, like add_fx). Returns the take's FX chain afterwards.\",\"params\":[\"trackIndex\",\"itemIndex\",\"takeIndex\",\"fxName\"]},{\"name\":\"remove_take_fx\",\"description\":\"Remove one FX from a take's FX chain. Returns the take's FX chain afterwards.\",\"params\":[\"trackIndex\",\"itemIndex\",\"takeIndex\",\"fxIndex\"]},{\"name\":\"set_take_fx_parameter\",\"description\":\"Set one parameter of a take FX (same value scale as set_fx_parameter) and return the value REAPER reads back\",\"params\":[\"trackIndex\",\"itemIndex\",\"takeIndex\",\"fxIndex\",\"paramIndex\",\"value\"]},{\"name\":\"get_item_appearance\",\"description\":\"Get a media item's color (\\\"#RRGGBB\\\" or \\\"none\\\") and fades: lengths (seconds), shapes (0-6) and curves (-1..1)\",\"params\":[\"trackIndex\",\"itemIndex\"]},{\"name\":\"set_item_color\",\"description\":\"Set a media item's color, or \\\"none\\\" to go back to the track's default. Returns the color and fades REAPER reads back.\",\"params\":[\"trackIndex\",\"itemIndex\",\"color\"]},{\"name\":\"set_item_fades\",\"description\":\"Set a media item's fade-in/out lengths, shapes and curves; only the fields given change. Shapes: 0 linear, 1 fast start, 2 fast end, 3 fast start (steep), 4 fast end (steep), 5 slow start/end, 6 slow start/end (steep). Returns the color and fades REAPER reads back.\",\"params\":[\"trackIndex\",\"itemIndex\",\"fadeInLength\",\"fadeOutLength\",\"fadeInShape\",\"fadeOutShape\",\"fadeInCurve\",\"fadeOutCurve\"]},{\"name\":\"copy_media_items\",\"description\":\"Copy (duplicate or repeat) media items, keeping their spacing: by default right after the last one, or at `position` and/or on another track. `times` lays copies end to end (e.g. repeat a 4-bar loop 8 times). Copies get fresh GUIDs; MIDI copies get their own data unless `pooled`. One undo point; returns where each copy landed.\",\"params\":[\"items\",\"times\",\"position\",\"trackIndex\",\"pooled\"]},{\"name\":\"insert_time\",\"description\":\"Open empty time at a position across the whole project: every item, marker, region, tempo marker, envelope point and automation item at or after it moves later by `length`; items spanning it are split (unless splitItems: false) and regions spanning it grow. An automation item spanning the position stays where it is (counted in automationItemsSpanning). Independent of REAPER's ripple settings. One undo point; returns what moved.\",\"params\":[\"position\",\"length\",\"splitItems\"]},{\"name\":\"remove_time\",\"description\":\"Cut a time range out of the whole project and close the gap: items, markers, tempo markers, envelope points and automation items inside it are deleted, items and automation items crossing an edge lose the part inside it (an automation item spanning the whole cut stays, counted as automationItemsKept), regions shrink, and everything after moves earlier. The tempo in force at the end of the cut is kept. One undo point; returns what was deleted, trimmed and moved.\",\"params\":[\"start\",\"end\"]},{\"name\":\"copy_section\",\"description\":\"Copy a section of the song (a region by list_regions index, or start/end) to another position: the items in it (trimmed to the section) and, by default, its automation (envelope points, plus a pooled copy of each automation item wholly inside the section; items crossing an edge are counted in automationItemsCrossing, not copied), on every track or the given tracks. With `insert`, time is opened at the position first, across the whole project like insert_time, so nothing there is overwritten (e.g. repeat a chorus). One undo point.\",\"params\":[\"regionIndex\",\"start\",\"end\",\"position\",\"insert\",\"envelopes\",\"tracks\"]},{\"name\":\"process_items\",\"description\":\"Process audio items: `normalize` sets item gain so each item hits `target` dB (mode peak by default, or true_peak, lufs_i, rms, lufs_m_max, lufs_s_max; non-peak modes need a target), measured over what the item plays; `reverse` toggles each active take's direction (a take already reversed plays forward again); `glue` joins the whole items on each track into one new item, whatever the time selection. MIDI items are refused for normalize/reverse. The selection is kept. One undo point; normalize returns each item's level and gain before and after.\",\"params\":[\"operation\",\"items\",\"mode\",\"target\"]},{\"name\":\"move_fx\",\"description\":\"Move one FX to another position in its chain, or to another track (with its settings). Returns the chain(s) afterwards.\",\"params\":[\"trackIndex\",\"fxIndex\",\"toTrackIndex\",\"toIndex\"]},{\"name\":\"copy_fx\",\"description\":\"Copy one FX (with its settings) to another position in its chain or onto another track. Returns the chain(s) afterwards.\",\"params\":[\"trackIndex\",\"fxIndex\",\"toTrackIndex\",\"toIndex\"]},{\"name\":\"rename_fx\",\"description\":\"Rename one FX instance as shown in the FX chain (REAPER 6.37+). An empty name restores the plugin's own name.\",\"params\":[\"trackIndex\",\"fxIndex\",\"name\"]},{\"name\":\"save_fx_chain\",\"description\":\"Save a track's whole FX chain (with all settings) as an .RfxChain file in REAPER's FXChains folder, where REAPER's own \\\"Add FX chain\\\" finds it. The name may include subfolders (\\\"Vocals/Lead\\\") but never \\\"..\\\", an absolute path or a drive letter.\",\"params\":[\"trackIndex\",\"name\",\"overwrite\"]},{\"name\":\"load_fx_chain\",\"description\":\"Load an .RfxChain file onto a track: appended after its FX (default) or replacing them. Each loaded FX gets a fresh identity. See list_fx_chains for names.\",\"params\":[\"trackIndex\",\"name\",\"mode\"]},{\"name\":\"list_fx_chains\",\"description\":\"List the .RfxChain files in REAPER's FXChains folder (and subfolders), by the name load_fx_chain takes\",\"params\":[]},{\"name\":\"save_track_template\",\"description\":\"Save a track (name, FX chain, settings) as an .RTrackTemplate in REAPER's TrackTemplates folder. Items are left out unless includeItems is true; receives and folder state are never saved (they depend on the tracks around it). The name may include subfolders but never \\\"..\\\", an absolute path or a drive letter.\",\"params\":[\"trackIndex\",\"name\",\"includeItems\",\"overwrite\"]},{\"name\":\"insert_track_template\",\"description\":\"Insert the track(s) from an .RTrackTemplate at a position, each with fresh identities. See list_track_templates for names.\",\"params\":[\"name\",\"index\"]},{\"name\":\"list_track_templates\",\"description\":\"List the .RTrackTemplate files in REAPER's TrackTemplates folder (and subfolders), by the name insert_track_template takes\",\"params\":[]},{\"name\":\"list_tool_categories\",\"description\":\"List all available tool categories with descriptions and tool names. Use this to discover what tools are available without loading every tool schema. Categories: project, tracks, fx, transport, midi, media, arrange, selection, recording, markers, tempo, envelopes, analysis, discovery, snapshots, routing, plan, actions, takes, fx_files, knowledge, plugin_authoring.\",\"params\":[]},{\"name\":\"enable_tool_category\",\"description\":\"Signal that you intend to use tools from a specific category. All tools are already registered and available — this call returns the full list of tools in the category so you know exactly which tool names to use. Use list_tool_categories first to see all available categories.\",\"params\":[\"category\"]},{\"name\":\"disable_tool_category\",\"description\":\"Signal that you are done using tools from a specific category. This is a semantic hint to help manage your context budget — the tools remain registered but you can use this to indicate you no longer need them in the current workflow.\",\"params\":[\"category\"]},{\"name\":\"analyze_track_aesthetics\",\"description\":\"Analyze the perceptual aesthetic quality of a track's audio using Meta's Audiobox Aesthetics model (CC-BY 4.0). Bounces the track to a temp WAV file (post-FX, post-fader) and runs 4-axis perceptual quality scoring: Production Quality (PQ), Production Complexity (PC), Content Enjoyment (CE), Content Usefulness (CU). Returns scores 0-10. The clip is normalized to normalizeLufs (default -18 LUFS) before scoring, so level differences between versions do not bias the scores (CE rises with level; PQ barely moves). PQ (and partly CU) judge mix changes; PC and CE mostly follow the arrangement, so only compare the same time range. Measured noise: re-rendering the same 30 s clip moves PQ by ~0.05, a 10 s clip by ~0.4; treat smaller differences as no change. Requires the Python sidecar (run in a terminal: reaper-mcp setup-sidecar).\",\"params\":[\"trackIndex\",\"startTime\",\"endTime\",\"durationSeconds\",\"normalizeLufs\"]},{\"name\":\"analyze_track_offline\",\"description\":\"Render a track (or the master, -1) once and analyze it offline — no playback needed, works on folder tracks. Returns integrated LUFS (BS.1770 gated), loudness range (LRA), true peak (dBTP), sample peak, crest factor, per-section loudness, band balance (sub..brilliance as share of energy), resonance hints (narrow peaks above the local spectrum) and sibilance hints (5-10 kHz spikes with times). With referencePath, also the loudness difference and tonal-balance difference (bands and third octaves, level offset removed) against that file. Use this for whole-song and mastering numbers (up to 900 s). Requires the Python sidecar.\",\"params\":[\"trackIndex\",\"startTime\",\"endTime\",\"durationSeconds\",\"sectionSeconds\",\"referencePath\",\"referenceStartTime\",\"referenceEndTime\"]},{\"name\":\"analyze_audio_file\",\"description\":\"Analyze an audio file on disk (a reference track, a bounce, a stem) the same way as analyze_track_offline: integrated LUFS, LRA, true peak, crest, per-section loudness, band balance, resonance and sibilance hints, and an optional comparison against another file. Does not touch REAPER. Requires the Python sidecar.\",\"params\":[\"path\",\"startTime\",\"endTime\",\"sectionSeconds\",\"referencePath\",\"referenceStartTime\",\"referenceEndTime\"]},{\"name\":\"measure_track_alignment\",\"description\":\"Measure the time offset and polarity of one track against a reference track (e.g. snare bottom vs snare top, kick sub vs kick in, overheads vs snare) by rendering both over the same range and cross-correlating them. A positive delayMs means the track arrives later than the reference, as both play now (the current playback offset and polarity are included). To align it, set_track_property playOffsetMs = suggestedPlayOffsetMs and phase = suggestedPhase (1 = inverted) on that track — absolute values that already account for the current settings, so re-measuring an aligned track suggests what it already has. Renders are post-FX (plugin latency is compensated). Pick a range where both tracks play the same hits; below correlation 0.3 no suggestion is made. Requires the Python sidecar.\",\"params\":[\"referenceTrack\",\"trackIndex\",\"startTime\",\"durationSeconds\",\"maxLagMs\"]},{\"name\":\"verify_edit\",\"description\":\"Check the result of an edit you just made, since you cannot hear it: compare the edited track with the audio from before the edit and get a verdict per check. Both sides are rendered (after track FX, pan and fader), so FX and fader edits show. Compensated null: the delay (ms, + = later), gain (dB) and polarity between the two are estimated and removed, and the residual left (dB below the reference) says whether anything else changed (noise, a splice, a different waveform, a swapped stereo channel; it is relative to referenceRmsDb, so with a quiet reference the rounding noise of a 16-bit bounce can set it). Discontinuity: the largest sample-to-sample jump on any channel against the reference's own, with where it happens and which channel (a click or hard splice). Use expect 'identical' (default) for edits that should leave the sound alone apart from level, delay and polarity (alignment, gain, split, crossfade): the residual is judged ok/warn/fail. Use \\\"changed\\\" for EQ, compression and the like: the residual is reported without a verdict. Set timeScale to the playback rate when the edit changed the timing (1.1 = the edit is 10% shorter): the waveform null is then skipped and the click check runs with three warn-only character checks against the reference warped through that rate: pitch drift in cents (skipped for unpitched material), tone (long-term spectrum distance in dB, line 1.5 dB, provisional) and transients (smeared attacks). When the pitch moved by what the speed change alone causes (a plain speed change, pitch follows speed), pitch and tone are reported as info, not warned; a pitch move the speed does not explain still warns. Slow-downs below 0.9 also get a dropout check (the deepest dip of the edited loudness under the original, warn from 12 dB, provisional): bigger slow-downs stretch audible artifacts into a vocal that the other checks do not hear, so listen to those either way. The reference is another track (e.g. a copy you kept) or an audio file of the same range from before the edit (a bounce), not an undo. Keep a reference track unmuted so it renders. The tone check misses a phase vocoder's smearing and the transient check is blind on drums. A passing result is evidence, not a replacement for listening. Requires the Python sidecar.\",\"params\":[\"trackIndex\",\"referenceTrack\",\"referencePath\",\"startTime\",\"durationSeconds\",\"expect\",\"timeScale\",\"maxLagMs\"]},{\"name\":\"detect_transients\",\"description\":\"Find the transients (hits/onsets) in a track (read from its own items, before track FX and pan, without a render; the master is rendered) or an audio file on disk: each hit's time in project seconds, strength (0..1, relative to the loudest hits), dominant band (low = kick/bass, mid = snare/vocals/keys, high = hats/cymbals) and peakDb, plus a tempo estimate, hit counts per band and, with sectionSeconds, how busy each part is. Hits are paginated (offset/limit). Use it to sync lighting, video cuts, markers or MIDI to a song; create_transient_automation writes the hits as envelope pulses directly. A file is read as-is (no stretch markers or play rate): for an item warped to the grid, pass its track instead. Requires the Python sidecar.\",\"params\":[\"trackIndex\",\"path\",\"filePosition\",\"startTime\",\"endTime\",\"band\",\"sensitivity\",\"minGapMs\",\"minStrength\",\"bands\",\"sectionSeconds\",\"offset\",\"limit\"]},{\"name\":\"create_transient_automation\",\"description\":\"Detect the transients of a track (its own audio, before FX and pan) or audio file (same options as detect_transients) and write one pulse per hit onto an existing envelope of a target track — e.g. a lighting/DMX plugin parameter that should flash on every kick. Each pulse rises from baseValue to the hit level (peakValue, scaled by strength unless scaleByStrength is false) over attackMs, holds holdMs, and falls back over decayMs; a hit before the previous pulse has ended cuts it short. Values are raw envelope values (FX parameters 0..1, Pan -1..1). Create the envelope first with create_track_envelope (it returns envelopeIndex). By default the envelope's points in the range are replaced (replaceExisting). dryRun returns the points without writing. Use bands/minStrength/minGapMs to choose what the lights follow (e.g. bands [\\\"low\\\"], minStrength 0.6 for the kick accents). Requires the Python sidecar.\",\"params\":[\"trackIndex\",\"path\",\"filePosition\",\"startTime\",\"endTime\",\"band\",\"sensitivity\",\"minGapMs\",\"minStrength\",\"bands\",\"targetTrack\",\"envelopeIndex\",\"baseValue\",\"peakValue\",\"scaleByStrength\",\"attackMs\",\"holdMs\",\"decayMs\",\"decayCurve\",\"replaceExisting\",\"dryRun\"]},{\"name\":\"analyze_loudness_curve\",\"description\":\"Loudness over time of a track (or the master, -1) or an audio file: short-term (3 s) and momentary (400 ms) LUFS as curves (at most 240 points each, every point the loudest moment of its slice), integrated LUFS, true peak, LRA, PLR (true peak minus integrated), the loudest and quietest 3 s windows, and with targetLufs the spans whose short-term loudness goes over target + toleranceLu. Use it to see where a master gets too loud or a section drops away, before and after a change. Rendered once, no playback. Requires the Python sidecar.\",\"params\":[\"trackIndex\",\"path\",\"startTime\",\"endTime\",\"targetLufs\",\"toleranceLu\"]},{\"name\":\"analyze_stereo_bands\",\"description\":\"Stereo correlation per frequency band (low <120 Hz, lowMid 120-500 Hz, mid 0.5-2 kHz, high 2-8 kHz, air >8 kHz) of a track, the master (-1) or a stereo file: overall and worst correlation (+1 mono, 0 wide, below 0 cancels in mono), the share of time out of phase, side-to-mid level (dB, width), a short correlation series per band, and flags for a wide or out-of-phase low end or any band that cancels in mono. Rendered once, no playback. Requires the Python sidecar.\",\"params\":[\"trackIndex\",\"path\",\"startTime\",\"endTime\"]},{\"name\":\"measure_masking\",\"description\":\"Find where 2-8 tracks compete for the same frequencies: renders each track over the same range (post-FX) and compares their K-weighted third-octave levels (40 Hz-16 kHz). A band scores high when both tracks are loud there and within a few dB of each other. Returns every pair's overall score with its worst bands, and the top conflicts (score >= 0.2) with a suggestion: which track to cut around which frequency (the one the band matters less to). Pick a section where they all play (max 60 s). Requires the Python sidecar.\",\"params\":[\"tracks\",\"startTime\",\"durationSeconds\"]},{\"name\":\"separate_stems\",\"description\":\"Split a track (rendered post-FX, -1 = master) or an audio file into stems with Demucs: htdemucs gives drums, bass, other, vocals; htdemucs_6s adds guitar and piano. Writes one 32-bit float WAV per stem to outDir (default: a new folder under the project's Stems folder) and returns each stem's path, LUFS and peak. With insertTracks, adds them as tracks under a new folder in one undo point, lined up with the source (a track: after it, at startTime; a file: at filePosition + startTime); the folder starts muted, since the stems sum back to the source. Slow: about real time on a CPU, several times faster on Apple silicon or CUDA (max 600 s per call). Needs `reaper-mcp setup-sidecar --with-separation` (which downloads htdemucs; the first htdemucs_6s call downloads its ~80 MB weights).\",\"params\":[\"trackIndex\",\"path\",\"startTime\",\"endTime\",\"model\",\"stems\",\"outDir\",\"insertTracks\",\"filePosition\"]},{\"name\":\"set_automation_mode\",\"description\":\"Set the automation mode of tracks (trim/read, read, touch, write, latch, latch_preview) and/or REAPER's global automation override (\\\"none\\\" clears it, \\\"bypass\\\" turns all automation off). Returns each track's mode before and after. Write/latch/touch record fader moves while playing.\",\"params\":[\"tracks\",\"mode\",\"globalOverride\"]},{\"name\":\"get_fx_param_modulation\",\"description\":\"Read FX parameter modulation (REAPER 6.37+): LFO, audio control signal (sidechain follower) and parameter link, with the baseline. Without paramIndex, lists only the modulated parameters of the FX.\",\"params\":[\"trackIndex\",\"fxIndex\",\"paramIndex\"]},{\"name\":\"set_fx_param_modulation\",\"description\":\"Modulate an FX parameter (REAPER 6.37+): an LFO, an audio control signal (the parameter follows a channel's level, e.g. a sidechain on 3/4), and/or a link to another FX parameter on the same track. Only the fields given change; enabled:false turns all modulation of the parameter off. One undo point; the state before is returned.\",\"params\":[\"trackIndex\",\"fxIndex\",\"paramIndex\",\"enabled\",\"baseline\",\"lfo\",\"audio\",\"link\"]},{\"name\":\"get_fx_pins\",\"description\":\"Read an FX's pin mappings: each input and output pin and the track channels (1-based) it connects to, plus the track's channel count. Pins 3/4 of a compressor are its sidechain input.\",\"params\":[\"trackIndex\",\"fxIndex\"]},{\"name\":\"set_fx_pins\",\"description\":\"Connect FX pins to track channels (1-based, up to 64). Give a channel list per pin ([[1],[2],[3],[4]]) or only the pins to change ([{pin: 2, channels: [3]}, {pin: 3, channels: [4]}] routes a sidechain on 3/4). The track is widened to the highest channel used; trackChannels sets it explicitly. All validated before any write; one undo point.\",\"params\":[\"trackIndex\",\"fxIndex\",\"inputs\",\"outputs\",\"trackChannels\"]},{\"name\":\"list_monitoring_fx\",\"description\":\"List the monitoring FX chain (on the master, heard only in your monitors, never rendered — room correction, a reference meter, a mono check). Global to REAPER, not saved in the project.\",\"params\":[]},{\"name\":\"add_monitoring_fx\",\"description\":\"Add an FX to the monitoring chain (heard in the monitors, never rendered), with optional normalized parameters.\",\"params\":[\"fxName\",\"params\"]},{\"name\":\"set_monitoring_fx\",\"description\":\"Bypass, set offline, or set normalized parameters of a monitoring FX by index (from list_monitoring_fx).\",\"params\":[\"fxIndex\",\"enabled\",\"offline\",\"params\"]},{\"name\":\"remove_monitoring_fx\",\"description\":\"Remove a monitoring FX by index (from list_monitoring_fx).\",\"params\":[\"fxIndex\"]},{\"name\":\"freeze_tracks\",\"description\":\"Freeze tracks: render them (pre-fader) to stereo, mono or multichannel and take their items and online FX out until unfrozen, to free CPU. Blocks REAPER while it renders (a few seconds per minute of audio). The track selection is put back. Not the master.\",\"params\":[\"tracks\",\"mode\"]},{\"name\":\"unfreeze_tracks\",\"description\":\"Unfreeze tracks: restore the items and FX a freeze took out (one freeze layer per call). Refuses a track that is not frozen.\",\"params\":[\"tracks\"]},{\"name\":\"apply_fx_to_items\",\"description\":\"Render in place: apply the track and take FX to items as a new active take (stereo, mono or multichannel). The old take stays, so the render can be switched back with set_active_take. Blocks REAPER while it renders. The item selection is put back.\",\"params\":[\"items\",\"mode\"]},{\"name\":\"add_stretch_markers\",\"description\":\"Add many stretch markers to an audio item in one call and one undo point. position is seconds from the item start; sourcePosition (seconds in the source) pins the audio at that spot to the new position, which stretches the audio around it.\",\"params\":[\"trackIndex\",\"itemIndex\",\"markers\"]},{\"name\":\"edit_stretch_markers\",\"description\":\"Edit existing stretch markers of an audio item in one call and one undo point: move a marker (position, seconds from the item start), change which source time it pins (sourcePosition) and its slope (-1..1, the curve of the stretch after it). Markers are named by index, in position order. position is in item seconds, as this tool and add_stretch_markers report them; get_stretch_markers lists raw take positions, which equal item seconds only at play rate 1 (divide by the play rate otherwise). Only the fields given change. Every edit is checked first: a marker moved out of order (position or source), onto another marker, outside the item, or a repeated index refuses the whole call and changes nothing.\",\"params\":[\"trackIndex\",\"itemIndex\",\"edits\"]},{\"name\":\"quantize_audio\",\"description\":\"Quantize an audio item to the grid with stretch markers: finds the hits in the item's source (sidecar), puts a marker on each and moves it toward the nearest grid line (strength, window and swing as quantize_midi). The item keeps its length (anchors at both ends); the item's existing stretch markers are replaced. Returns the timing offset before and after (avg/max ms). Requires the sidecar.\",\"params\":[\"trackIndex\",\"itemIndex\",\"grid\",\"strength\",\"window\",\"swing\",\"sensitivity\",\"minGapMs\",\"minStrength\"]},{\"name\":\"align_audio_to_guide\",\"description\":\"Align doubles (a second take, a harmony, a stack) to a guide item with stretch markers, the way VocalSync does: finds the hits (onsets) in the guide and in each double (sidecar), pairs them in order within maxShiftMs, and puts a stretch marker on each hit of the double so it lands on the guide's. Audio between hits is stretched; anchors at both ends keep each double's length. strength < 1 moves hits only part of the way. protectConsonants moves high-band hits (s, t, k, sh) as a block, so the stretch lands in the vowel after them instead of smearing the consonant. dryRun returns the planned moves and writes nothing. Each double's existing stretch markers are replaced; a guide that has stretch markers is refused (its hits would not sit where its source says). Returns, per double, the timing offset before and after (avg/max ms against the guide). Works on the items' source files (take FX are ignored). Requires the sidecar. Not pitch correction.\",\"params\":[\"guide\",\"doubles\",\"strength\",\"maxShiftMs\",\"protectConsonants\",\"consonantMs\",\"dryRun\",\"sensitivity\",\"minGapMs\",\"minStrength\"]},{\"name\":\"quantize_midi\",\"description\":\"Quantize the notes of a MIDI item to the project grid (beats, not the item start): grid in beats (1 = quarter, 0.5 = 8th, 0.25 = 16th, 1/3 = 8th triplet), strength 0..1 (partial moves keep feel), swing 0..0.9 (pushes every second grid line later), window 0..1 (only notes within that fraction of half the gap to the next line move; with swing the gaps are uneven, so the reach is (1 + swing) times half a step), lengths \\\"keep\\\" (default, notes move whole) or \\\"quantize\\\" (ends snap too). Acts on all notes or a selection (indexes, pitch range, channel). One undo point; a refused call changes nothing. Returns how many notes moved and the average and largest shift in beats.\",\"params\":[\"trackIndex\",\"itemIndex\",\"notes\",\"pitchMin\",\"pitchMax\",\"channel\",\"grid\",\"strength\",\"swing\",\"window\",\"lengths\"]},{\"name\":\"transform_midi\",\"description\":\"Transform the notes of a MIDI item in one undo point: transpose (semitones, refused if any note would leave 0-127), velocity (set, scale, add, then clamp to min/max), humanize (random timing in beats and velocity, reproducible with seed), length (set in beats, scale, or legato = each note runs to the next selected note on its channel). Acts on all notes or a selection (indexes, pitch range, channel). Returns how many notes it acted on, velocities before/after and the humanize seed.\",\"params\":[\"trackIndex\",\"itemIndex\",\"notes\",\"pitchMin\",\"pitchMax\",\"channel\",\"transpose\",\"velocity\",\"humanize\",\"length\"]},{\"name\":\"import_midi_file\",\"description\":\"Import a Standard MIDI File (.mid/.midi, type 0 or 1, up to 5 MB and 20000 notes) as MIDI items, without REAPER's import dialog: notes and controllers of every file track merged into one item on trackIndex, or with newTracks each file track on a new track named after it, inserted at trackIndex. Placed at position (seconds) on the project grid; the file's tempo is reported, not applied (set it with set_project_tempo). Pitch bend, program changes, aftertouch and sysex are not imported; file.notImported counts them. One undo point.\",\"params\":[\"path\",\"trackIndex\",\"newTracks\",\"position\"]},{\"name\":\"detect_key\",\"description\":\"Detect the musical key (e.g. \\\"A minor\\\") of a track or an audio file: from a track's MIDI notes (note time weighted by velocity, drums on channel 10 ignored) or, for audio, from its chroma (Python sidecar; a track is read from its own items, before FX and pan, without a render). Returns the key, confidence 0..1 (how far it stands out from the next candidate that is not its relative key, scaled down for a flat profile and by how well the key fits — its correlation), the relative key, the top 3 alternatives with their correlation, and the 12-bin chroma (C first). Use it before writing parts, choosing a pitch-correction scale or a harmonizer key.\",\"params\":[\"trackIndex\",\"path\",\"itemIndex\",\"source\",\"startTime\",\"endTime\"]},{\"name\":\"detect_chords\",\"description\":\"Detect the chords of a track, one media item or an audio file, one per bar (default) or beat: from MIDI notes (drums on channel 10 ignored; the lowest held note gives slash chords like C/E) or from audio (Python sidecar chroma; a track is read from its own items, before FX and pan). Track bars and beats follow the project tempo map; a file uses `bpm` (bar 1 at startTime) or fixed windows. Returns the key, the progression (\\\"Am F C G\\\"), and chord spans (equal neighbours merged): start/end seconds, bar.beat, chord, root, quality (maj, min, 7, maj7, m7, sus2, sus4, dim, aug; the model also dim7, m7b5, 6, m6, 9, maj9, m9, mMaj7, 5, 11, 13), roman numeral in the key, bassMidi (a MIDI note for a bass line, E1-D#2) and a 0..1 fit; \\\"N\\\" = no chord. Paginated (offset/limit). Audio uses the chord model (lv-chordia, slash chords and sevenths from a full mix) when installed (setup-sidecar --with-chords), else chroma templates; `engine` picks. Use it before writing a bass line or other parts to existing guitars, keys or vocals.\",\"params\":[\"trackIndex\",\"path\",\"itemIndex\",\"source\",\"per\",\"engine\",\"startTime\",\"endTime\",\"bpm\",\"beatsPerBar\",\"windowSeconds\",\"offset\",\"limit\"]},{\"name\":\"transcribe_voice_sketch\",\"description\":\"Compose an editable musical draft from humming, singing, beatboxing, or a mixture. Local Python sidecar, no model download. Returns stable rounded BPM, sustained tempo changes, tentative key, separate monophonic melody and GM drum notes, repeated 4/4 drum patterns, and original file times. Timing snaps to a shared grid (default sixteenths); pitches snap to semitones, NOT to a guessed key. By default arrange:true adds a proposed intro/verse/chorus/outro, a kick/snare/hat groove using detected kick positions and hat accents, chord accompaniment, bass locked to the kicks, and the repeated detected melody. Those backing parts and sections are GENERATED, not recovered from the recording. No true audio source separation. arrange:false exports only the detected melody/percussion. key overrides accompaniment only, never retunes the melody. Experimental: drum labels and octaves need review; speech is not removed. Use startTime/endTime to isolate music. No REAPER changes. outputPath writes the FULL score as a type-1 .mid with tempo map and GM instruments. With soundfontPath also renders a sampled mix and separate 32-bit WAV instrument stems into <outputPath without .mid>-stems/. This optional preview needs the FluidSynth shared library and a user-supplied GM .sf2; no audio device or REAPER needed. Then use import_midi_file(newTracks:true) and assign instruments. That importer skips GM programs and does NOT apply the file tempo: use set_project_tempo/add_tempo_marker separately, or REAPER native MIDI import. Summary-first: note arrays default to 100 events per part; limit:0 returns only summaries. Export is never paginated. At most 120 seconds input, 64 bars output, 240 seconds for previews. Requires setup-sidecar (core only is enough).\",\"params\":[\"path\",\"startTime\",\"endTime\",\"mode\",\"bpm\",\"grid\",\"pitchMin\",\"pitchMax\",\"minNoteMs\",\"tempoChangeThreshold\",\"arrange\",\"bars\",\"key\",\"outputPath\",\"soundfontPath\",\"offset\",\"limit\"]},{\"name\":\"list_builtin_knowledge\",\"description\":\"List the built-in (read-only, curated) mix knowledge: plugin records and mixing lessons. Without query: summaries (key, tags, preview) — filter plugins by tags such as \\\"category::eq\\\" or \\\"fx::Pro-Q 3\\\". With query: full-text search returning full bodies. Combine with the user's own LoreKit layer (user:: keys), which overrides these.\",\"params\":[\"kind\",\"tags\",\"query\",\"limit\"]},{\"name\":\"get_builtin_knowledge\",\"description\":\"Read one built-in (read-only) record by key: \\\"plugins::<vendor>/<plugin>\\\" (e.g. \\\"plugins::fabfilter/pro-q-3\\\") or \\\"mixing-lessons::<slug>\\\". Returns null when the built-in layer has no such record. The user's own \\\"user::\\\" record of the same name, if any, overrides it.\",\"params\":[\"key\"]},{\"name\":\"report_plugin_research\",\"description\":\"Call once at the end of a plugin research run (the plugin-researcher's last step), after cleaning up the scratch track, also when the run stopped early. Records how the run went in pseudonymous usage telemetry as fixed values and counts — never the plugin's name. The result shows exactly what was sent. Changes nothing in REAPER.\",\"params\":[\"outcome\",\"category\",\"style\",\"format\",\"paramsTotal\",\"paramsProbed\",\"openQuestions\",\"sources\",\"cleanedUp\",\"caller\",\"batchSize\",\"scratchTag\"]},{\"name\":\"write_jsfx\",\"description\":\"Write a generated REAPER plugin (JSFX) as one self-contained file in Effects/reaper-mcp-generated/. Give the plugin source (header, unnamed sliders, @init/@slider/@block/@sample, a @gfx section using the ui_* toolkit): the toolkit is inlined for you, the file is linted first and nothing is written when a rule fails. Use it from the /make-plugin skill. The plugin works without this server or the bridge. An existing slider is never renumbered or re-ranged without breaking: true (saved automation would break). Old versions are kept outside Effects/.\",\"params\":[\"name\",\"source\",\"request\",\"overwrite\",\"breaking\",\"accent\",\"presets\"]},{\"name\":\"report_plugin_build\",\"description\":\"Call once at the end of a /make-plugin run, after the scratch track is deleted, also when the run stopped early. Records how it went in pseudonymous usage telemetry as fixed values and counts — never the plugin's name or what it does. The result shows exactly what was sent. Changes nothing in REAPER.\",\"params\":[\"outcome\",\"example\",\"rounds\",\"checksPassed\",\"checksFailed\",\"cleanedUp\",\"scratchTag\"]}],\"toolsHash\":\"121dabbfa8d670ed713f019c6ab0400deb80de41aea7d7827d860b3d92967e09\",\"wrote\":[\"/tmp/.reaper-mcp/update-check.json\",\"/tmp/.reaper-mcp/install-id\"],\"callsAt\":\"2026-11-16T11:31:55.716Z\",\"calls\":[{\"tool\":\"get_project_info\",\"ok\":false,\"ms\":7,\"bytes\":0,\"error\":\"tool reported an error: Error: Bridge not running: no REAPER settings in /tmp/.config/REAPER: REAPER is not installed there or has never been started. Start REAPER once (or set REAPER_RESOURCE_PATH to the folder REAPER shows\"},{\"tool\":\"get_render_settings\",\"ok\":false,\"ms\":19,\"bytes\":0,\"error\":\"tool reported an error: Error: Bridge not running: no REAPER settings in /tmp/.config/REAPER: REAPER is not installed there or has never been started. Start REAPER once (or set REAPER_RESOURCE_PATH to the folder REAPER shows\"},{\"tool\":\"get_project_settings\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Error: Bridge not running: no REAPER settings in /tmp/.config/REAPER: REAPER is not installed there or has never been started. Start REAPER once (or set REAPER_RESOURCE_PATH to the folder REAPER shows\"},{\"tool\":\"list_tracks\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Error: Bridge not running: no REAPER settings in /tmp/.config/REAPER: REAPER is not installed there or has never been started. Start REAPER once (or set REAPER_RESOURCE_PATH to the folder REAPER shows\"},{\"tool\":\"get_transport_state\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Error: Bridge not running: no REAPER settings in /tmp/.config/REAPER: REAPER is not installed there or has never been started. Start REAPER once (or set REAPER_RESOURCE_PATH to the folder REAPER shows\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmY1NDMzYmMzMDVmM2MxMzVjMjlkYzQ3NmFlYTI5ZmEwZjAzMDVkNDhhNzU5ODhmZDRmYjNjZmE4YTZhMmUxNDkiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTMyNCIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTAyNCwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjg3MjQsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiYzJjNzliNWYtNjcwOC00N2ZmLTkwNGItYzdmYWJkNTJjMTc4IiwibmJmIjoxNzk0ODI4NDI0LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.WvaiXeNpoApXJfCsYTpnD-DHR72WABEW24tYricZ0a8LMcu1dKMQCzq9Jk-H_scCAVZcN_ZIY6UK6jUx8XQUesZk38QKvXuuqwr82CnDZbZb4WszTModzxqj-T_s8cQioXJFBBPYJR8ElCw46NDifscjW35qWDv_z_IfffGc_SNNi857wEnW8fkq2n2-pxt7QU5OG_2WApqnBaNy4s39MyJI_987bGJDruDi8jp3D4GLoyj5OT2k7cjOEaHFTth3zV2VedhhOf3SrqCT9ATmb7tLVlgIjJayw6uHBPMHE8QdmaDGgoxUogEtEdeqlUOEWDwNjDA5cDh40RVXlpQqwA"}