Files
soundcraft/docs/mcp.md
T
Brandon ThomasandClaude Opus 5.5 a28e15210c Parallel mixer, Setup windows, clip gain lines, folders, mix-strip sections, docs
- mix: independent strips process in parallel (rayon, native), parameter
  pushes cached, plugin sync/routing order cached per session structure;
  plugin and render benchmarks
- UI: Playback Engine, I/O Setup (bus rename/delete), Keyboard Shortcuts
  windows; clip gain line + info; folder open/close; tempo changes from the
  ruler; Inserts/Sends F-J, EQ curve and comments sections in the Mix window
- docs: control protocol and MCP guides

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 23:14:48 -04:00

1.9 KiB

MCP server

SoundCraft speaks the Model Context Protocol over stdio, so Claude and other agents can make music with it.

soundcraft-cli mcp                    # headless engine (no window, no audio device)
soundcraft-cli mcp --demo             # headless, starting from the demo session
soundcraft --control 7801 &           # the desktop app…
soundcraft-cli mcp --connect 7801     # …driven over MCP: same tools plus screenshots and clicks

Claude Code:

claude mcp add soundcraft -- soundcraft-cli mcp --demo

Tools

Tool Purpose
list_commands Discover every command (id, label, menu path, shortcut, params doc, enabled).
execute Run one command with JSON params.
batch Run several commands in order (keep_going optional).
inspect_session Verify work: tracks, clips, mixer, plugins, sends, automation, markers, selection.
new_session, open_session, save_session Session files (.scraft, audio in Audio Files/).
import_audio WAV, AIFF, FLAC, MP3, OGG, AAC/M4A, ALAC, CAF onto a new or existing track.
bounce_mix Render to WAV/AIFF/FLAC; returns peak dBFS and integrated LUFS.
parity Feature-parity report.
screenshot, ui_inspect, ui_set, menu_invoke, click, drag, key App only (with --connect).

Resources: soundcraft://session (full session JSON), soundcraft://commands.

Conventions

  • Programmatic calls never open dialogs; empty params act on the current selection.
  • Positions: samples, {"seconds": x}, or "bars_beats:5|1|000"-style strings.
  • Tracks by name or id; clips by id.
  • Every command is undoable through edit.undo unless it is a query or a view setting.

The acceptance test crates/automation/tests/agent_tasks.rs drives a realistic session end to end through MCP only (mixing, plugins, routing, editing with undo, markers, tempo, automation, bounce, save and reopen).