project_file
Open, save as, close, or revert a Dorico project and report when the action completes, giving controlled file-level project management via MCP.
Instructions
Open, save as, close or revert a Dorico project, and report when it is done.
Returns:
Result dictionary with the command, whether Dorico finished it, and for
save_as the written file, for open the flows of the project now active.
Note:
Measured in Dorico Elements 6.2.40: save_as writes without a dialog and the
open project becomes the new file; close with an ``openScoreID`` closes
without a dialog. Revert asks for confirmation in a dialog that a person must
answer in Dorico, and afterwards the project has a new ``openScoreID``.
After a close, Dorico answers queries with ``kNoScore`` until a person
focuses another project window.
Closing without saving and reverting discard work, so both need
``confirm=True``. Opening a native project file was seen in Dorico's log
but not yet measured over the API.
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": {
"action": "<action>"
},
"name": "project_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | open and save_as: absolute path of a .dorico file. | |
| action | Yes | open a project file, save under a new path, close, or revert to saved. | |
| confirm | No | True authorises a change that discards work or cannot be undone. | |
| timeout | No | Seconds to wait for Dorico, including any dialog. | |
| save_changes | No | close: save before closing. False discards unsaved changes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||