stock seed is CLI-only by design — a maintainer-only, hidden command that re-scans a Live-Suite machine’s Core Library and cross-checks the derived URIs against a live LOM scan (instrument-browser.json) before regenerating the embedded seed resource; it is release/build tooling that writes into the repo tree, not a runtime operation an agent drives against Live, so it has no MCP counterpart.
Command line
stock list
List/filter factory Core Library content (offline, no Live)
Filter by category: instrument, drum_kit, audio_effect, midi_effect, unknown. Case-insensitive. Omit = all.
Filter by on-disk shape: device, rack, preset. Case-insensitive. Omit = all.
Case-insensitive substring matched against name or relative path. Omit = no text filter.
Maximum number of items to return. Omit or <= 0 = no cap.
stock browse
Depth-1 browse of the Core Library folder tree (offline)
Relative Core Library folder path (forward-slash separated). Omit = top level.
stock show
Show one stock item: category, kind, device class, load URI
required
Exact relative path, or unique Name (from stock list / stock browse), of the item.
stock refresh
Re-walk the on-disk Core Library and rebuild the cache
stock load
Load a stock item onto a track (needs Live)
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Exact relative path of the item to load (from stock list / stock browse / stock show).
Insert position in device chain (1-based: 1 = first slot). Omit to let Vibrai pick a valid slot for the device family — audio effects append after the instrument, MIDI effects and instruments insert at the head — since Live enforces MIDI effects then instrument then audio effects.
stock locate
Show stock-library diagnostics (resolved path, per-category counts, cache freshness, source)
stock seed
Maintainer-only: regenerate the embedded Core Library seed
Run the cross-check only; never writes. Exits non-zero when the derivation rate is below —baseline.
Path to the LOM snapshot (instrument-browser.json) to cross-check against (default: the app-support snapshot Vibrai’s remote script writes)
Where to write the seed JSON (default: Vibrai.Engine/Resources/StockLibrary/core-library-suite.json, repo-relative — run from the repo root)
default:"1"
Minimum derivation rate (0..1) the cross-check must meet to pass (default: 1.0)
MCP tools
list_stock_sounds
List (and filter) Ableton Live 12 Suite factory Core Library content — instruments, drum kits, and audio/MIDI effect presets — discovered by scanning the library on disk. Fully offline and Live-independent: reads Vibrai’s cached Core Library index (falling back to a fresh scan, then the embedded seed), no running Ableton required. Filters are ANDed: category, kind, a case-insensitive search substring over the item name or relative path, and a max-result limit. Omit a filter to leave it unconstrained. Returns each item’s name, relative path (the address load_stock_sound / show_stock_sound take), category, kind, device class, and derived load URI.
Nullable`1
Only items in this category: instrument, drum_kit, audio_effect, midi_effect, unknown. Omit = all categories.
Nullable`1
Only items of this on-disk shape: device, rack, preset. Omit = all kinds.
String
Case-insensitive substring matched against the item name or relative path. Omit = no text filter.
Nullable`1
Maximum number of items to return. Omit or <= 0 = no cap.
browse_stock_sounds
Depth-1 browse of the offline Core Library folder tree, like a file browser one level at a time. Live-independent (same cached index as list_stock_sounds). Pass a relative folder path (forward-slash separated) to list its immediate sub-folders and leaf items; omit path (or pass empty) for the top level. Each entry is either a folder (is_folder=true — drill in by passing its path) or an item (is_folder=false, with the full stock item for loading). Returns an empty list for a real but childless leaf path; errors (STOCK_PATH_NOT_FOUND) for a path that isn’t a prefix of any item — try list_stock_sounds/show_stock_sound to find a real one.
String
Relative Core Library folder path (forward-slash separated). Omit/empty = top level.
show_stock_sound
Show one Core Library item by its exact relative path OR its unique Name — the column list_stock_sounds/browse_stock_sounds lead with (#219): name, category, kind, device class, and the derived load URI. Offline and Live-independent. Resolution: an exact path always wins; else a case-insensitive Name match resolves if unique. Errors (STOCK_ITEM_AMBIGUOUS) when the Name matches more than one item — the message lists every matching path so you can retry with one; errors (STOCK_ITEM_NOT_FOUND) when nothing matches at all.
String
required
Exact relative path OR unique Name of the item, e.g. ‘Devices/Instruments/Operator/Bass/Analog Bass.adv’ or ‘Analog Bass’.
refresh_stock_library
Force a fresh on-disk re-scan of the Ableton Live 12 Suite Core Library, rebuilding Vibrai’s cached index (bypassing both the cache and the embedded seed). Offline — it reads the library files, not a running Ableton — but it does need the Core Library installed locally; errors (STOCK_LIBRARY_NOT_FOUND) when no Core Library root can be located. Returns a small summary: the source (always ‘Scan’ on success), the item count, and the resolved root.
load_stock_sound
Load a Core Library item onto a track by its relative path. Unlike the discovery tools, THIS needs a running Ableton — it resolves the item offline (via the same cached index), then loads it by its trusted derived URI through the Vibrai bridge. Returns the same result shape as load_device (track, device id, name, chain position, optional M4L health warning). Errors STOCK_ITEM_NOT_FOUND if the path doesn’t match, or STOCK_LOAD_NEEDS_SNAPSHOT for the rare item with no offline-derivable URI.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Exact relative path of the item to load (from list_stock_sounds / browse_stock_sounds / show_stock_sound).
String
Insert position in device chain (1-based: 1 = first slot). Omit to let Vibrai pick a valid slot for the device family — audio effects append after the instrument, MIDI effects and instruments insert at the head — since Live enforces MIDI effects then instrument then audio effects.