Mooer Prime M2 MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MOOER_DEMO | No | Set to 1 to use a simulated pedal instead of hardware (`npm run demo`) | 0 |
| MOOER_DATA_DIR | No | Folder for backups, exports and relative file paths | ~/mooer-prime-m2 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_statusA | Connection and pedal status: firmware, serial, battery, active preset, tempo, link type, and pending warnings. Connects to the pedal if needed. |
| list_presetsA | List the 80 presets (number, bank label such as 0A, name). With with_chains, also each preset's effect chain. |
| get_presetA | 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. |
| select_presetA | Switch the pedal to preset 1-80. Unsaved edits to the current preset are discarded. |
| save_presetA | 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. |
| copy_presetA | Copy the stored version of one preset slot onto another (USB). The target's previous content is backed up and the write is verified. |
| create_presetA | 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. |
| backup_presetB | Export the stored version of one preset to a Mooer Studio .preset file (USB). |
| backup_all_presetsA | Export all 80 presets to one bank JSON file (USB, takes a while). |
| restore_presetA | 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. |
| 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. |
| end_auditionA | Leave audition mode and return to the stored preset. |
| get_settingsA | All pedal-wide settings decoded in real units: mixer, vocal FX, global (CabSim, EQ, input gain), tuner, drum, looper, display/RGB. |
| list_effect_catalogA | 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). |
| 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. |
| change_effectA | Replace the effect in a slot with another type/model (parameters reset to the new model's defaults). |
| remove_effectA | Remove the effect in a slot; later effects move up. |
| move_effectB | Move an effect from one chain position to another (like dragging it). |
| edit_effectA | 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. |
| set_mixerA | 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. |
| set_vocal_fxC | Vocal FX: compressor, EQ and reverb switches and values. |
| set_globalB | Global settings: CabSim, input gain, global EQ (4 bands) and where the delay tempo comes from. |
| set_tunerB | Tuner reference pitch (430-445 Hz) and whether the output is muted while tuning. |
| set_drumA | Drum machine: pattern (1-60; names come from list_drum_patterns), tempo in BPM (also the delay tempo), sync with looper, and start/stop. |
| list_drum_patternsA | Names of the drum patterns (number → name). |
| set_displayC | 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). |
| get_system_stateA | Raw 99-byte system state (hex) next to the decoded settings, for exploring unmapped bytes. |
| set_system_byteA | 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. |
| restore_system_stateA | Write back the system state read when the session started (undoes settings changes made through this server). |
| factory_resetA | ERASES ALL presets and settings on the pedal and restores factory state. Back up first (backup_all_presets). Requires confirm = "ERASE ALL". |
| 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. |
| set_looperD | Looper song (1-10) and volume (0-100). |
| list_loopsB | The 10 loop slots: empty/recorded, name, duration, sync. |
| export_loopA | 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. |
| import_loopA | 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. |
| midi_assignmentsA | The 20 MIDI-controllable functions and the CC/value assigned to each. |
| midi_editA | 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. |
| list_samplesA | Samples stored on the pedal (USB): cab IRs, drive, pre-amp and entire-amp files, 10 slots each. Without kind, all four lists. |
| export_sampleC | Save a sample slot to a file (USB): .gir / .gnr / .preamp / .entire raw data. |
| import_sampleA | 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. |
| delete_sampleA | Delete a sample slot's file (USB). The file is exported to backups first. |
| set_bluetooth_nameA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.