npm · artsonia-mcp
$npx -y artsonia-mcp@1.3.0 ARTSONIA_USERNAME — Your Artsonia login email address. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy (the signed-in browser tab carries the session).
ARTSONIA_PASSWORD · secret — Your Artsonia account password. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy.
ARTSONIA_SESSION_CACHE — Set to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.
ARTSONIA_SESSION_FILE — Absolute path for the session cache file. Defaults to $MCP_DATA_DIR/.artsonia-mcp/session-<user>.json.
ARTSONIA_OUTPUT_DIR — Folders artsonia_download_artwork may save into (a path-delimiter list: ':' on macOS/Linux, ';' on Windows). Unset: ~/Downloads and ~/Pictures, or $MCP_DATA_DIR/downloads when MCP_DATA_DIR is set. Any other dest is refused.
ARTSONIA_TRANSPORT — fetch (default) logs in directly with ARTSONIA_USERNAME/ARTSONIA_PASSWORD; fetchproxy is the optional fallback that rides your signed-in artsonia.com browser tab.
ARTSONIA_WS_PORT — fetchproxy WebSocket port override (default 37149, a shared fleet port). Only used when ARTSONIA_TRANSPORT=fetchproxy.
ARTSONIA_INLINE_DOWNLOADS — 1/true/yes/on returns artsonia_download_artwork images inline as base64 image blocks instead of writing them to disk (for hosted deployments); unset/false saves to disk.