Parent/fan access to Artsonia student-art portfolios, comments, and fans (AI-built).
Connect Runs on your machine
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]
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
{
"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
| Name | Description |
|---|---|
ARTSONIA_USERNAMEOptional | 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_PASSWORDOptional, secret | Your Artsonia account password. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy. |
ARTSONIA_SESSION_CACHEOptional | Set to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled. |
ARTSONIA_SESSION_FILEOptional | Absolute path for the session cache file. Defaults to $MCP_DATA_DIR/.artsonia-mcp/session-<user>.json. |
ARTSONIA_OUTPUT_DIROptional | 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_TRANSPORTOptional | 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_PORTOptional | fetchproxy WebSocket port override (default 37149, a shared fleet port). Only used when ARTSONIA_TRANSPORT=fetchproxy. |
ARTSONIA_INLINE_DOWNLOADSOptional | 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 published | 7 Nov 2026 |
| Last updated | 7 Nov 2026 |
| Registry name | io.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.
