@mthines/reaper-mcp 0.15.0 → 0.17.0-beta.18.1

package/README.md

@@ -22,7 +22,7 @@ npx @mthines/reaper-mcp init --yes
 The `init` wizard walks you through:
 1. Installing the REAPER bridge (Lua + JSFX analyzers)
 2. Installing AI mix knowledge and agents
-3. Configuring Claude Code settings (auto-allows all 78 REAPER tools)
+3. Configuring Claude Code settings (auto-allows all 80 REAPER tools)
 4. Optionally creating a project-local `.mcp.json`
 
 Then load `mcp_bridge.lua` in REAPER and open Claude Code — you're ready to mix.
@@ -31,7 +31,7 @@ Then load `mcp_bridge.lua` in REAPER and open Claude Code — you're ready to mi
 
 ```
 Claude Code
-  ├── MCP Tools (67) ──→ controls REAPER in real-time
+  ├── MCP Tools (80) ──→ controls REAPER in real-time
   │   ├── Track management (list, get/set properties, arm, phase, input)
   │   ├── FX management (add/remove, get/set parameters, enable/offline, presets)
   │   ├── Transport (play, stop, record, cursor position)
@@ -43,7 +43,7 @@ Claude Code
   │   ├── MIDI editing (14 tools: notes, CC, items, analysis, batch ops)
   │   ├── Media items (11 tools: properties, split, move, trim, stretch)
   │   ├── Plugin discovery (list installed FX, search, presets)
-  │   ├── Snapshots (save/restore mixer state for A/B comparison)
+  │   ├── Snapshots (save/restore/delete mixer state for A/B comparison)
   │   └── Routing (sends, receives, bus structure)
   │
   └── Mix Engineer Knowledge ──→ knows HOW to use those tools
@@ -81,7 +81,7 @@ npx @mthines/reaper-mcp init
 The wizard guides you through selecting which components to install:
 - **REAPER Bridge** — Lua bridge + JSFX analyzers (copied to your REAPER resource folder)
 - **AI Skills & Agents** — knowledge base, mix agents, rules, skills (global or project-local)
-- **Claude Code Settings** — auto-allows all 78 REAPER tools (no permission prompts)
+- **Claude Code Settings** — auto-allows all 80 REAPER tools (no permission prompts)
 - **Project Config** — `.mcp.json` for the current directory (opt-in)
 
 For CI/automation, use `--yes` to skip prompts and install everything with defaults:
@@ -108,6 +108,7 @@ npx @mthines/reaper-mcp install-skills --project  # project-local alternative
 
 The `setup` command copies into your REAPER resource folder:
 - `mcp_bridge.lua` — persistent Lua bridge script
+- `mcp_snapshot_manager.lua` — snapshot manager GUI (save/restore/delete from REAPER)
 - `mcp_analyzer.jsfx` — FFT spectrum analyzer
 - `mcp_lufs_meter.jsfx` — ITU-R BS.1770 LUFS meter
 - `mcp_correlation_meter.jsfx` — stereo correlation analyzer
@@ -138,7 +139,7 @@ npx @mthines/reaper-mcp doctor
 
 Checks that the bridge is connected, knowledge is installed, and MCP config exists.
 
-## MCP Tools (67)
+## MCP Tools (80)
 
 ### Project & Tracks
 
@@ -250,6 +251,7 @@ Checks that the bridge is connected, knowledge is installed, and MCP config exis
 | `snapshot_save` | Save current mixer state (volumes, pans, FX, mutes) |
 | `snapshot_restore` | Restore a saved snapshot |
 | `snapshot_list` | List all saved snapshots |
+| `snapshot_delete` | Delete a saved snapshot by name |
 
 ### Routing
 
@@ -373,7 +375,7 @@ Processing decisions adapt to the genre:
 
 ## Autonomous Mode (Allow All Tools)
 
-By default Claude Code asks permission for each MCP tool call. The `init` command (and `install-skills`) automatically configures `settings.json` to allow all 78 REAPER tools. If you need to set this up manually, add to your project's `.claude/settings.json` (or `~/.claude/settings.json` for global):
+By default Claude Code asks permission for each MCP tool call. The `init` command (and `install-skills`) automatically configures `settings.json` to allow all 80 REAPER tools. If you need to set this up manually, add to your project's `.claude/settings.json` (or `~/.claude/settings.json` for global):
 
 ```json
 {
@@ -404,6 +406,7 @@ By default Claude Code asks permission for each MCP tool call. The `init` comman
       "mcp__reaper__snapshot_save",
       "mcp__reaper__snapshot_restore",
       "mcp__reaper__snapshot_list",
+      "mcp__reaper__snapshot_delete",
       "mcp__reaper__get_track_routing",
       "mcp__reaper__set_fx_enabled",
       "mcp__reaper__set_fx_offline",
@@ -525,7 +528,7 @@ Platform defaults:
 ```
 reaper-mcp/
 ├── apps/
-│   ├── reaper-mcp-server/        # MCP server (67 tools, esbuild bundle)
+│   ├── reaper-mcp-server/        # MCP server (80 tools, esbuild bundle)
 │   └── reaper-mix-agent/         # AI mix agent (knowledge loader, plugin resolver)
 ├── libs/protocol/                # Shared TypeScript types
 ├── knowledge/                    # AI mix engineer knowledge base
@@ -535,6 +538,7 @@ reaper-mcp/
 │   └── reference/                # Frequency, compression, metering, perceived loudness cheat sheets
 ├── reaper/                       # Files installed into REAPER
 │   ├── mcp_bridge.lua            # Persistent Lua bridge
+│   ├── mcp_snapshot_manager.lua  # Snapshot manager GUI (save/restore/delete)
 │   ├── mcp_analyzer.jsfx         # FFT spectrum analyzer
 │   ├── mcp_lufs_meter.jsfx       # LUFS meter (BS.1770)
 │   ├── mcp_correlation_meter.jsfx # Stereo correlation meter

package/claude-agents/mixer.md

@@ -28,7 +28,7 @@ You are a professional mix engineer with 20 years of experience working inside R
 
 ## Available MCP Tools
 
-You have access to 67 REAPER tools via the `reaper` MCP server:
+You have access to 80 REAPER tools via the `reaper` MCP server:
 
 ### Session Info
 - `get_project_info` — project name, tempo, time sig, sample rate, transport
@@ -70,6 +70,7 @@ You have access to 67 REAPER tools via the `reaper` MCP server:
 - `snapshot_save` — save mixer state
 - `snapshot_restore` — restore saved state
 - `snapshot_list` — list all snapshots
+- `snapshot_delete` — delete a saved snapshot
 
 ### Markers & Regions
 - `list_markers` — all project markers (index, name, position, color)

package/main.js

@@ -599,13 +599,39 @@ function registerFxTools(server) {
   );
   server.tool(
     "get_fx_parameters",
-    "List all parameters of an FX plugin with current values and ranges",
+    "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.",
+    {
+      trackIndex: z2.coerce.number().int().min(0).describe("Zero-based track index"),
+      fxIndex: z2.coerce.number().int().min(0).describe("Zero-based FX index in the chain"),
+      namePattern: z2.string().optional().describe('Filter params by name (case-insensitive substring match, e.g. "Gain", "Band 1")'),
+      changedOnly: z2.boolean().optional().describe("Only return params that appear non-default (value differs from minimum or formatted value suggests activity)"),
+      offset: z2.coerce.number().int().min(0).optional().describe("Skip first N matching params (default 0)"),
+      limit: z2.coerce.number().int().min(1).optional().describe("Max params to return (default all)")
+    },
+    async ({ trackIndex, fxIndex, namePattern, changedOnly, offset, limit }) => {
+      const res = await sendCommand("get_fx_parameters", {
+        trackIndex,
+        fxIndex,
+        namePattern,
+        changedOnly,
+        offset,
+        limit
+      });
+      if (!res.success) {
+        return { content: [{ type: "text", text: `Error: ${res.error}` }], isError: true };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    }
+  );
+  server.tool(
+    "analyze_fx",
+    "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.",
     {
       trackIndex: z2.coerce.number().int().min(0).describe("Zero-based track index"),
       fxIndex: z2.coerce.number().int().min(0).describe("Zero-based FX index in the chain")
     },
     async ({ trackIndex, fxIndex }) => {
-      const res = await sendCommand("get_fx_parameters", { trackIndex, fxIndex });
+      const res = await sendCommand("analyze_fx", { trackIndex, fxIndex });
       if (!res.success) {
         return { content: [{ type: "text", text: `Error: ${res.error}` }], isError: true };
       }
@@ -881,6 +907,20 @@ function registerSnapshotTools(server) {
       return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     }
   );
+  server.tool(
+    "snapshot_delete",
+    "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.",
+    {
+      name: z7.string().min(1).describe("Name of the snapshot to delete")
+    },
+    async ({ name }) => {
+      const res = await sendCommand("snapshot_delete", { name });
+      if (!res.success) {
+        return { content: [{ type: "text", text: `Error: ${res.error}` }], isError: true };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
+    }
+  );
 }
 
 // apps/reaper-mcp-server/src/tools/routing.ts
@@ -1960,7 +2000,7 @@ var TOOL_CATEGORIES = {
   fx: {
     name: "fx",
     description: "FX chain management: add, remove, inspect, and set parameters. Includes batch setup of an entire FX chain and batch parameter updates across multiple plugins.",
-    tools: ["add_fx", "remove_fx", "get_fx_parameters", "set_fx_parameter", "set_fx_enabled", "set_fx_offline", "setup_fx_chain", "set_multiple_fx_parameters"]
+    tools: ["add_fx", "remove_fx", "get_fx_parameters", "analyze_fx", "set_fx_parameter", "set_fx_enabled", "set_fx_offline", "setup_fx_chain", "set_multiple_fx_parameters"]
   },
   transport: {
     name: "transport",
@@ -2266,7 +2306,8 @@ var REAPER_ASSETS = [
   "mcp_analyzer.jsfx",
   "mcp_lufs_meter.jsfx",
   "mcp_correlation_meter.jsfx",
-  "mcp_crest_factor.jsfx"
+  "mcp_crest_factor.jsfx",
+  "mcp_snapshot_manager.lua"
 ];
 var MCP_TOOL_NAMES = [
   // project
@@ -2279,6 +2320,7 @@ var MCP_TOOL_NAMES = [
   "add_fx",
   "remove_fx",
   "get_fx_parameters",
+  "analyze_fx",
   "set_fx_parameter",
   // discovery
   "list_available_fx",
@@ -2303,6 +2345,7 @@ var MCP_TOOL_NAMES = [
   "snapshot_save",
   "snapshot_restore",
   "snapshot_list",
+  "snapshot_delete",
   // routing
   "get_track_routing",
   // midi
@@ -2452,21 +2495,23 @@ async function runInit(opts, dirResolver) {
     const scriptsDir = getReaperScriptsPath();
     mkdirSync2(scriptsDir, { recursive: true });
     const reaperDir = resolveAssetDir(__dirname2, "reaper");
-    const luaSrc = join4(reaperDir, "mcp_bridge.lua");
-    const luaDest = join4(scriptsDir, "mcp_bridge.lua");
-    if (installFile(luaSrc, luaDest)) {
-      console.log("  Installed: mcp_bridge.lua");
-    } else {
-      console.log(`  Not found: ${luaSrc}`);
+    for (const luaFile of ["mcp_bridge.lua", "mcp_snapshot_manager.lua"]) {
+      const src = join4(reaperDir, luaFile);
+      const dest = join4(scriptsDir, luaFile);
+      if (installFile(src, dest)) {
+        console.log(`  Installed: ${luaFile}`);
+      } else {
+        console.log(`  Not found: ${src}`);
+      }
     }
     const effectsDir = join4(getReaperEffectsPath(), "reaper-mcp");
     mkdirSync2(effectsDir, { recursive: true });
-    for (const jsfx of REAPER_ASSETS) {
-      if (jsfx === "mcp_bridge.lua") continue;
-      const src = join4(reaperDir, jsfx);
-      const dest = join4(effectsDir, jsfx);
+    for (const asset of REAPER_ASSETS) {
+      if (asset.endsWith(".lua")) continue;
+      const src = join4(reaperDir, asset);
+      const dest = join4(effectsDir, asset);
       if (installFile(src, dest)) {
-        console.log(`  Installed: reaper-mcp/${jsfx}`);
+        console.log(`  Installed: reaper-mcp/${asset}`);
       } else {
         console.log(`  Not found: ${src}`);
       }
@@ -2569,23 +2614,25 @@ async function setup() {
   const scriptsDir = getReaperScriptsPath();
   mkdirSync3(scriptsDir, { recursive: true });
   const reaperDir = resolveAssetDir(__dirname, "reaper");
-  const luaSrc = join5(reaperDir, "mcp_bridge.lua");
-  const luaDest = join5(scriptsDir, "mcp_bridge.lua");
-  console.log("Installing Lua bridge...");
-  if (installFile(luaSrc, luaDest)) {
-    console.log(`  Installed: mcp_bridge.lua`);
-  } else {
-    console.log(`  Not found: ${luaSrc}`);
+  console.log("Installing Lua scripts...");
+  for (const luaFile of ["mcp_bridge.lua", "mcp_snapshot_manager.lua"]) {
+    const src = join5(reaperDir, luaFile);
+    const dest = join5(scriptsDir, luaFile);
+    if (installFile(src, dest)) {
+      console.log(`  Installed: ${luaFile}`);
+    } else {
+      console.log(`  Not found: ${src}`);
+    }
   }
   const effectsDir = join5(getReaperEffectsPath(), "reaper-mcp");
   mkdirSync3(effectsDir, { recursive: true });
   console.log("\nInstalling JSFX analyzers...");
-  for (const jsfx of REAPER_ASSETS) {
-    if (jsfx === "mcp_bridge.lua") continue;
-    const src = join5(reaperDir, jsfx);
-    const dest = join5(effectsDir, jsfx);
+  for (const asset of REAPER_ASSETS) {
+    if (asset.endsWith(".lua")) continue;
+    const src = join5(reaperDir, asset);
+    const dest = join5(effectsDir, asset);
     if (installFile(src, dest)) {
-      console.log(`  Installed: reaper-mcp/${jsfx}`);
+      console.log(`  Installed: reaper-mcp/${asset}`);
     } else {
       console.log(`  Not found: ${src}`);
     }
@@ -2594,7 +2641,7 @@ async function setup() {
   console.log("Next steps:");
   console.log("  1. Open REAPER");
   console.log("  2. Actions > Show action list > Load ReaScript");
-  console.log(`  3. Select: ${luaDest}`);
+  console.log(`  3. Select: ${join5(scriptsDir, "mcp_bridge.lua")}`);
   console.log("  4. Run the script (it will keep running in background via defer loop)");
   console.log("  5. Add reaper-mcp to your Claude Code config (see: npx @mthines/reaper-mcp doctor)");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mthines/reaper-mcp",
-  "version": "0.15.0",
+  "version": "0.17.0-beta.18.1",
   "type": "module",
   "description": "MCP server for controlling REAPER DAW — real-time mixing, FX control, and frequency analysis for AI agents",
   "license": "MIT",

package/reaper/CLAUDE.md

@@ -7,6 +7,7 @@ Files installed INTO the REAPER DAW by the `setup` command. These run inside REA
 | File | Language | Purpose |
 |------|----------|---------|
 | `mcp_bridge.lua` | Lua | Persistent bridge: polls for JSON commands, executes ReaScript API, writes responses |
+| `mcp_snapshot_manager.lua` | Lua | Standalone snapshot manager GUI (gfx-based, save/restore/delete snapshots) |
 | `mcp_analyzer.jsfx` | JSFX/EEL2 | Real-time FFT spectrum analyzer, writes to gmem[] |
 | `mcp_lufs_meter.jsfx` | JSFX/EEL2 | LUFS loudness metering |
 | `mcp_correlation_meter.jsfx` | JSFX/EEL2 | Stereo correlation and width analysis |

package/reaper/install.sh

@@ -23,11 +23,13 @@ fi
 
 echo "REAPER resource path: $REAPER_PATH"
 
-# Install Lua bridge
+# Install Lua scripts
 SCRIPTS_DIR="$REAPER_PATH/Scripts"
 mkdir -p "$SCRIPTS_DIR"
 cp "$SCRIPT_DIR/mcp_bridge.lua" "$SCRIPTS_DIR/mcp_bridge.lua"
 echo "Installed: $SCRIPTS_DIR/mcp_bridge.lua"
+cp "$SCRIPT_DIR/mcp_snapshot_manager.lua" "$SCRIPTS_DIR/mcp_snapshot_manager.lua"
+echo "Installed: $SCRIPTS_DIR/mcp_snapshot_manager.lua"
 
 # Install JSFX analyzers
 EFFECTS_DIR="$REAPER_PATH/Effects/reaper-mcp"

package/reaper/mcp_bridge.lua

@@ -297,6 +297,155 @@ local function from_db(db)
   return 10 ^ (db / 20)
 end
 
+-- =============================================================================
+-- FX analysis helpers
+-- =============================================================================
+
+-- Heuristic: detect if a parameter appears to be non-default.
+-- REAPER has no TrackFX_GetParamDefault API, so we use multiple signals.
+-- Intentionally permissive — better to include false positives than miss changes.
+local function is_param_non_default(val, min_val, max_val, formatted)
+  local range = max_val - min_val
+  if range == 0 then return false end
+
+  -- Check formatted value for common "off/default" indicators
+  local lower = formatted:lower()
+  if lower == "off" or lower == "none" or lower == "unused"
+     or lower == "0.0 db" or lower == "0.00 db"
+     or lower == "0 %" or lower == "0.0 %" or lower == "0.00 %" then
+    return false
+  end
+
+  -- Value at exact minimum is often default for "disabled" params
+  if val == min_val then return false end
+
+  return true
+end
+
+-- Detect EQ band structure by finding groups of Freq/Gain/Q params per band.
+-- Works for ReaEQ, FabFilter Pro-Q, and most parametric EQs.
+local function analyze_eq_bands(all_params, param_count)
+  local bands = {}
+
+  for p = 0, param_count - 1 do
+    local par = all_params[p]
+    local name = par.name
+    local name_lower = name:lower()
+
+    -- Extract band number from patterns like "Band 1 Frequency", "1 Frequency"
+    local band_num = name:match("[Bb]and%s*(%d+)") or name:match("^(%d+)%s")
+    if band_num then
+      band_num = tonumber(band_num)
+      if not bands[band_num] then
+        bands[band_num] = { bandIndex = band_num - 1, paramIndices = {} }
+      end
+      local b = bands[band_num]
+      b.paramIndices[#b.paramIndices + 1] = p
+
+      if name_lower:find("freq") and not name_lower:find("side") then
+        b.frequency = par.formattedValue
+        b.freq_val = par.value
+      elseif name_lower:find("gain") and not name_lower:find("side")
+             and not name_lower:find("dynamic") then
+        b.gain = par.formattedValue
+        b.gain_val = par.value
+        b.gain_min = par.minValue
+        b.gain_max = par.maxValue
+      elseif name_lower:match("^%d+ q$") or name_lower:match("band %d+ q$")
+             or name_lower:find("bandwidth") then
+        b.q = par.formattedValue
+      elseif name_lower:find("type") or name_lower:find("shape") then
+        b.shape = par.formattedValue
+      elseif name_lower:find("enabled") or name_lower:find("active")
+             or name_lower:find("used") then
+        b.enabled_val = par.value
+        b.enabled_fmt = par.formattedValue
+      end
+    end
+  end
+
+  -- Filter to active/used bands only
+  local active_bands = {}
+  local sorted_keys = {}
+  for k, _ in pairs(bands) do sorted_keys[#sorted_keys + 1] = k end
+  table.sort(sorted_keys)
+
+  for _, k in ipairs(sorted_keys) do
+    local b = bands[k]
+    local is_active = true
+
+    -- Check explicit enabled/used flag
+    if b.enabled_val ~= nil then
+      if b.enabled_fmt then
+        local lower = b.enabled_fmt:lower()
+        if lower == "unused" or lower == "off" or lower == "disabled" then
+          is_active = false
+        else
+          is_active = true
+        end
+      else
+        is_active = b.enabled_val > 0.5
+      end
+    elseif b.gain_val ~= nil and b.gain_min ~= nil then
+      -- No enabled flag: check if gain is at midpoint (likely zero/default)
+      local gain_range = b.gain_max - b.gain_min
+      if gain_range > 0 then
+        local gain_norm = (b.gain_val - b.gain_min) / gain_range
+        is_active = math.abs(gain_norm - 0.5) > 0.01
+      end
+    end
+
+    if is_active then
+      active_bands[#active_bands + 1] = {
+        bandIndex = b.bandIndex,
+        enabled = true,
+        frequency = b.frequency or "?",
+        gain = b.gain or "?",
+        q = b.q or "?",
+        shape = b.shape or "?",
+        paramIndices = b.paramIndices,
+      }
+    end
+  end
+
+  return active_bands
+end
+
+-- Extract key compressor parameters by name matching.
+local function analyze_compressor(all_params, param_count)
+  local settings = {}
+  local patterns = {
+    { key = "threshold", pats = { "threshold" } },
+    { key = "ratio", pats = { "ratio" } },
+    { key = "attack", pats = { "attack" } },
+    { key = "release", pats = { "release" } },
+    { key = "makeup", pats = { "makeup", "make%-up", "make up", "output gain" } },
+    { key = "knee", pats = { "knee" } },
+  }
+
+  for p = 0, param_count - 1 do
+    local par = all_params[p]
+    local name_lower = par.name:lower()
+    for _, pat in ipairs(patterns) do
+      if not settings[pat.key] then
+        for _, pattern in ipairs(pat.pats) do
+          if name_lower:find(pattern) then
+            settings[pat.key] = {
+              index = par.index,
+              name = par.name,
+              value = par.value,
+              formattedValue = par.formattedValue,
+            }
+            break
+          end
+        end
+      end
+    end
+  end
+
+  return settings
+end
+
 -- =============================================================================
 -- Command handlers
 -- =============================================================================
@@ -508,16 +657,108 @@ function handlers.get_fx_parameters(params)
   if not track then return nil, "Track " .. idx .. " not found" end
 
   local param_count = reaper.TrackFX_GetNumParams(track, fx_idx)
-  local parameters = {}
 
+  -- Get FX name for context
+  local _, fx_name = reaper.TrackFX_GetFXName(track, fx_idx)
+
+  -- Optional filters
+  local name_pattern = params.namePattern
+  if name_pattern then name_pattern = name_pattern:lower() end
+  local changed_only = params.changedOnly
+
+  -- Collect matching params
+  local matched = {}
   for p = 0, param_count - 1 do
     local _, pname = reaper.TrackFX_GetParamName(track, fx_idx, p)
     local val, min_val, max_val = reaper.TrackFX_GetParam(track, fx_idx, p)
     local _, formatted = reaper.TrackFX_GetFormattedParamValue(track, fx_idx, p)
 
-    parameters[#parameters + 1] = {
+    local include = true
+
+    -- Name filter: case-insensitive substring
+    if name_pattern and not pname:lower():find(name_pattern, 1, true) then
+      include = false
+    end
+
+    -- Changed-only filter
+    if include and changed_only then
+      include = is_param_non_default(val, min_val, max_val, formatted or "")
+    end
+
+    if include then
+      matched[#matched + 1] = {
+        index = p,
+        name = pname,
+        value = val,
+        formattedValue = formatted or "",
+        minValue = min_val,
+        maxValue = max_val,
+      }
+    end
+  end
+
+  -- Pagination (applied after filtering)
+  local req_offset = params.offset or 0
+  local total_matched = #matched
+  local start_idx = math.min(req_offset + 1, total_matched + 1)
+  local end_idx = total_matched
+  if params.limit then
+    end_idx = math.min(start_idx + params.limit - 1, total_matched)
+  end
+
+  local result_params = {}
+  for i = start_idx, end_idx do
+    result_params[#result_params + 1] = matched[i]
+  end
+
+  return {
+    trackIndex = idx,
+    fxIndex = fx_idx,
+    fxName = fx_name or "",
+    parameterCount = param_count,
+    matchedCount = total_matched,
+    returned = #result_params,
+    offset = req_offset,
+    hasMore = end_idx < total_matched,
+    parameters = result_params,
+  }
+end
+
+function handlers.analyze_fx(params)
+  local idx = params.trackIndex
+  local fx_idx = params.fxIndex
+  if not idx or not fx_idx then
+    return nil, "trackIndex and fxIndex required"
+  end
+
+  local track = reaper.GetTrack(0, idx)
+  if not track then return nil, "Track " .. idx .. " not found" end
+
+  local param_count = reaper.TrackFX_GetNumParams(track, fx_idx)
+  if param_count == 0 then return nil, "FX " .. fx_idx .. " not found or has no parameters" end
+
+  local _, fx_name = reaper.TrackFX_GetFXName(track, fx_idx)
+  local _, preset_name = reaper.TrackFX_GetPreset(track, fx_idx)
+
+  -- Detect plugin type from name
+  local fx_lower = (fx_name or ""):lower()
+  local plugin_type = "generic"
+  if fx_lower:find("eq") or fx_lower:find("pro%-q") or fx_lower:find("equaliz") then
+    plugin_type = "eq"
+  elseif fx_lower:find("comp") or fx_lower:find("pro%-c") or fx_lower:find("1176")
+         or fx_lower:find("la%-2a") or fx_lower:find("limiter") or fx_lower:find("pro%-l") then
+    plugin_type = "compressor"
+  end
+
+  -- Read all params once
+  local all_params = {}
+  for p = 0, param_count - 1 do
+    local _, pname = reaper.TrackFX_GetParamName(track, fx_idx, p)
+    local val, min_val, max_val = reaper.TrackFX_GetParam(track, fx_idx, p)
+    local _, formatted = reaper.TrackFX_GetFormattedParamValue(track, fx_idx, p)
+    all_params[p] = {
       index = p,
-      name = pname,
+      name = pname or "",
       value = val,
       formattedValue = formatted or "",
       minValue = min_val,
@@ -525,11 +766,67 @@ function handlers.get_fx_parameters(params)
     }
   end
 
+  local notable = {}
+  local eq_bands = nil
+  local comp_settings = nil
+
+  if plugin_type == "eq" then
+    eq_bands = analyze_eq_bands(all_params, param_count)
+    -- Notable params = non-band params that are non-default
+    for p = 0, param_count - 1 do
+      local par = all_params[p]
+      local name_lower = par.name:lower()
+      if not name_lower:find("band") and not name_lower:match("^%d+ ")
+         and is_param_non_default(par.value, par.minValue, par.maxValue, par.formattedValue) then
+        notable[#notable + 1] = {
+          index = par.index, name = par.name,
+          value = par.value, formattedValue = par.formattedValue,
+        }
+      end
+    end
+  elseif plugin_type == "compressor" then
+    comp_settings = analyze_compressor(all_params, param_count)
+    -- Notable = all non-default, non-core-compressor params
+    local core_names = {}
+    if comp_settings then
+      for _, v in pairs(comp_settings) do
+        if v and v.index then core_names[v.index] = true end
+      end
+    end
+    for p = 0, param_count - 1 do
+      local par = all_params[p]
+      if not core_names[p]
+         and is_param_non_default(par.value, par.minValue, par.maxValue, par.formattedValue) then
+        notable[#notable + 1] = {
+          index = par.index, name = par.name,
+          value = par.value, formattedValue = par.formattedValue,
+        }
+      end
+    end
+  else
+    -- Generic: return all non-default params
+    for p = 0, param_count - 1 do
+      local par = all_params[p]
+      if is_param_non_default(par.value, par.minValue, par.maxValue, par.formattedValue) then
+        notable[#notable + 1] = {
+          index = par.index, name = par.name,
+          value = par.value, formattedValue = par.formattedValue,
+        }
+      end
+    end
+  end
+
   return {
     trackIndex = idx,
     fxIndex = fx_idx,
+    fxName = fx_name or "",
+    presetName = preset_name or "",
     parameterCount = param_count,
-    parameters = parameters,
+    notableParamCount = #notable,
+    pluginType = plugin_type,
+    eqBands = eq_bands,
+    compressorSettings = comp_settings,
+    notableParams = notable,
   }
 end
 
@@ -1129,6 +1426,26 @@ function handlers.snapshot_list(params)
   return { snapshots = snapshots, total = #snapshots, storageLocation = get_snapshot_storage_location() }
 end
 
+function handlers.snapshot_delete(params)
+  local name = params.name
+  if not name or name == "" then
+    return nil, "name required"
+  end
+
+  local path = snapshot_path(name)
+  local content = read_file(path)
+  if not content then
+    return nil, "Snapshot not found: " .. name
+  end
+
+  local ok, err = os.remove(path)
+  if not ok then
+    return nil, "Failed to delete snapshot: " .. (err or "unknown error")
+  end
+
+  return { name = name, deleted = true }
+end
+
 -- =============================================================================
 -- Routing handler
 -- =============================================================================