Integrations

artsonia-mcp

Try it

Access Artsonia student-art portfolios, comments, and fans via MCP. Use when the user asks about a child's artwork, wants to post an art comment, check fans, view portfolios, or manage Artsonia notifications. Triggers on phrases like "show me Emma's latest artwork", "post a comment on that painting", "who are the fans for this student", "invite grandma as a fan", or any request involving student art portfolios on Artsonia. Requires artsonia-mcp installed and the artsonia server registered (see Setup below).

What it does

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

The skill document

artsonia-mcp

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

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= and ARTSONIA_PASSWORD=.

Authentication

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

Tools

Core

ToolDescription
artsonia_healthcheckCheck connectivity and authentication status
artsonia_list_studentsList all students linked to the account

Portfolio & Artwork

ToolDescription
artsonia_get_activityGet recent activity feed for a student
artsonia_get_portfolioGet a student's art portfolio. Optional include_details: boolean (default false) fetches each artwork's full detail (title/project/grade/views/…) concurrently and merges it into the rows; omit it for the fast, lean tiles.
artsonia_get_artworkGet details for a single artwork
artsonia_download_artworkDownload a student's artwork images to a local folder. Optional path_template: string (e.g. "{grade}/{project}" or "{school_year}") organizes downloads into subfolders under dest, composed with filename_template — same tokens ({title} {project} {grade} {date} {school_year} {artwork_id}), segments slugified like filenames, empty tokens collapse, and paths stay deterministic so skip_existing re-runs remain idempotent. Optional embed_metadata: boolean (default false) embeds each image's title/project/grade and source date (its Last-Modified) into the JPEG's EXIF (ImageDescription, DateTimeOriginal) and IPTC (title, keywords, date) so the metadata survives renames/moves and is searchable in Spotlight/Apple Photos; the count is returned as embedded_count (best-effort — a failed embed writes the original bytes). Optional write_index: boolean (default false) writes an index.json manifest into the destination listing the downloaded items (artwork_id, title, file — dest-relative, grade, project, date); the manifest path is returned as index_file. Optional write_metadata: boolean (default false) writes a per-artwork .json sidecar next to each image with the artwork's comments and teacher feedback (plus title/project/grade); the count is returned as metadata_count. Optional include_private: boolean (default true) — set false to exclude private pieces (private_excluded_count reports how many were dropped). The result carries totals (total_bytes, downloaded_count/skipped_count/failed_count/private_count), a per-file is_private flag, and — on unfiltered runs — a count_check against the student's artwork_count with a warning when the pull looks partial. The dry run (no confirm) adds estimated_bytes per item and estimated_total_bytes.

Social

ToolDescription
artsonia_list_commentsList comments on an artwork
artsonia_get_fansGet the fan list for a student
artsonia_post_commentPost a comment on an artwork
artsonia_invite_fanInvite someone to become a fan of a student
artsonia_set_notificationsUpdate notification preferences for a student

Environment Variables

VariableRequiredDescription
ARTSONIA_USERNAMEYesYour Artsonia login email address
ARTSONIA_PASSWORDYesYour Artsonia account password
ARTSONIA_TRANSPORTNoOverride transport: stdio (default), sse, or fetchproxy
ARTSONIA_WS_PORTNoWebSocket port when using sse transport
ARTSONIA_INLINE_DOWNLOADSNoSet to 1 on a hosted deployment to return artsonia_download_artwork images as inline base64 blocks instead of writing them to a disk the user can't reach. Leave unset for local installs.

Related skills

diagram-generator

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Join meeting

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai21 installs8 stars

Memory

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván555 installs18 stars

AdMapix

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Productivity

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván854 installs69 stars

microsoft-excel

Read and write Excel workbooks, worksheets, ranges, tables, and charts in OneDrive through Microsoft Graph with managed OAuth.

by byungkyu800 installs42 stars

More from chrischall

Browse all skills

Tmp.BcPQA7YzJI

Read and write OurFamilyWizard messages, calendar events, expenses, and journal entries from your agent.

by chrischall41 installs

Tmp.Vb01j6Bvtm

Find, inspect, compare, and resolve Compass listings, photos, prices, addresses, and property records.

by chrischall31 installs

Tmp.Rd8dBLUSJc

Pull Credit Karma transactions into a local SQLite database and query them by category, merchant, or account.

by chrischall31 installs

Tmp.6swodUvLYL

Search, book, and cancel Resy reservations, plus favorites and Priority Notify alerts.

by chrischall29 installs

ioffice-mcp

Manage iOffice buildings, rooms, visitors, maintenance, moves, and mail through natural-language commands.

by chrischall13 installs

Tmp.6wLATFVyAx

Look up concert setlists, tour histories, and live-show data on setlist.fm through natural-language MCP tools.

by chrischall12 installs