Skip to main content
Glama
Mooer Prime M2 MCP

Mooer Prime M2 MCP

by lucanenni

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MOOER_DEMONoSet to 1 to use a simulated pedal instead of hardware (`npm run demo`)0
MOOER_DATA_DIRNoFolder 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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