Music Studio MCP

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "kind"
  ],
  "properties": {
    "kind": {
      "enum": [
        "score",
        "play"
      ],
      "type": "string"
    },
    "score": {
      "type": "object",
      "required": [
        "abcNotation"
      ],
      "properties": {
        "style": {
          "enum": [
            "rock",
            "jazz",
            "bossa",
            "waltz",
            "march",
            "reggae",
            "folk",
            "classical"
          ],
          "type": "string"
        },
        "swing": {
          "type": "number",
          "maximum": 75,
          "minimum": 0
        },
        "tempo": {
          "type": "number",
          "maximum": 240,
          "minimum": 40
        },
        "title": {
          "type": "string"
        },
        "drumIntro": {
          "type": "integer",
          "maximum": 8,
          "minimum": 0
        },
        "transpose": {
          "type": "integer",
          "maximum": 12,
          "minimum": -12
        },
        "instrument": {
          "type": "string",
          "description": "General MIDI instrument name, as for play-sheet-music."
        },
        "abcNotation": {
          "type": "string",
          "maxLength": 65536,
          "minLength": 1,
          "description": "The ABC notation, as for play-sheet-music."
        }
      },
      "description": "The arguments you gave play-sheet-music."
    },
    "pattern": {
      "type": "object",
      "required": [
        "code"
      ],
      "properties": {
        "bpm": {
          "type": "number",
          "maximum": 300,
          "minimum": 40
        },
        "code": {
          "type": "string",
          "maxLength": 65536,
          "description": "The Strudel code, as for play-live-pattern."
        },
        "title": {
          "type": "string"
        },
        "visuals": {
          "enum": [
            "none",
            "pianoroll",
            "punchcard",
            "scope",
            "spectrum",
            "hydra-kaleid",
            "hydra-pulse",
            "hydra-wash",
            "hydra-feed"
          ],
          "type": "string"
        },
        "autoplay": {
          "type": "boolean"
        }
      },
      "description": "The arguments you gave play-live-pattern (theme and session are not carried)."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "style": {
      "enum": [
        "rock",
        "jazz",
        "bossa",
        "waltz",
        "march",
        "reggae",
        "folk",
        "classical"
      ],
      "type": "string",
      "description": "Accompaniment style. Adds drums, bass, and chord patterns automatically. Your ABC needs chord symbols (\"C\", \"Am\") for accompaniment to work. Options: rock, jazz, bossa, waltz, march, reggae, folk, classical."
    },
    "swing": {
      "type": "number",
      "maximum": 75,
      "minimum": 0,
      "description": "Swing as the share of the beat given to its first half. 50 = straight, 60 ≈ 3:2, 66 = triplet swing, 75 = maximum (dotted eighth + sixteenth). Anything at or below 50 is treated as no swing. Only takes effect in an x/4 or x/8 meter."
    },
    "tempo": {
      "type": "number",
      "maximum": 240,
      "minimum": 40,
      "description": "Tempo in BPM (40-240). Overrides Q: in ABC notation."
    },
    "title": {
      "type": "string",
      "description": "Piece title (overrides T: in ABC). Shown in the widget header and used as the filename stem for the WAV/MIDI downloads."
    },
    "drumIntro": {
      "type": "integer",
      "maximum": 8,
      "minimum": 0,
      "description": "Bars of count-in before the melody starts (0-8). Needs a style preset — the count-in is played by that style's drum kit, so without a style you get silent bars instead."
    },
    "transpose": {
      "type": "integer",
      "maximum": 12,
      "minimum": -12,
      "description": "Transpose by semitones (-12 to 12). Positive=higher, negative=lower. Rewrites the notation and the key signature, so the printed score matches what plays."
    },
    "instrument": {
      "type": "string",
      "description": "Default instrument for the main voice — any of the 128 General MIDI names (e.g. 'Flute', 'Cello', 'Banjo', 'Alto Sax'). Matching is fuzzy and picks the lowest GM program among the hits, so 'sax' gives Soprano Sax; the result text names what you actually got whenever it isn't what you asked for. Use get-music-guide with topic 'instruments' for the full list, or %%MIDI program N in the ABC to set a program per voice."
    },
    "abcNotation": {
      "type": "string",
      "default": "X:1\nT:Twinkle, Twinkle Little Star\nM:4/4\nL:1/4\nK:C\nC C G G | A A G2 | F F E E | D D C2 |\nG G F F | E E D2 | G G F F | E E D2 |\nC C G G | A A G2 | F F E E | D D C2 |",
      "maxLength": 65536,
      "description": "ABC notation string. Include chord symbols (\"C\", \"Am7\") above notes for auto-accompaniment with style presets."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "code"
  ],
  "properties": {
    "bpm": {
      "type": "number",
      "maximum": 300,
      "minimum": 40,
      "description": "Tempo in BPM (40-300). Converts to setcps() automatically."
    },
    "code": {
      "type": "string",
      "maxLength": 65536,
      "description": "Strudel pattern code. Uses TidalCycles mini-notation in JavaScript. Use stack() to layer drums, bass, and melody. Set tempo with setcps(bpm/60/4) or use the bpm parameter. The REPL plays the LAST expression: setup lines (await initHydra(), all(), setcps()) go BEFORE the pattern. Double quotes are mini-notation — use single quotes for plain strings and URLs. One draw method per pattern; pass a.fft values as functions (() => a.fft[0])."
    },
    "theme": {
      "enum": [
        "strudelTheme",
        "algoboy",
        "archBtw",
        "androidstudio",
        "atomone",
        "aura",
        "bbedit",
        "blackscreen",
        "bluescreen",
        "bluescreenlight",
        "CutiePi",
        "darcula",
        "dracula",
        "duotoneDark",
        "eclipse",
        "fruitDaw",
        "githubDark",
        "githubLight",
        "greenText",
        "gruvboxDark",
        "gruvboxLight",
        "sonicPink",
        "materialDark",
        "materialLight",
        "monokai",
        "noctisLilac",
        "nord",
        "redText",
        "solarizedDark",
        "solarizedLight",
        "sublime",
        "teletext",
        "tokyoNight",
        "tokyoNightDay",
        "tokyoNightStorm",
        "vscodeDark",
        "vscodeLight",
        "whitescreen",
        "xcodeLight"
      ],
      "type": "string",
      "description": "Editor colour scheme. It also sets the ground the visuals sit on, so pick a dark one when the visual is the point (e.g. 'nord', 'sonicPink', 'tokyoNight')."
    },
    "title": {
      "type": "string",
      "description": "Pattern title displayed in the widget header (e.g. 'Midnight Rain')."
    },
    "session": {
      "type": "boolean",
      "description": "Optional: keep this player open as a live session. update-session then swaps new code in on the bar, and get-session reports what played and what the user did. For a jam, or a piece you change while it plays. Give the user something to play — taps, a fader, a grid (topic 'interactive') — or they answer by editing the code and pressing Pass. The log is kept until 2 hours idle."
    },
    "visuals": {
      "enum": [
        "none",
        "pianoroll",
        "punchcard",
        "scope",
        "spectrum",
        "hydra-kaleid",
        "hydra-pulse",
        "hydra-wash",
        "hydra-feed"
      ],
      "type": "string",
      "description": "A ready-made visual for code that has none of its own: pianoroll, punchcard, scope or spectrum (drawn behind the code), or hydra-kaleid, hydra-pulse, hydra-wash or hydra-feed (shader backgrounds). It only fills a layer the code leaves empty, and shaders are skipped for viewers who prefer reduced motion. Your own visual is the better result (topics 'visuals' and 'hydra')."
    },
    "autoplay": {
      "type": "boolean",
      "description": "Start playing immediately (default: true). May require user click due to browser autoplay policy."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "session"
  ],
  "properties": {
    "wait": {
      "enum": [
        "pass",
        "activity"
      ],
      "type": "string",
      "description": "Listen instead of just reading: 'pass' until the listener presses Pass, 'activity' until they play. Returns at once if that already happened since your last read, else after ~40 s — call again to keep listening."
    },
    "session": {
      "type": "string",
      "pattern": "^[a-z2-7]{16}$",
      "description": "The session id from play-live-pattern's result (16 lowercase letters/digits)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "session",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 65536,
      "description": "The complete new Strudel pattern (same rules as play-live-pattern's code)."
    },
    "session": {
      "type": "string",
      "pattern": "^[a-z2-7]{16}$",
      "description": "The session id from play-live-pattern's result (16 lowercase letters/digits)."
    },
    "quantize": {
      "type": "integer",
      "maximum": 32,
      "minimum": 0,
      "description": "Land on the next multiple of this many cycles (bars). 1 = next bar (default), 4/8 = phrase, 0 = now."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "topic"
  ],
  "properties": {
    "topic": {
      "enum": [
        "instruments",
        "drums",
        "abc-syntax",
        "arrangements",
        "genres",
        "styles",
        "midi-directives"
      ],
      "type": "string",
      "description": "Reference topic. Start with 'genres' for complete examples, 'styles' to understand presets, or 'instruments' for the full instrument list."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "topic"
  ],
  "properties": {
    "piece": {
      "enum": [
        "first-light",
        "duet",
        "petri-dish",
        "lossy-terminal",
        "signal-corruption",
        "weather-machine",
        "two-decks",
        "trade-a-beat",
        "still-water",
        "lullaby"
      ],
      "type": "string",
      "description": "With topic 'gallery': the complete code of one piece (the index lists them)."
    },
    "topic": {
      "enum": [
        "mini-notation",
        "sounds",
        "effects",
        "patterns",
        "genres",
        "tips",
        "visuals",
        "hydra",
        "advanced",
        "stage",
        "film",
        "interactive",
        "craft",
        "debugging",
        "gallery"
      ],
      "type": "string",
      "description": "Reference topic. Start with 'genres' for working templates, 'sounds' for instruments, 'visuals' for draw methods and presets, 'hydra' for shader backgrounds, 'advanced' for sample loading. For a music video or film: 'craft', 'stage', 'film', then gallery piece 'first-light'. For taps, controls, a drawn grid or a jam: 'interactive' alone (take only the sections you need), then gallery piece 'weather-machine' or 'trade-a-beat'."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 500,
      "description": "What you want to know. Be specific. Good: 'how to use FM synthesis with envelope' or 'chop and slice sample manipulation'. Bad: 'effects' or 'help'."
    },
    "library": {
      "enum": [
        "strudel",
        "abcjs"
      ],
      "type": "string",
      "default": "strudel",
      "description": "Which library to search: 'strudel' for live coding patterns, 'abcjs' for sheet music notation."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "task"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Key, e.g. \"C\", \"A minor\", \"F# major\". For suggest-progression/key-chords."
    },
    "task": {
      "enum": [
        "detect-chord",
        "detect-key",
        "suggest-progression",
        "scale-for-chord",
        "key-chords"
      ],
      "type": "string",
      "description": "What to work out. detect-chord needs notes; detect-key needs notes or chords; scale-for-chord needs chords; suggest-progression/key-chords need a key."
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 64,
      "description": "Note names, e.g. [\"c4\",\"e4\",\"g4\",\"b4\"] or [\"C\",\"Eb\",\"G\"]. For detect-chord/detect-key."
    },
    "chords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 64,
      "description": "Chord symbols, e.g. [\"Dm7\",\"G7\",\"Cmaj7\"]. For detect-key/scale-for-chord."
    },
    "romanNumerals": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 64,
      "description": "Roman numerals to render in the key, e.g. [\"ii7\",\"V7\",\"Imaj7\"] or [\"I\",\"V\",\"vi\",\"IV\"]. Optional for suggest-progression — omit it to get common progressions instead."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "abcNotation"
  ],
  "properties": {
    "sound": {
      "type": "string",
      "description": "Strudel sound for the melody (defaults to the tune's %%MIDI program, else \"gm_piano\"). Use a GM soundfont name like gm_flute or gm_epiano1 — see get-strudel-guide topic 'sounds'."
    },
    "voice": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Which voice to convert, 1-based, counted across all staves (default 1). Multi-voice tunes report how many voices there are."
    },
    "abcNotation": {
      "type": "string",
      "maxLength": 65536,
      "description": "ABC notation to convert (the same string you'd pass to play-sheet-music)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

ui://sheet-music/0.13.0/mcp-app.html

ui://sheet-music/mcp-app.html

ui://strudel/0.13.0/strudel-app.html

ui://strudel/strudel-app.html

music://guide/instruments

music://guide/drums

music://guide/abc-syntax

music://guide/arrangements

music://guide/genres

music://guide/styles

music://guide/midi-directives

music://strudel-guide/mini-notation

music://strudel-guide/sounds

music://strudel-guide/effects

music://strudel-guide/patterns

music://strudel-guide/genres

music://strudel-guide/tips

music://strudel-guide/visuals

music://strudel-guide/hydra

music://strudel-guide/advanced

music://strudel-guide/stage

music://strudel-guide/film

music://strudel-guide/interactive

music://strudel-guide/craft

music://strudel-guide/debugging

music://strudel-guide/gallery

ui://sheet-music/{version}/mcp-app.html

ui://strudel/{version}/strudel-app.html