run_plugin
Execute a pre-installed QML plugin on a MuseScore score to automate score manipulations like note coloring or harmonic analysis.
Instructions
Run a MuseScore QML plugin on a score.
The plugin must already be installed in MuseScore's plugin directory. Plugins can perform score manipulations (e.g. note coloring, analysis).
Args: score_b64: Base64-encoded score file. input_suffix: Input extension, e.g. "mscz". plugin_name: Name of the plugin as registered in MuseScore (without .qml).
Returns: Base64-encoded mscz after plugin execution.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"score_b64": "<score_b64>",
"input_suffix": "<input_suffix>",
"plugin_name": "<plugin_name>"
},
"name": "run_plugin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| score_b64 | Yes | ||
| input_suffix | Yes | ||
| plugin_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |