mcpField
A
artsonia-mcp

artsonia-mcp

Local
github.com/chrischallSocial Media1Updated 5d ago
Repository

About artsonia-mcp

artsonia-mcp is an MCP server for Claude that lets parents and fans access Artsonia student-art portfolios and related interactions. It provides guarded artwork downloads and confirmation flows for comments and fan invitations.

Key features

  1. 01Access student portfolios
  2. 02Download images to allowed folders
  3. 03Confirm comments before posting
  4. 04Confirm fan invitations
  5. 05Manage notifications and read feedback

Use cases

  1. 01View a student's artwork
  2. 02Save artwork images in an approved folder
  3. 03Post a comment after confirmation
  4. 04Invite a fan after confirmation

MCP support

As an MCP server, it provides Claude with operations for Artsonia portfolios and interactions. Comments and fan invitations require confirmation, using a two-step flow when the client cannot display prompts.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "chrischall-artsonia": {
      "command": "npx",
      "args": [
        "-y",
        "artsonia-mcp"
      ],
      "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>"
      }
    }
  }
}
Run commandnpx -y artsonia-mcp
Environment variables to set
ARTSONIA_USERNAMEYour 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_PASSWORDSecretYour Artsonia account password. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy.
ARTSONIA_SESSION_CACHESet to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.
ARTSONIA_SESSION_FILEAbsolute path for the session cache file. Defaults to $MCP_DATA_DIR/.artsonia-mcp/session-<user>.json.
ARTSONIA_OUTPUT_DIRFolders 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_TRANSPORTfetch (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_PORTfetchproxy WebSocket port override (default 37149, a shared fleet port). Only used when ARTSONIA_TRANSPORT=fetchproxy.
ARTSONIA_INLINE_DOWNLOADS1/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.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmartsonia-mcp1.3.2

Tools

15

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

artsonia-mcp

CI npm license

Artsonia MCP server for Claude — developed and maintained by AI (Claude Code)

Download folders

artsonia_download_artwork saves images only inside an allowed folder; any other dest is refused before anything is fetched or written, and no file is ever written through a symlink.

variabledefault
ARTSONIA_OUTPUT_DIR~/Downloads and ~/PicturesThe folders dest must be inside (subfolders are fine and are created). Several folders: separate them with : (; on Windows). On a hosted server (MCP_DATA_DIR set) the default is $MCP_DATA_DIR/downloads instead. With ARTSONIA_INLINE_DOWNLOADS=1 nothing is written to disk, so dest is only a label and is not checked.

Confirmations

The writes that reach other people — posting a comment and inviting a fan — ask you to confirm them first. Changing your notification settings, marking feedback read, and downloading artwork into your allowed download folders run straight away. A client that can show a confirmation prompt (Claude Code) shows one. A client that cannot (claude.ai, Claude Desktop) gets a two-step flow instead: the first call changes nothing and returns a preview of exactly what would be sent plus a confirmToken; only a second, identical call carrying that token goes ahead. The token is single-use, expires, and is refused if anything changed between the two calls.

variabledefault
MCP_CONFIRM_MODEask-userWhat a write does on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop). ask-user: two steps — the first call does nothing and returns a preview plus a token, and the model must get your approval in chat before calling again with it. auto: the same two steps, but the model may use the token after reviewing the preview itself. refuse: writes are refused on such clients. A client that can show prompts (Claude Code) always gets the real prompt, unless MCP_CONFIRM_ELICITATION=off. An unrecognised value is treated as refuse.
MCP_CONFIRM_ELICITATIONonoff never shows a confirmation prompt, so every client gets the MCP_CONFIRM_MODE path. Set it for a client that claims to support prompts but never shows one (the write hangs — opencode 2.0.x). Any other value stays on, with a warning on stderr.
MCP_CONFIRM_TTL_SECONDS600How long a token stays valid.
MCP_CONFIRM_SECRETrandom per processSigning key; set it only if tokens must survive a server restart.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.