Akai Z8 MIDI CC chart, NRPN and OSC map¶
The Akai Z8 MIDI implementation: 11 CC, 75 SysEx commands, each named, for Claude (MCP), SuperCollider or any OSC app.
| Device | Akai Z8 |
|---|---|
| Vendor | Akai |
| OSC prefix | /akai_z8 |
| Source | 🎛️ Derived from an Electra One community preset |
| Revision | per Electra preset |
| Upstream | electra-preset |
| Driver file | devices/akai/akai_z8.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/akai/akai_z8.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 akai_z8: ask “what can the Akai Z8 do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (11)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/akai_z8/1_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/2_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/3_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/4_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/5_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/6_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/source_midi |
28 | 0–127 | continuous | ||
/akai_z8/source_midi |
29 | 0–127 | continuous | ||
/akai_z8/source_midi |
30 | 0–127 | continuous | ||
/akai_z8/set_dest |
31 | 0–127 | continuous | ||
/akai_z8/depth |
32 | 0–127 | continuous |
SysEx commands (75)¶
| OSC address | Arguments |
|---|---|
/akai_z8/program_screen |
val: u7 |
/akai_z8/sets_curr_kg |
val: u7 |
/akai_z8/sets_to_all |
val: u7 |
/akai_z8/kg_select |
val: u7 |
/akai_z8/prog_no |
val: u7 |
/akai_z8/filter_type |
val: u7 |
/akai_z8/filter_freq |
val: u7 |
/akai_z8/res |
val: u7 |
/akai_z8/amplitude |
val: u7 |
/akai_z8/filter_env |
val: u7 |
/akai_z8/aux_env |
val: u7 |
/akai_z8/lfo_1_2 |
val: u7 |
/akai_z8/rate |
val: u7 |
/akai_z8/depth |
val: u7 |
/akai_z8/waveform |
val: u7 |
/akai_z8/delay |
val: u7 |
/akai_z8/lfo_phase |
val: u7 |
/akai_z8/re_trigger |
val: u7 |
/akai_z8/lfo_sync |
val: u7 |
/akai_z8/midi_sync |
val: u7 |
/akai_z8/sync_value |
val: u7 |
/akai_z8/portamento |
val: u7 |
/akai_z8/mono_legato |
val: u7 |
/akai_z8/porta_time |
val: u7 |
/akai_z8/multi_tempo |
val: u7 |
/akai_z8/prog_monitor |
val: u7 |
/akai_z8/multi_button |
val: u7 |
/akai_z8/slot_no |
val: u7 |
/akai_z8/mod_source |
val: u7 |
/akai_z8/cc_no |
val: u7 |
/akai_z8/destination |
val: u7 |
/akai_z8/key_group |
val: u7 |
/akai_z8/mute_1 |
val: u7 |
/akai_z8/mute_2 |
val: u7 |
/akai_z8/mute_3 |
val: u7 |
/akai_z8/mute_4 |
val: u7 |
/akai_z8/mute_5 |
val: u7 |
/akai_z8/mute_6 |
val: u7 |
/akai_z8/solo_1 |
val: u7 |
/akai_z8/solo_2 |
val: u7 |
/akai_z8/solo_3 |
val: u7 |
/akai_z8/solo_4 |
val: u7 |
/akai_z8/solo_5 |
val: u7 |
/akai_z8/solo_6 |
val: u7 |
/akai_z8/ouputs |
val: u7 |
/akai_z8/volume_1 |
val: u7 |
/akai_z8/volume |
val: u7 |
/akai_z8/pad_toggle |
val: u7 |
/akai_z8/input |
val: u7 |
/akai_z8/effect |
val: u7 |
/akai_z8/ouput |
val: u7 |
/akai_z8/list |
val: u7 |
/akai_z8/6_p_lo_pass |
val: u7 |
/akai_z8/source_midi |
val: u7 |
/akai_z8/dest_freq |
val: u7 |
/akai_z8/cc_74 |
val: u7 |
/akai_z8/a_0 |
val: u7 |
/akai_z8/decay |
val: u7 |
/akai_z8/s_0 |
val: u7 |
/akai_z8/r_0 |
val: u7 |
/akai_z8/freq_0 |
val: u7 |
/akai_z8/d_20 |
val: u7 |
/akai_z8/all_kg |
val: u7 |
/akai_z8/set_to_2_hp |
val: u7 |
/akai_z8/slot_62_cont |
val: u7 |
/akai_z8/slot_63_cont |
val: u7 |
/akai_z8/set_to_2_lp |
val: u7 |
/akai_z8/low_cut |
val: u7 |
/akai_z8/cc_03 |
val: u7 |
/akai_z8/frequency |
val: u7 |
/akai_z8/high_cut |
val: u7 |
/akai_z8/choose_triple |
val: u7 |
/akai_z8/cc_number |
val: u7 |
/akai_z8/plus_1 |
val: u7 |
/akai_z8/minus_1 |
val: u7 |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /akai_z8/note/on <note> <velocity>, /akai_z8/cc/<number> <value>, /akai_z8/pitchbend <0-16383>, /akai_z8/program_change <n>.
Limitations¶
Imported from an Electra One community preset. The mapping reflects the preset author's editorial choices: parameter naming, ranges, and which params are exposed. Untested on hardware in this repo.
Frequently asked questions¶
How many parameters of the Akai Z8 can be controlled over MIDI?
SynthHub's map of the Akai Z8 lists 11 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 Akai Z8?
Yes: SynthHub's hosted MCP server knows the Akai Z8's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.