Skip to main content
Glama
WaveMind Preset MCP

WaveMind Preset MCP

by Hemir95

WaveMind Preset MCP

A Model Context Protocol server that creates and manages presets for WaveMind NAM Universal II (the free NAM plugin that chains Pedal NAM → Amp NAM → 4 Cabinet IR slots → EQ → FX) by writing the plugin's own preset files directly — no GUI automation, no host DAW tricks.

How it works

WaveMind NAM Universal II stores user presets as plain XML:

%APPDATA%\WaveMind\NAM Universal II\Presets\User\<name>.preset

The root <PARAMETERS> element carries the slot file paths as attributes:

Attribute

Slot

profileFileAmplifiers

Amplifier .nam capture

profileFilePedals

Pedal .nam capture (optional)

impulseFile0..3

Cabinet IR .wav files (up to 4, optional)

plus ~177 <PARAM id="..." value="..."/> children: amp EQ (bass/mid/treble/presence), gate, IntellEQ, per-slot level/pan/mic/IR-shift/HPF/LPF, delay, reverb, chorus, compressor...

The visible preset name = the file name, and the plugin picks up new/edited/deleted .preset files live — no restart needed. So an agent (or a script) can generate complete presets pointing at an organized capture library, and they appear in the plugin instantly.

Related MCP server: nux-mg30-mcp

Setup

Install (either way):

# with uv/uvx (recommended - no install step, cached)
uvx wavemind-preset-mcp

# or classic pip
pip install wavemind-preset-mcp
  1. Create the template: open WaveMind NAM Universal II in any DAW, load anything, and save a preset. Then copy that .preset file to this repo's folder as wavemind_mcp/plantilla.preset (or point WAVEMIND_TEMPLATE at it). The template provides the full parameter list. (A placeholder template ships with the package — it has the correct parameter ids but points at dummy paths, so a real one from your plugin is strongly recommended.)

  2. (Optional) Organize your library: put your .nam captures and .wav IRs in folders and point WAVEMIND_NAM_DIR / WAVEMIND_IR_DIR at them (used by the search/inventory tools).

MCP configuration

{
  "mcpServers": {
    "wavemind": {
      "command": "uvx",
      "args": ["wavemind-preset-mcp"],
      "env": {
        "WAVEMIND_NAM_DIR": "C:\\Music\\NAMs",
        "WAVEMIND_IR_DIR": "C:\\Music\\IRs"
      }
    }
  }
}

Tools

Tool

What it does

create_preset

Write a new .preset: amp + optional pedal + up to 4 cab IRs + any parameters

list_presets

List user presets with their amp/pedal/cab slots

read_preset

Inspect a preset (slots + key parameters)

delete_preset

Delete a preset

list_param_ids

The full valid parameter catalog from the template

buscar_biblioteca

Search the organized capture library by text

categorias_biblioteca

Inventory the library (categories + counts)

Built-in engineering defaults

Every generated preset gets, unless overridden:

  • Solo OFF on all 4 cabinet slots (a soloed slot mutes the rest of the chain)

  • Stereo balance: symmetric L/R pairs (2 cabs), centered main + equal sides (3), or wide pair

    • centered fillers (4) — so no earpiece ends up silent

  • Phase/time alignment + 90 Hz HPF on every populated slot (AlignComp, IRShift, HPF) — blending unaligned IRs causes low-frequency comb filtering (a "wobble"); this kills it

Tips

  • Documented per-song amp settings for popular records exist on sites like ToneMirror and TonesMatch — use them as the params for create_preset instead of guessing.

  • Remember input calibration: each .nam capture was taken at a specific input level (often stated in its Tone3000 page). If an amp sounds under/over-distorted, calibrate your interface's input level first.

  • Tone3000 hosts free NAM captures; the download URLs are public and the IDs live in each tone page's payload.

Disclaimer

This is an independent community tool. It is not affiliated with or endorsed by WaveMind, Tone3000, or any plugin vendor. "NAM" refers to the open Neural Amp Modeler format.

Available Tools

7 tools
buscar_bibliotecaBuscar BibliotecaC

Search the organized capture library. tipo: 'nam', 'ir' or 'all'.

Inputs: texto (required), tipo. Returns: result

categorias_bibliotecaCategorias BibliotecaB

Inventory the organized library: NAM categories and IR collections with counts.

Inputs: no named parameters. Returns: result

create_presetCreate PresetA

Create a WaveMind preset (.preset XML written to the User presets folder; the plugin lists it live, no restart).

nombre: visible preset name (becomes the file name). ampli_nam: absolute path to the amplifier .nam capture (AMPLIFIER slot). pedal_nam: absolute path to a pedal .nam capture (PEDALS slot), optional. cab1..cab4: absolute paths to cabinet IR .wav files, optional. params: dict of plugin parameter ids to set (run list_param_ids for the full catalog), e.g. {"gate_active": "1.0", "gateThreshold": "-52.0", "amplifier_bass": "5.5", "intelleq_bite": "2.5"}.

Inputs: nombre (required), ampli_nam (required), cab1, cab2, +4 more. Returns: result

delete_presetDelete PresetC

Delete a user preset.

Inputs: nombre (required). Returns: result

list_param_idsList Param IdsA

List every valid parameter id from the template (usable in create_preset params).

Inputs: no named parameters. Returns: result

list_presetsList PresetsA

List user presets with their amp/pedal/cab slots.

Inputs: no named parameters. Returns: result

read_presetRead PresetB

Read a preset: slot file paths and key parameters.

Inputs: nombre (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 7 tools

    Disambiguation4/5

    The four preset tools (list/read/create/delete) target clearly distinct operations, and list_param_ids is a distinct helper for create_preset. The two library tools (buscar_biblioteca search vs categorias_biblioteca inventory) overlap somewhat since both explore the same library, but their purposes are distinguishable.

    Naming Consistency3/5

    Five tools follow a clean English verb_noun pattern (list_presets, read_preset, create_preset, delete_preset, list_param_ids), but the two library tools switch to Spanish, and categorias_biblioteca is noun-oriented rather than verb_noun, breaking the pattern.

    Tool Count5/5

    Seven tools is well-scoped for a preset management server, with each tool covering a distinct preset lifecycle action or a supporting library/parameter lookup.

    Completeness3/5

    Create, read, delete, list, and parameter discovery are covered, but there is no update/edit_preset operation, so modifying an existing preset's slots or params is a notable gap. Library browsing and search are present but no cleanup/delete for library entries.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets AI assistants control a NUX MG-30 guitar processor over USB MIDI by picking amp, cab, drive, modulation, delay and reverb models, toggling blocks, and setting knobs by name. It can also read, save, rename, back up and restore presets on the device, and apply whole tone recipes from JSON patch files.
      31 PyPI
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A local stdio MCP server that lets a client list, load, copy, create, rename, and save guitar presets, select and tweak 44 amp/effect models with bypass, set master and channel mixer levels, and drive practice tools like drums, metronome, tuner, and guarded looper controls on a JBL BandBox Trio over Bluetooth. It exposes 21 named tools alongside a browser GUI sharing the same controller, requiring no cloud account, phone, or JBL One app at runtime.
      1
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables AI clients such as Claude to compose, arrange, sound-design and mix inside Ableton Live, with loudness/true-peak measurements from real bounces and reference matching. It also lets users summarise, lint, diff and export Live Sets offline while Live is closed, with every tool marked read-only or destructive and destructive batches run as a single undo step.
      148
      MIT