artsonia-mcp

MCP server for Artsonia — natural-language access to student-art portfolios, comments, and fans.

• npm: npmjs.com/package/artsonia-mcp
• Source: github.com/chrischall/artsonia-mcp

Setup

Option A — npx (recommended)

Add to .mcp.json in your project or ~/.claude/mcp.json:

{
  "mcpServers": {
    "artsonia": {
      "command": "npx",
      "args": ["-y", "artsonia-mcp"],
      "env": {
        "ARTSONIA_USERNAME": "your-email@example.com",
        "ARTSONIA_PASSWORD": "your-password"
      }
    }
  }
}

Option B — from source

git clone https://github.com/chrischall/artsonia-mcp
cd artsonia-mcp
npm install && npm run build

Then add to .mcp.json:

{
  "mcpServers": {
    "artsonia": {
      "command": "node",
      "args": ["/path/to/artsonia-mcp/dist/index.js"],
      "env": {
        "ARTSONIA_USERNAME": "your-email@example.com",
        "ARTSONIA_PASSWORD": "your-password"
      }
    }
  }
}

Or use a .env file in the project directory with ARTSONIA_USERNAME=<value> and ARTSONIA_PASSWORD=<value>.

Authentication

Username/password auth using your Artsonia parent/fan account credentials. The server logs in and maintains a session cookie.

Tools

Core

Portfolio & Artwork

Social

Confirming writes

artsonia_post_comment and artsonia_invite_fan ask the user to confirm first. (artsonia_set_notifications, artsonia_mark_feedback_read and artsonia_download_artwork run in one call with no confirmation step.) Where the client can show a confirmation prompt, it does (unless the server sets MCP_CONFIRM_ELICITATION=off). Otherwise the first call changes nothing and returns status: "confirmation-required" with a preview of exactly what would be sent and a confirmToken: show the preview to the user, and only after they approve in chat call the tool again with the same arguments plus confirmToken. A token works once (TOKEN_REUSED), expires, and is refused as DRAFT_CHANGED (with a fresh preview and token) if the arguments or the data it acts on changed in between. MCP_CONFIRM_MODE (ask-user default / auto / refuse) controls this fallback.

Environment Variables