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
| Tool | Description |
|---|---|
artsonia_healthcheck |
Check connectivity and authentication status |
artsonia_list_students |
List all students linked to the account |
Portfolio & Artwork
| Tool | Description |
|---|---|
artsonia_get_activity |
Get recent activity feed for a student |
artsonia_get_portfolio |
Get a student's art portfolio |
artsonia_get_artwork |
Get details for a single artwork |
Social
| Tool | Description |
|---|---|
artsonia_list_comments |
List comments on an artwork |
artsonia_get_fans |
Get the fan list for a student |
artsonia_post_comment |
Post a comment on an artwork |
artsonia_invite_fan |
Invite someone to become a fan of a student |
artsonia_set_notifications |
Update notification preferences for a student |
Environment Variables
| Variable | Required | Description |
|---|---|---|
ARTSONIA_USERNAME |
Yes | Your Artsonia login email address |
ARTSONIA_PASSWORD |
Yes | Your Artsonia account password |
ARTSONIA_TRANSPORT |
No | Override transport: stdio (default), sse, or fetchproxy |
ARTSONIA_WS_PORT |
No | WebSocket port when using sse transport |
