Skip to main content
Glama
Mooer Prime M2 MCP

Mooer Prime M2 MCP

by lucanenni

Mooer Prime M2 MCP

An MCP server that lets an AI assistant control a Mooer Prime M2 multi-effects pedal over USB. It offers the same functions as the companion browser editor, mooer-prime-m2-web, as tools you can ask for in plain language: "put a 808 and a plate reverb after the amp in preset 12", "back up all my presets", "set the tuner to 442 Hz".

Unofficial. Not affiliated with or endorsed by Mooer Audio. Use at your own risk, and read Safety first.

What it can do

  • Presets: list the 80 presets (optionally with their chains), read any preset with every parameter in real units, select, save, rename, copy, and build a whole preset from a list of effects in one step.

  • Effects: browse the catalog (all types and models, with each model's parameters), add, change, remove, reorder, switch on/off and edit parameters by name in dB, Hz, ms or semitones. Delay time and mod rate also take tempo-sync notes such as "1/8D".

  • Mixer and settings: channel levels, pan and switches, master section, Vocal FX, global CabSim/EQ/input gain, tuner, drum machine (pattern, tempo, play/stop), display, auto shutdown, footswitch, RGB light, Bluetooth name.

  • Looper: record/play/pause/undo/clear, song and volume, loop list, export loops to WAV and import WAV files.

  • Samples (experimental): list, export, import and delete cab IRs, drive, pre-amp and entire-amp files, including newer NAM A2 captures.

  • Backup and restore: export one preset or all 80, restore from .preset or bank files with read-back verification, audition a preset without storing it.

  • MIDI: read and edit the function assignments.

  • Advanced: raw system state, single-byte writes, restore of the session's initial state, factory reset.

Related MCP server: nux-mg30-mcp

Requirements

  • Node.js 20 or later.

  • A Mooer Prime M2 connected by USB. Close Mooer Studio and the web editor first: only one program can talk to the pedal at a time. Bluetooth is not supported.

  • macOS, Linux or Windows (USB access goes through node-hid, which ships prebuilt binaries).

Install

git clone https://github.com/lucanenni/mooer-prime-m2-mcp.git
cd mooer-prime-m2-mcp
npm install
npm run build

Register it with your MCP client.

Claude Code:

claude mcp add mooer-prime-m2 -- node /absolute/path/to/mooer-prime-m2-mcp/dist/index.js

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mooer-prime-m2": {
      "command": "node",
      "args": ["/absolute/path/to/mooer-prime-m2-mcp/dist/index.js"]
    }
  }
}

The server connects to the pedal on the first tool call and reconnects after you replug the cable.

Variable

Meaning

MOOER_DATA_DIR

Folder for backups, exports and relative file paths (default ~/mooer-prime-m2)

MOOER_DEMO=1

Use a simulated pedal instead of hardware (npm run demo)

Tools

Area

Tools

Status

get_status, get_settings, get_system_state

Presets

list_presets, get_preset, select_preset, save_preset, copy_preset, create_preset

Effects (edit buffer)

list_effect_catalog, add_effect, change_effect, remove_effect, move_effect, edit_effect

Mixer and settings

set_mixer, set_vocal_fx, set_global, set_tuner, set_drum, list_drum_patterns, set_display, set_bluetooth_name

Looper

looper_control, set_looper, list_loops, export_loop, import_loop

Samples

list_samples, export_sample, import_sample, delete_sample

Backup

backup_preset, backup_all_presets, restore_preset, audition_preset, end_audition

MIDI

midi_assignments, midi_edit

Advanced

set_system_byte, restore_system_state, factory_reset

Effects are addressed by type and model name ("Drive", "808") or id. Chain positions are 1-based; presets are 1-80 (0A is preset 1, 19D is preset 80).

Safety

  • Effect edits live in the pedal's edit buffer until save_preset; selecting another preset discards them.

  • Mixer, tuner, drum and other global settings are written to the pedal immediately. restore_system_state writes back the values read when the session started.

  • Every tool that replaces stored data (save_preset, copy_preset, restore_preset, create_preset with a slot, import_loop, import_sample, delete_sample) first saves the old content under <data dir>/backups/. Whole-preset writes are read back and verified. They need confirm: true; factory_reset needs confirm: "ERASE ALL".

  • What is verified on a real pedal, and what is not, follows the web editor's TESTING.md. Samples, the Bluetooth name and MIDI learn over USB are unverified or experimental. Older (non-A2) NAM captures are not supported.

Development

npm run dev      # run from source over stdio
npm run demo     # same, against the simulated pedal
npm test         # end-to-end tests of every tool area against the simulated pedal
npm run build    # type-check and bundle to dist/
npm run sync     # refresh src/protocol and src/demo from ../mooer-prime-m2-web

src/protocol and src/demo are copied unchanged from the web editor, which is the single source of truth for the protocol; see its docs/PROTOCOL.md. The tools live in src/tools, the unit conversions in src/settings.ts and src/effects.ts.

Credits and license

The protocol layer is inspired by, and partly derived from, andymann/mooer-prime-m2-app (MIT), through the web editor. The original copyright notice is kept in LICENSE.

Released under the MIT license.

Available Tools

42 tools
add_effectA

Add an effect to the active preset's edit buffer (not saved until save_preset). Appended to the chain unless position is given.

Inputs: type (required), model (required), params, position.

audition_presetA

Play a preset on the pedal without storing it (USB). Source: a .preset file, or an effects list. Call end_audition to leave it.

Inputs: file, name, effects.

backup_all_presetsA
Read-onlyIdempotent

Export all 80 presets to one bank JSON file (USB, takes a while).

Inputs: file.

backup_presetB
Read-onlyIdempotent

Export the stored version of one preset to a Mooer Studio .preset file (USB).

Inputs: preset (required), file.

change_effectA

Replace the effect in a slot with another type/model (parameters reset to the new model's defaults).

Inputs: slot (required), type (required), model (required), params.

copy_presetA
Destructive

Copy the stored version of one preset slot onto another (USB). The target's previous content is backed up and the write is verified.

Inputs: to (required), from (required).

create_presetA
Destructive

Build a whole preset from a list of effects in one step. Write it to a pedal slot (replaces that slot, previous content backed up), save it as a .preset file, or both. Parameters not given keep sensible defaults.

Inputs: name (required), effects (required), bpm, file, +2 more.

delete_sampleA
Destructive

Delete a sample slot's file (USB). The file is exported to backups first.

Inputs: kind (required), slot (required), confirm (required).

edit_effectA
Idempotent

Turn an effect on/off and/or set parameters by label in real units (dB, Hz, ms, semitones; delay time and mod rate also accept sync notes like "1/8D"). Edits go live immediately but are not stored until save_preset.

Inputs: slot (required), params, enabled, raw_words.

end_auditionA
Idempotent

Leave audition mode and return to the stored preset.

Inputs: no named parameters.

export_loopA
Read-onlyIdempotent

Save a loop to a 24-bit stereo 44.1 kHz WAV file (USB; a 30 s loop takes a while). The pedal's control data rides after the audio so import_loop can restore it exactly.

Inputs: loop (required), file.

export_sampleC
Read-onlyIdempotent

Save a sample slot to a file (USB): .gir / .gnr / .preamp / .entire raw data.

Inputs: kind (required), slot (required), file.

factory_resetA
Destructive

ERASES ALL presets and settings on the pedal and restores factory state. Back up first (backup_all_presets). Requires confirm = "ERASE ALL".

Inputs: confirm (required).

get_presetA
Read-onlyIdempotent

Full effect chain of a preset with every parameter in real units. Defaults to the active preset, where it shows the live edit buffer (including unsaved edits); other presets show the stored version.

Inputs: preset.

get_settingsA
Read-onlyIdempotent

All pedal-wide settings decoded in real units: mixer, vocal FX, global (CabSim, EQ, input gain), tuner, drum, looper, display/RGB.

Inputs: no named parameters.

get_statusA
Read-onlyIdempotent

Connection and pedal status: firmware, serial, battery, active preset, tempo, link type, and pending warnings. Connects to the pedal if needed.

Inputs: no named parameters.

get_system_stateA
Read-onlyIdempotent

Raw 99-byte system state (hex) next to the decoded settings, for exploring unmapped bytes.

Inputs: no named parameters.

import_loopA
Destructive

Upload a WAV into a loop slot (USB), replacing its content. WAVs of any common PCM format are converted to 24-bit stereo 44.1 kHz. A non-empty slot is first exported to the backups folder.

Inputs: file (required), loop (required), confirm (required), name.

import_sampleA
Destructive

Upload a file into a sample slot (USB), replacing its content (the old file is exported to backups first). Accepts: cab = .wav (first 1024 samples) or .gir; drive = .gnr/.drive; pre-amp = .preamp or NAM A2 .nam; entire-amp = .entire or NAM A2 .nam. Older (non-A2) NAM captures are not supported. Experimental: only NAM A2 into entire-amp is verified on hardware.

Inputs: file (required), kind (required), slot (required), confirm (required), +1 more.

list_drum_patternsA
Read-onlyIdempotent

Names of the drum patterns (number → name).

Inputs: no named parameters.

list_effect_catalogA
Read-onlyIdempotent

Effect types and models. Without arguments: the types with model counts. With type: every model (id and name) and the parameters of its default layout (label, unit, range). Parameters are edited by label with edit_effect. Models User 1…User 10 (ids 200…209) play the sample stored in that Samples slot (see list_samples).

Inputs: type, model.

list_loopsB
Read-onlyIdempotent

The 10 loop slots: empty/recorded, name, duration, sync.

Inputs: no named parameters.

list_presetsA
Read-onlyIdempotent

List the 80 presets (number, bank label such as 0A, name). With with_chains, also each preset's effect chain.

Inputs: with_chains.

list_samplesA
Read-onlyIdempotent

Samples stored on the pedal (USB): cab IRs, drive, pre-amp and entire-amp files, 10 slots each. Without kind, all four lists.

Inputs: kind.

looper_controlB

Looper buttons: record (keeps overdubbing until play), play, pause, undo (last rec session, in play mode), clear (deletes the loop). The pedal sends no confirmation.

Inputs: action (required), confirm.

midi_assignmentsA
Read-onlyIdempotent

The 20 MIDI-controllable functions and the CC/value assigned to each.

Inputs: no named parameters.

midi_editA
Destructive

Edit MIDI assignments. learn: the pedal listens up to 20 s for an incoming MIDI message for function N (verified over Bluetooth only; USB may not answer). remove: clear function N. save: store learned assignments. Seen on hardware: remove(6) then save also cleared function 1; check midi_assignments afterwards.

Inputs: action (required), function.

move_effectB

Move an effect from one chain position to another (like dragging it).

Inputs: to (required), from (required).

remove_effectA
Destructive

Remove the effect in a slot; later effects move up.

Inputs: slot (required).

restore_presetA
Destructive

Write a .preset file, or one preset of a bank JSON, into a pedal slot (USB). Replaces the slot: the previous content is backed up and the result is read back and verified.

Inputs: file (required), preset (required), confirm (required), bank_index.

restore_system_stateA
Destructive

Write back the system state read when the session started (undoes settings changes made through this server).

Inputs: no named parameters.

save_presetA
Destructive

Save the active preset's edit buffer into a slot (default: the current one), optionally renaming it. The previous content of the target slot is backed up to the data directory first.

Inputs: name, preset.

select_presetA
Idempotent

Switch the pedal to preset 1-80. Unsaved edits to the current preset are discarded.

Inputs: preset (required).

set_bluetooth_nameA
Idempotent

Rename the pedal's Bluetooth name (1-17 printable ASCII characters in all, including the fixed "M2" prefix the official app keeps). Takes effect after the pedal is switched off and on. Unverified.

Inputs: name (required).

set_displayC
Idempotent

Display and power: brightness (5-55), auto shutdown, footswitch page mode, and the RGB light (dynamic mode, brightness, colour 1-9, static speed, colour sequence).

Inputs: rgb, brightness, footswitch_page, auto_shutdown_minutes.

set_drumA
Idempotent

Drum machine: pattern (1-60; names come from list_drum_patterns), tempo in BPM (also the delay tempo), sync with looper, and start/stop.

Inputs: pattern, playing, tempo_bpm, sync_with_looper.

set_globalB
Idempotent

Global settings: CabSim, input gain, global EQ (4 bands) and where the delay tempo comes from.

Inputs: eq, cabsim, tempo_sync, input_gain_db.

set_looperD
Idempotent

Looper song (1-10) and volume (0-100).

Inputs: song, volume.

set_mixerA
Idempotent

Mixer: per-channel on/off, level (dB, -30…+6) and pan (-50 left … +50 right; pan only has effect with a stereo master), plus the master section. Settings are applied to the pedal immediately.

Inputs: master, channels.

set_system_byteA
Destructive

EXPERIMENTAL: write one raw byte of the system state (index 2-98; the preset byte and name are refused). Use restore_system_state to undo.

Inputs: index (required), value (required).

set_tunerB
Idempotent

Tuner reference pitch (430-445 Hz) and whether the output is muted while tuning.

Inputs: mute, reference_hz.

set_vocal_fxC
Idempotent

Vocal FX: compressor, EQ and reverb switches and values.

Inputs: eq, comp, reverb.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 42 tools

    Disambiguation4/5

    Most tools target a distinct resource+action and are easy to tell apart (preset CRUD, per-subsystem settings setters, looper, MIDI, samples). A few clusters risk misselection: change_effect vs add_effect/edit_effect, save_preset vs create_preset vs copy_preset, and backup_preset vs export_sample/export_loop all share similar semantics, though the descriptions do disambiguate them.

    Naming Consistency3/5

    The dominant pattern is verb_noun (get_status, list_presets, save_preset, add_effect, import_sample), which is readable and predictable. But conventions are mixed: parameter edits use both edit_effect and set_mixer/set_global/set_tuner, file export uses both backup_preset and export_loop/export_sample, and several tools are noun-only or odd (midi_assignments, looper_control, factory_reset, end_audition).

    Tool Count3/5

    42 tools is heavy for a single hardware pedal and pushes past the comfortable 3-15 band. The breadth is real (presets, effects, mixer, vocal FX, global, tuner, drums, display, system bytes, looper, MIDI, samples, Bluetooth), but the fine-grained per-subsystem setters (set_mixer, set_vocal_fx, set_global, set_tuner, set_drum, set_display) could plausibly be collapsed into fewer dispatchers.

    Completeness4/5

    Coverage is unusually thorough: full preset lifecycle including backup/restore/audition, effect chain manipulation, every settings subsystem, looper, MIDI assignments, sample slots and raw system state. The main gap is that there is no way to delete/clear a preset slot (only overwrite it), and per-effect inspection relies on get_preset rather than a targeted getter.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables controlling a Roland RC-505mk2 loop station via natural language, allowing creation and upload of FX rack presets to the device over USB.
      4
      MIT
    • 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.
      57 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI assistant to control a Sonicake Pocket Master guitar processor over USB MIDI by describing tones in plain words — selecting amp/cab/effect models, setting parameters, reordering the signal chain, and saving, renaming, backing up or restoring presets. It also provides offline tools for inspecting firmware and rebuilding it with a translated UI, such as Russian.
      58 PyPI
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables users to build and tweak BOSS GT-1 guitar tones and patches through plain-language conversation, with Claude writing amp, drive, and effect settings over USB. It can also listen to the pedal's audio, adjust levels and noise suppression, manage user slots, and run a metronome.
      MIT