Mooer Prime M2 MCP
Provides tools to read and edit the pedal's MIDI function assignments (MIDI learn), letting an assistant inspect and reconfigure how external MIDI controllers map to the Mooer Prime M2's functions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mooer Prime M2 MCP add an 808 and a plate reverb after the amp in preset 12"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
.presetor 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 buildRegister it with your MCP client.
Claude Code:
claude mcp add mooer-prime-m2 -- node /absolute/path/to/mooer-prime-m2-mcp/dist/index.jsClaude 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 |
| Folder for backups, exports and relative file paths (default |
| Use a simulated pedal instead of hardware ( |
Tools
Area | Tools |
Status |
|
Presets |
|
Effects (edit buffer) |
|
Mixer and settings |
|
Looper |
|
Samples |
|
Backup |
|
MIDI |
|
Advanced |
|
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_statewrites back the values read when the session started.Every tool that replaces stored data (
save_preset,copy_preset,restore_preset,create_presetwith 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 needconfirm: true;factory_resetneedsconfirm: "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-websrc/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 toolsadd_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_presetsARead-onlyIdempotent
Export all 80 presets to one bank JSON file (USB, takes a while).
Inputs: file.
backup_presetBRead-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_presetADestructive
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_presetADestructive
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_sampleADestructive
Delete a sample slot's file (USB). The file is exported to backups first.
Inputs: kind (required), slot (required), confirm (required).
edit_effectAIdempotent
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_auditionAIdempotent
Leave audition mode and return to the stored preset.
Inputs: no named parameters.
export_loopARead-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_sampleCRead-onlyIdempotent
Save a sample slot to a file (USB): .gir / .gnr / .preamp / .entire raw data.
Inputs: kind (required), slot (required), file.
factory_resetADestructive
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_presetARead-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_settingsARead-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_statusARead-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_stateARead-onlyIdempotent
Raw 99-byte system state (hex) next to the decoded settings, for exploring unmapped bytes.
Inputs: no named parameters.
import_loopADestructive
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_sampleADestructive
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_patternsARead-onlyIdempotent
Names of the drum patterns (number → name).
Inputs: no named parameters.
list_effect_catalogARead-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_loopsBRead-onlyIdempotent
The 10 loop slots: empty/recorded, name, duration, sync.
Inputs: no named parameters.
list_presetsARead-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_samplesARead-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_assignmentsARead-onlyIdempotent
The 20 MIDI-controllable functions and the CC/value assigned to each.
Inputs: no named parameters.
midi_editADestructive
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_effectADestructive
Remove the effect in a slot; later effects move up.
Inputs: slot (required).
restore_presetADestructive
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_stateADestructive
Write back the system state read when the session started (undoes settings changes made through this server).
Inputs: no named parameters.
save_presetADestructive
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_presetAIdempotent
Switch the pedal to preset 1-80. Unsaved edits to the current preset are discarded.
Inputs: preset (required).
set_bluetooth_nameAIdempotent
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_displayCIdempotent
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_drumAIdempotent
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_globalBIdempotent
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_looperDIdempotent
Looper song (1-10) and volume (0-100).
Inputs: song, volume.
set_mixerAIdempotent
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_byteADestructive
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_tunerBIdempotent
Tuner reference pitch (430-445 Hz) and whether the output is muted while tuning.
Inputs: mute, reference_hz.
set_vocal_fxCIdempotent
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
Scored across 42 tools
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.
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).
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.
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
Related MCP Connectors
AI music production assistant — audio profiling, AI mixing sessions, and service inquiries.
Compose, mix, master and export in Logic Pro, REAPER or Ableton Live by talking to an AI engineer.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Make AI Tracks, loops and sound effects, split stems, build drum kits and master songs.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables controlling a Roland RC-505mk2 loop station via natural language, allowing creation and upload of FX rack presets to the device over USB.4MIT
- AlicenseNot gradedqualityBmaintenanceLets 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 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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 PyPI2MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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