siril-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| siril_pingA | Check that the Siril MCP bridge is running inside Siril. |
| siril_get_stateA | Get live Siril state: loaded image, size, filename, selection, working directory. |
| siril_list_commandsA | List Siril commands available for scripting. Args: query: Optional substring filter on command name or usage. scriptable_only: If true, only return scriptable commands. |
| siril_run_commandC | Run a single Siril command in the live GUI session. Args: command: Command name (e.g. "autostretch", "load", "cd"). args: Optional list of argument strings. |
| siril_run_scriptA | Run a multi-line Siril script (.ssf command script or .py via pyscript). Args: script_body: Full script contents. kind: "ssf" for command scripts, "py" for Python (executed with pyscript). |
| siril_get_previewA | Return an 8-bit autostretched preview of the current Siril image (or a ROI). Args: max_edge: Maximum width or height of the returned PNG. x, y, w, h: Optional ROI in image pixel coordinates (omit all for full image). linked: Use linked autostretch when True. save_debug_copy: Also write a PNG under Application Support for debugging. |
| siril_set_selectionB | Set the Siril image selection rectangle (x, y, width, height). |
| siril_get_statsA | Get per-channel statistics for the currently loaded image. |
| siril_undoA | Undo the last Siril operation (if undo history is available). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools target distinct concerns: state, previews, stats, selection, undo, and command execution are clearly separated. The only mild overlap is between siril_run_script and siril_run_command, but their descriptions make the multi-line vs single-command distinction clear.
All tools share the siril_ prefix and mostly follow a verb_noun pattern like get_preview or list_commands. The exceptions are siril_undo and siril_ping, which are bare verbs, but this is a minor deviation from an otherwise consistent scheme.
Nine tools is a well-scoped set for controlling a live Siril session. Each tool covers a meaningful interaction surface without unnecessary bloat or redundancy.
The generic run_command and run_script tools effectively cover the full command surface, so most workflows are reachable. However, there are no dedicated tools for common operations like loading or saving images, which means agents must know Siril command names to fill those gaps.