Meris Mercury7 MIDI CC chart, NRPN and OSC map¶
The Meris Mercury7 MIDI implementation: 16 CC, each named, for Claude (MCP), SuperCollider or any OSC app.
| Device | Meris Mercury7 |
|---|---|
| Vendor | Meris |
| OSC prefix | /mercury7 |
| Source | 📦 Derived from MIDI Guide (community CC/NRPN data) |
| Firmware | unknown |
| Revision | per pencilresearch canonical CSV |
| Upstream | pencilresearch |
| Data licence | CC-BY-SA-4.0 — MIDI Guide (https://midi.guide) by Pencil Research and contributors |
| Driver file | devices/meris/mercury7.pencilresearch.fw-unknown.json |
Not tested on the device yet
This driver comes from documentation or community data and has not been checked on real hardware. If you own one, a quick test and a pull request promoting it helps everyone — see CONTRIBUTING.
How do you control it?¶
Find the MIDI ports, then start the bridge with this driver:
osc-bridge detect # prints the ready-to-run line for what is plugged in
osc-bridge run --device devices/meris/mercury7.pencilresearch.fw-unknown.json --out-port <N> --in-port <M>
Then send OSC to 127.0.0.1:7777, for example:
From Claude or any MCP client, the osc-bridge mcp server exposes this driver as mercury7: ask “what can the Meris Mercury7 do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (16)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/mercury7/expression/pedal |
4 | 0–127 | continuous | Expression | |
/mercury7/footswitches/bypass |
14 | 0–127 | continuous | Footswitches | |
/mercury7/knobs/space_decay |
16 | 0–127 | continuous | Knobs | |
/mercury7/knobs/modulate |
17 | 0–127 | continuous | Knobs | |
/mercury7/knobs/mix |
18 | 0–127 | continuous | Knobs | |
/mercury7/knobs/lo_frequency |
19 | 0–127 | continuous | Knobs | |
/mercury7/knobs/pitch_vector |
20 | 0–127 | continuous | Knobs | |
/mercury7/knobs/hi_frequency |
21 | 0–127 | continuous | Knobs | |
/mercury7/alt_functions/predelay |
22 | 0–127 | continuous | Alt functions | |
/mercury7/alt_functions/mod_speed |
23 | 0–127 | continuous | Alt functions | |
/mercury7/alt_functions/pitch_vector_mix |
24 | 0–127 | continuous | Alt functions | |
/mercury7/alt_functions/density |
25 | 0–127 | continuous | Alt functions | |
/mercury7/alt_functions/attack_time |
26 | 0–127 | continuous | Alt functions | |
/mercury7/alt_functions/vibrato_depth |
27 | 0–127 | continuous | Alt functions | |
/mercury7/footswitches/swell |
28 | 0–127 | continuous | Footswitches | |
/mercury7/footswitches/algorithm_select |
29 | 0–127 | continuous | Footswitches |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /mercury7/note/on <note> <velocity>, /mercury7/cc/<number> <value>, /mercury7/pitchbend <0-16383>, /mercury7/program_change <n>.
Limitations¶
CC/NRPN only. SysEx (preset management, display control, bulk dump/load, vendor-proprietary opcodes) is NOT covered by pencilresearch. To extend this device with SysEx, sniff the vendor editor, add `sysex.header/footer` + `commands` blocks, and use `update_device.md` PR template.
Frequently asked questions¶
How many parameters of the Meris Mercury7 can be controlled over MIDI?
SynthHub's map of the Meris Mercury7 lists 16 MIDI CC parameters, each with its number, range and a readable name; the full chart is on this page.
Can an AI agent like Claude control the Meris Mercury7?
Yes: SynthHub's hosted MCP server knows the Meris Mercury7's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.