NestDaddy

Artsonia Mcp

io.github.chrischall/artsonia-mcp · v1.4.1

Parent/fan access to Artsonia student-art portfolios, comments, and fans (AI-built).

Connect Runs on your machine

Terminal
claude mcp add artsonia-mcp -e ARTSONIA_USERNAME=<ARTSONIA_USERNAME> -e ARTSONIA_PASSWORD=<ARTSONIA_PASSWORD> -e ARTSONIA_SESSION_CACHE=<ARTSONIA_SESSION_CACHE> -e ARTSONIA_SESSION_FILE=<ARTSONIA_SESSION_FILE> -e ARTSONIA_OUTPUT_DIR=<ARTSONIA_OUTPUT_DIR> -e ARTSONIA_TRANSPORT=<ARTSONIA_TRANSPORT> -e ARTSONIA_WS_PORT=<ARTSONIA_WS_PORT> -e ARTSONIA_INLINE_DOWNLOADS=<ARTSONIA_INLINE_DOWNLOADS> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "artsonia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ARTSONIA_USERNAME": "<ARTSONIA_USERNAME>",
        "ARTSONIA_PASSWORD": "<ARTSONIA_PASSWORD>",
        "ARTSONIA_SESSION_CACHE": "<ARTSONIA_SESSION_CACHE>",
        "ARTSONIA_SESSION_FILE": "<ARTSONIA_SESSION_FILE>",
        "ARTSONIA_OUTPUT_DIR": "<ARTSONIA_OUTPUT_DIR>",
        "ARTSONIA_TRANSPORT": "<ARTSONIA_TRANSPORT>",
        "ARTSONIA_WS_PORT": "<ARTSONIA_WS_PORT>",
        "ARTSONIA_INLINE_DOWNLOADS": "<ARTSONIA_INLINE_DOWNLOADS>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "artsonia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ARTSONIA_USERNAME": "<ARTSONIA_USERNAME>",
        "ARTSONIA_PASSWORD": "<ARTSONIA_PASSWORD>",
        "ARTSONIA_SESSION_CACHE": "<ARTSONIA_SESSION_CACHE>",
        "ARTSONIA_SESSION_FILE": "<ARTSONIA_SESSION_FILE>",
        "ARTSONIA_OUTPUT_DIR": "<ARTSONIA_OUTPUT_DIR>",
        "ARTSONIA_TRANSPORT": "<ARTSONIA_TRANSPORT>",
        "ARTSONIA_WS_PORT": "<ARTSONIA_WS_PORT>",
        "ARTSONIA_INLINE_DOWNLOADS": "<ARTSONIA_INLINE_DOWNLOADS>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "artsonia-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ARTSONIA_USERNAME": "<ARTSONIA_USERNAME>",
        "ARTSONIA_PASSWORD": "<ARTSONIA_PASSWORD>",
        "ARTSONIA_SESSION_CACHE": "<ARTSONIA_SESSION_CACHE>",
        "ARTSONIA_SESSION_FILE": "<ARTSONIA_SESSION_FILE>",
        "ARTSONIA_OUTPUT_DIR": "<ARTSONIA_OUTPUT_DIR>",
        "ARTSONIA_TRANSPORT": "<ARTSONIA_TRANSPORT>",
        "ARTSONIA_WS_PORT": "<ARTSONIA_WS_PORT>",
        "ARTSONIA_INLINE_DOWNLOADS": "<ARTSONIA_INLINE_DOWNLOADS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
ARTSONIA_USERNAME
Optional
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
Optional, secret
Your Artsonia account password. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy.
ARTSONIA_SESSION_CACHE
Optional
Set to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.
ARTSONIA_SESSION_FILE
Optional
Absolute path for the session cache file. Defaults to $MCP_DATA_DIR/.artsonia-mcp/session-<user>.json.
ARTSONIA_OUTPUT_DIR
Optional
Folders artsonia_download_artwork may save into (a path-delimiter list: ':' on macOS/Linux, ';' on Windows). Unset: ~/Downloads and ~/Pictures. Any other dest is refused. Not used on a hosted server, which never writes downloads to disk.
ARTSONIA_TRANSPORT
Optional
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
Optional
fetchproxy WebSocket port override (default 37149, a shared fleet port). Only used when ARTSONIA_TRANSPORT=fetchproxy.
ARTSONIA_INLINE_DOWNLOADS
Optional
1/true/yes/on returns artsonia_download_artwork images inline as base64 image blocks instead of writing them to disk; unset/false saves to disk. Implied on a hosted server (MCP_DATA_DIR or MCP_BLOB_BASE_URL set).

Details

Package[email protected] (NPM, stdio)
First published7 Nov 2026
Last updated7 Nov 2026
Registry nameio.github.chrischall/artsonia-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.