Connect to a running MuseScore Studio (4.4.2 or later).

The MCP Score Bridge plugin must be running in MuseScore with its window open. Connecting disconnects any other application.

Args: host: WebSocket host (default: localhost). port: WebSocket port (default: 8765).

Disconnect from MuseScore.

Connect to a running Dorico via its Remote Control API (experimental).

Dorico support is experimental: the Remote Control API is undocumented, command-only (it cannot read note content), and this bridge has not been verified against a running Dorico. Dorico 4 and later serve the API without a plugin; the port is set in Dorico's preferences. Connecting disconnects any other application.

Args: host: WebSocket host (default: localhost). port: WebSocket port (default: 4560, Dorico's default).

Disconnect from Dorico.

Get information about the score open in the connected application.

Requires an active connection (connect_to_musescore or connect_to_dorico).

Check whether the connected application responds. Does not connect.

Read the content of a range of measures in the live score.

Returns what is at the cursor in each measure: notes, rests and other elements. MuseScore gives full note content; Dorico only reports its application status (see the warning in the result).

Args: start_measure: First measure to read (1-indexed). end_measure: Last measure to read (inclusive, 1-indexed). staff: Staff to read (0-indexed). Omit to read the current staff.

Select one measure of one staff in the live score and report it.

Args: measure: Measure number (1-indexed). staff: Staff index (0-indexed, default: 0).

Get properties of the current selection in the connected application.

MuseScore reports the cursor position (measure, beat, staff, element). Dorico reports the names, types and values of every property of the selected items, which is the closest its API gets to reading the score.

Add a note at the start of a measure in the live score.

Consecutive calls on the same measure append notes one after another, since the application advances its cursor after each note.

Args: measure: Measure number (1-indexed). pitch: MIDI pitch (60 = middle C). numerator: Duration numerator (default 1, with denominator 4 = quarter note). denominator: Duration denominator (default 4). staff: Staff index (0-indexed, default: 0).

Add a rehearsal mark to a measure in the live score.

Args: measure: Measure number (1-indexed). text: Rehearsal mark text (e.g. "A", "B", "Intro").

Add a chord symbol to a measure in the live score.

Args: measure: Measure number (1-indexed). symbol: Chord symbol (e.g. "Cmaj7", "Dm7", "G7").

Add a dynamic marking to a measure in the live score.

Args: measure: Measure number (1-indexed). dynamic: Dynamic such as "pp", "p", "mp", "mf", "f", "ff", "sfz". staff: Staff index (0-indexed, default: 0).

Set the bar line at the end of a measure in the live score.

Args: measure: Measure number (1-indexed). barline_type: One of "normal", "double", "final", "dashed", "dotted", "tick", "short", "startRepeat", "endRepeat" or "endStartRepeat". "startRepeat" marks the start of this measure; "endStartRepeat" ends a repeat here and starts one in the next measure.

Set the key signature from a measure onward in the live score.

Args: measure: Measure number (1-indexed). fifths: Sharps (positive) or flats (negative): 0 = C major, 2 = D major, -3 = Eb major.

Set the time signature from a measure onward in the live score.

Args: measure: Measure number (1-indexed). numerator: Beats per measure (e.g. 3 in 3/4). denominator: Beat unit (e.g. 4 in 3/4).

Set the tempo at a measure in the live score.

Args: measure: Measure number (1-indexed). bpm: Beats per minute. text: Optional display text (e.g. "Swing", "Allegro").

Append empty measures to the end of the live score.

Args: count: How many measures to append (default: 1).

Transpose the notes of a passage by a number of semitones in the live score.

Notes are moved with conventional spelling (a minor second up turns C into Db). Key signatures and chord symbols in the passage are left unchanged.

Args: start_measure: First measure (1-indexed). end_measure: Last measure (inclusive, 1-indexed). staff: Staff index (0-indexed). semitones: Semitones to transpose (positive = up, negative = down).

Undo the last change in the connected application.

Run a music21 Python script to generate a score file (MusicXML).

Write a COMPLETE, self-contained music21 script that builds the whole score and ends by exporting it, e.g. score.write("musicxml", fp="My Piece.musicxml"). Use a plain file name (no directory) so the file lands in the working directory and is reported back in output_files. Read the score_generation_guide tool first: it holds the music21 conventions this project relies on (flats are written B- not Bb, metadata, repeats, volta brackets, transposing instruments, and a full template).

The script runs on the user's machine with the user's privileges, in the same Python interpreter as this server (so music21 is importable). Only send code the user would be comfortable running themselves.

Args: script: Complete Python source of the generation script. output_dir: Working directory for the run. Defaults to a fresh directory under the user's Desktop (or home directory when there is no Desktop). Created if it does not exist. timeout: Seconds to wait before killing the script (default: 120).

Returns: JSON. On success: {"success": true, "output_files": [absolute paths of files created in the working directory], "stdout": ...}. On failure: {"error": ..., "stderr": last lines, "returncode": n}.

Return the score generation guide for writing music21 scripts.

Read this before calling generate_score. It is the bundled score-generate skill (instructions, music21 conventions and troubleshooting), the instrument class reference (which class to use for each instrument, with transposition handled by music21), and a complete runnable template script. Takes no parameters.

Returns the guide as Markdown, or {"error": ...} JSON if the bundled skill files cannot be found.

Render a score file to PDF, PNG, MIDI, MP3, WAV or MusicXML.

Runs the MuseScore Studio 4 command line, so MuseScore Studio 4 must be installed. It does not need to be running, and no plugin or live connection is required. The input is typically a MusicXML file (.musicxml, .xml, .mxl) but can be any file MuseScore opens, such as .mscz or .mid.

MuseScore is located from the MCP_SCORE_MUSESCORE_PATH environment variable, then PATH (mscore, musescore, mscore4portable, MuseScore4), then the platform default install location (macOS app bundle, Windows Program Files, Linux Flatpak). If it is not found automatically, set MCP_SCORE_MUSESCORE_PATH to the executable in the MCP server's environment.

Args: input_path: Path to the score file to render. format: One of "pdf", "png", "midi", "mp3", "wav", "musicxml" (default: pdf). PNG export writes one file per page, named with a -1, -2, ... suffix before the extension. output_path: Where to write the result. Defaults to the input path with the format's extension. Its extension must match the format. An existing file is overwritten.