Artsonia Mcp

chrischall/artsonia-mcp

Gives Claude programmatic access to Artsonia, the student art portfolio platform where kids' artwork gets published and shared with families. You can pull portfolio data, browse student art pieces, read comments, and check fan counts. Built entirely by AI, which is a fun detail but more relevant is that this lets you integrate Artsonia's catalog into Claude workflows. Reach for it if you're building parent-facing tools around school art programs, aggregating student portfolio metrics, or need to surface Artsonia content in conversational interfaces. The stdio transport keeps setup straightforward for local Claude Desktop integration.

GitHub stars: 1
tool: 1
auth: Secret needed
transport: STDIO
env vars: 8
last updated: Nov 7, 2026

View on GitHub

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

artsonia_download_artworkSaves artwork images only inside an allowed download folder; any other dest is refused before anything is fetched or written.

Saves artwork images only inside an allowed download folder; any other dest is refused before anything is fetched or written.

No parameter schema in public metadata yet.

Configuration

ARTSONIA_USERNAME

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_PASSWORDsecret

Your Artsonia account password. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy.

ARTSONIA_SESSION_CACHE

Set to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.

ARTSONIA_SESSION_FILE

Absolute path for the session cache file. Defaults to $MCP_DATA_DIR/.artsonia-mcp/session-<user>.json.

ARTSONIA_OUTPUT_DIR

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_TRANSPORT

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_PORT

fetchproxy WebSocket port override (default 37149, a shared fleet port). Only used when ARTSONIA_TRANSPORT=fetchproxy.

ARTSONIA_INLINE_DOWNLOADS

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).

Readme

artsonia-mcp

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.

View the full README on GitHub

Details

Repository: github.com/chrischall/artsonia-mcp
Package: artsonia-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active