KORG microKORG2: MIDI CC, NRPN and OSC map¶
The KORG microKORG2 as named OSC addresses — 79 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | KORG microKORG2 |
|---|---|
| Vendor | KORG |
| OSC prefix | /microkorg2 |
| 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/korg/microkorg2.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/korg/microkorg2.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 microkorg2: ask “what can the KORG microKORG2 do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (79)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/microkorg2/midi/bank_select_msb |
0 | 0–127 | continuous | MIDI | |
/microkorg2/midi/bank_select_lsb |
32 | 0–127 | continuous | MIDI | |
/microkorg2/midi/modulation_wheel |
1 | 0–127 | continuous | MIDI | |
/microkorg2/midi/data_entry_msb |
6 | 0–127 | continuous | MIDI | |
/microkorg2/midi/data_entry_lsb |
38 | 0–127 | continuous | MIDI | |
/microkorg2/midi/damper_pedal |
64 | 0–127 | continuous | MIDI | |
/microkorg2/midi/nrpn_msb |
99 | 0–127 | continuous | MIDI | |
/microkorg2/midi/nrpn_lsb |
98 | 0–127 | continuous | MIDI | |
/microkorg2/timbre/level |
7 | 0–127 | continuous | Timbre | |
/microkorg2/timbre/pan |
10 | 0–127 | continuous | Timbre | |
/microkorg2/pitch/portamento_time |
5 | 0–127 | continuous | Pitch | |
/microkorg2/pitch/portamento_mode |
65 | 0–127 | continuous | Pitch | |
/microkorg2/pitch/transpose |
35 | 0–127 | continuous | Pitch | |
/microkorg2/pitch/fine_tune |
36 | 0–127 | continuous | Pitch | |
/microkorg2/unison/detune |
33 | 0–127 | continuous | Unison | |
/microkorg2/unison/spread |
34 | 0–127 | continuous | Unison | |
/microkorg2/oscillator_1/wave |
8 | 0–127 | continuous | Oscillator 1 | |
/microkorg2/oscillator_1/shape |
9 | 0–127 | continuous | Oscillator 1 | |
/microkorg2/oscillator_1/modulation_amount |
15 | 0–127 | continuous | Oscillator 1 | |
/microkorg2/oscillator_1/semitones |
16 | 0–127 | continuous | Oscillator 1 | |
/microkorg2/oscillator_1/fine_tune |
17 | 0–127 | continuous | Oscillator 1 | |
/microkorg2/oscillator_1/level |
23 | 0–127 | continuous | Oscillator 1 | |
/microkorg2/oscillator_2/wave |
18 | 0–127 | continuous | Oscillator 2 | |
/microkorg2/oscillator_2/shape |
19 | 0–127 | continuous | Oscillator 2 | |
/microkorg2/oscillator_2/modulation_amount |
20 | 0–127 | continuous | Oscillator 2 | |
/microkorg2/oscillator_2/semitones |
21 | 0–127 | continuous | Oscillator 2 | |
/microkorg2/oscillator_2/fine_tune |
22 | 0–127 | continuous | Oscillator 2 | |
/microkorg2/oscillator_2/level |
24 | 0–127 | continuous | Oscillator 2 | |
/microkorg2/oscillator_3/wave |
48 | 0–127 | continuous | Oscillator 3 | |
/microkorg2/oscillator_3/shape |
49 | 0–127 | continuous | Oscillator 3 | |
/microkorg2/oscillator_3/semitones |
51 | 0–127 | continuous | Oscillator 3 | |
/microkorg2/oscillator_3/fine_tune |
52 | 0–127 | continuous | Oscillator 3 | |
/microkorg2/oscillator_3/level |
25 | 0–127 | continuous | Oscillator 3 | |
/microkorg2/noise/type |
29 | 0–127 | continuous | Noise | |
/microkorg2/noise/color |
30 | 0–127 | continuous | Noise | |
/microkorg2/noise/level |
26 | 0–127 | continuous | Noise | |
/microkorg2/filter/type |
27 | 0–127 | continuous | Filter | |
/microkorg2/filter/keytrack |
28 | 0–127 | continuous | Filter | |
/microkorg2/filter/cutoff |
74 | 0–127 | continuous | Filter | |
/microkorg2/filter/resonance |
71 | 0–127 | continuous | Filter | |
/microkorg2/filter/drive |
83 | 0–127 | continuous | Filter | |
/microkorg2/amplifier_envelope/attack |
73 | 0–127 | continuous | Amplifier envelope | |
/microkorg2/amplifier_envelope/decay |
75 | 0–127 | continuous | Amplifier envelope | |
/microkorg2/amplifier_envelope/sustain |
70 | 0–127 | continuous | Amplifier envelope | |
/microkorg2/amplifier_envelope/release |
72 | 0–127 | continuous | Amplifier envelope | |
/microkorg2/amplifier_envelope/velocity_sensitivity |
79 | 0–127 | continuous | Amplifier envelope | |
/microkorg2/filter_envelope/attack |
85 | 0–127 | continuous | Filter envelope | |
/microkorg2/filter_envelope/decay |
86 | 0–127 | continuous | Filter envelope | |
/microkorg2/filter_envelope/sustain |
87 | 0–127 | continuous | Filter envelope | |
/microkorg2/filter_envelope/release |
88 | 0–127 | continuous | Filter envelope | |
/microkorg2/filter_envelope/intensity |
84 | 0–127 | continuous | Filter envelope | |
/microkorg2/lfo_1/wave |
89 | 0–127 | continuous | LFO 1 | |
/microkorg2/lfo_1/frequency |
90 | 0–127 | continuous | LFO 1 | |
/microkorg2/lfo_1/smooth |
91 | 0–127 | continuous | LFO 1 | |
/microkorg2/lfo_2/wave |
102 | 0–127 | continuous | LFO 2 | |
/microkorg2/lfo_2/frequency |
76 | 0–127 | continuous | LFO 2 | |
/microkorg2/lfo_2/delay |
92 | 0–127 | continuous | LFO 2 | |
/microkorg2/virtual_patches/patch_1_intensity |
103 | 0–127 | continuous | Virtual patches | |
/microkorg2/virtual_patches/patch_2_intensity |
104 | 0–127 | continuous | Virtual patches | |
/microkorg2/virtual_patches/patch_3_intensity |
105 | 0–127 | continuous | Virtual patches | |
/microkorg2/virtual_patches/patch_4_intensity |
106 | 0–127 | continuous | Virtual patches | |
/microkorg2/virtual_patches/patch_5_intensity |
107 | 0–127 | continuous | Virtual patches | |
/microkorg2/virtual_patches/patch_6_intensity |
108 | 0–127 | continuous | Virtual patches | |
/microkorg2/modulation_effect/control_1 |
12 | 0–127 | continuous | Modulation effect | |
/microkorg2/modulation_effect/control_2 |
111 | 0–127 | continuous | Modulation effect | |
/microkorg2/modulation_effect/control_3 |
112 | 0–127 | continuous | Modulation effect | |
/microkorg2/delay_effect/control_1 |
115 | 0–127 | continuous | Delay effect | |
/microkorg2/delay_effect/control_2 |
13 | 0–127 | continuous | Delay effect | |
/microkorg2/delay_effect/control_3 |
113 | 0–127 | continuous | Delay effect | |
/microkorg2/delay_effect/control_4 |
114 | 0–127 | continuous | Delay effect | |
/microkorg2/reverb_effect/control_1 |
118 | 0–127 | continuous | Reverb effect | |
/microkorg2/reverb_effect/control_2 |
14 | 0–127 | continuous | Reverb effect | |
/microkorg2/reverb_effect/control_3 |
116 | 0–127 | continuous | Reverb effect | |
/microkorg2/reverb_effect/control_4 |
117 | 0–127 | continuous | Reverb effect | |
/microkorg2/eq/low_frequency |
95 | 0–127 | continuous | EQ | |
/microkorg2/eq/low_gain |
110 | 0–127 | continuous | EQ | |
/microkorg2/eq/high_frequency |
94 | 0–127 | continuous | EQ | |
/microkorg2/eq/high_gain |
109 | 0–127 | continuous | EQ | |
/microkorg2/eq/output_feedback |
93 | 0–127 | continuous | EQ |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /microkorg2/note/on <note> <velocity>, /microkorg2/cc/<number> <value>, /microkorg2/pitchbend <0-16383>, /microkorg2/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.