artsonia-mcp 0.2.0 → 0.3.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Artsonia — natural-language access to student-art portfolios, comments, and fans",
-    "version": "0.2.0"
+    "version": "0.3.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Artsonia",
       "source": "./",
       "description": "MCP server for Artsonia — access student portfolios, post comments, and manage fans via natural language",
-      "version": "0.2.0",
+      "version": "0.3.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "artsonia-mcp",
   "displayName": "Artsonia",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for Artsonia — natural-language access to student-art portfolios, comments, and fans",
   "author": {
     "name": "Chris Hall",

package/dist/bundle.js

@@ -23004,7 +23004,7 @@ var init_protocol = __esm({
               return;
             }
             const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+            await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
             options?.signal?.throwIfAborted();
           }
         } catch (error51) {
@@ -23021,7 +23021,7 @@ var init_protocol = __esm({
        */
       request(request, resultSchema, options) {
         const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-        return new Promise((resolve, reject) => {
+        return new Promise((resolve2, reject) => {
           const earlyReject = (error51) => {
             reject(error51);
           };
@@ -23099,7 +23099,7 @@ var init_protocol = __esm({
               if (!parseResult.success) {
                 reject(parseResult.error);
               } else {
-                resolve(parseResult.data);
+                resolve2(parseResult.data);
               }
             } catch (error51) {
               reject(error51);
@@ -23360,12 +23360,12 @@ var init_protocol = __esm({
           }
         } catch {
         }
-        return new Promise((resolve, reject) => {
+        return new Promise((resolve2, reject) => {
           if (signal.aborted) {
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
             return;
           }
-          const timeoutId = setTimeout(resolve, interval);
+          const timeoutId = setTimeout(resolve2, interval);
           signal.addEventListener("abort", () => {
             clearTimeout(timeoutId);
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -26392,7 +26392,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve.call(this, root, ref);
+      let _sch = resolve2.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -26419,7 +26419,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve(root, ref) {
+    function resolve2(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -27050,7 +27050,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve(baseURI, relativeURI, options) {
+    function resolve2(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse5(baseURI, schemelessOptions), parse5(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -27308,7 +27308,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve,
+      resolve: resolve2,
       resolveComponent,
       equal,
       serialize,
@@ -31435,7 +31435,7 @@ var init_mcp = __esm({
         let task = createTaskResult.task;
         const pollInterval = task.pollInterval ?? 5e3;
         while (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
-          await new Promise((resolve) => setTimeout(resolve, pollInterval));
+          await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
           const updatedTask = await extra.taskStore.getTask(taskId);
           if (!updatedTask) {
             throw new McpError(ErrorCode.InternalError, `Task ${taskId} not found during polling`);
@@ -32029,12 +32029,12 @@ var init_stdio2 = __esm({
         this.onclose?.();
       }
       send(message) {
-        return new Promise((resolve) => {
+        return new Promise((resolve2) => {
           const json2 = serializeMessage(message);
           if (this._stdout.write(json2)) {
-            resolve();
+            resolve2();
           } else {
-            this._stdout.once("drain", resolve);
+            this._stdout.once("drain", resolve2);
           }
         });
       }
@@ -32130,6 +32130,8 @@ var init_errors4 = __esm({
 });
 
 // node_modules/@chrischall/mcp-utils/dist/config/index.js
+import { homedir } from "node:os";
+import { isAbsolute, join, resolve } from "node:path";
 function readEnvVar(key, opts = {}) {
   const env = opts.env ?? process.env;
   const raw = env[key];
@@ -32141,6 +32143,15 @@ function readEnvVar(key, opts = {}) {
   }
   return opts.default;
 }
+function expandPath(p) {
+  let expanded = p;
+  if (p === "~") {
+    expanded = homedir();
+  } else if (p.startsWith("~/")) {
+    expanded = join(homedir(), p.slice(2));
+  }
+  return isAbsolute(expanded) ? expanded : resolve(expanded);
+}
 async function loadDotenvSafely(opts = {}) {
   try {
     const mod = await import(
@@ -32236,7 +32247,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "0.2.0";
+    VERSION = "0.3.0";
   }
 });
 
@@ -32245,7 +32256,6 @@ var transport_fetchproxy_exports = {};
 __export(transport_fetchproxy_exports, {
   FetchproxyArtsoniaTransport: () => FetchproxyArtsoniaTransport
 });
-import { FetchproxyServer } from "@fetchproxy/server";
 var DEFAULT_PORT, FetchproxyArtsoniaTransport;
 var init_transport_fetchproxy = __esm({
   "src/transport-fetchproxy.ts"() {
@@ -32255,23 +32265,31 @@ var init_transport_fetchproxy = __esm({
     init_version();
     DEFAULT_PORT = 37149;
     FetchproxyArtsoniaTransport = class {
-      inner;
+      inner = null;
       started = false;
-      constructor() {
+      starting = null;
+      buildOpts() {
         const portEnv = readEnvVar("ARTSONIA_WS_PORT");
-        const opts = {
+        return {
           port: portEnv ? Number(portEnv) : DEFAULT_PORT,
           serverName: "artsonia-mcp",
           version: VERSION,
           domains: ["artsonia.com"],
           capabilities: ["fetch"]
         };
-        this.inner = new FetchproxyServer(opts);
       }
       async ensureStarted() {
         if (this.started) return;
-        await this.inner.listen();
-        this.started = true;
+        if (this.starting) return this.starting;
+        this.starting = (async () => {
+          const { FetchproxyServer } = await import("@fetchproxy/server");
+          this.inner = new FetchproxyServer(this.buildOpts());
+          await this.inner.listen();
+          this.started = true;
+        })().finally(() => {
+          this.starting = null;
+        });
+        return this.starting;
       }
       async request(req) {
         await this.ensureStarted();
@@ -38295,7 +38313,7 @@ init_version();
 
 // src/client.ts
 init_dist();
-import { dirname, join } from "node:path";
+import { dirname, join as join2 } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/auth.ts
@@ -38457,7 +38475,7 @@ var ArtsoniaClient = class {
   }
 };
 var __dirname = dirname(fileURLToPath(import.meta.url));
-await loadDotenvSafely({ path: join(__dirname, "..", ".env"), override: false });
+await loadDotenvSafely({ path: join2(__dirname, "..", ".env"), override: false });
 var transport = await makeTransport();
 var client = new ArtsoniaClient({
   transport,
@@ -38560,6 +38578,7 @@ function parseArtwork(html) {
   }
   const bodyText = root.querySelector("body")?.text ?? "";
   const project = bodyText.match(/from school project "([^"]+)"/)?.[1] ?? "";
+  const grade = bodyText.match(/in Grade\s+(\w+)/i)?.[1] ?? null;
   const link = root.querySelector('a[href*="comments/enter.asp"]');
   const href = link?.getAttribute("href");
   const aId = attrId(href, "artist");
@@ -38569,7 +38588,10 @@ function parseArtwork(html) {
     author: text(c.querySelector(".comment-author")),
     text: text(c.querySelector(".comment-text"))
   }));
-  return { title, artist_screen_name, views, project, comment_entry, comments };
+  return { title, artist_screen_name, views, grade, project, comment_entry, comments };
+}
+function artworkImageUrl(artworkId, resolution = "full") {
+  return `https://images.artsonia.com/art/${resolution}/${artworkId}.jpg`;
 }
 function parseFans(html) {
   const root = (0, import_node_html_parser.parse)(html);
@@ -38588,6 +38610,57 @@ function parseFans(html) {
     return { name, relationship };
   }).filter((f) => f !== null);
 }
+function parseFeedback(html) {
+  const root = (0, import_node_html_parser.parse)(html);
+  return root.querySelectorAll(".comment-row").map((row) => {
+    const link = row.querySelector('.comment-art a[href*="art.asp"]');
+    const artwork_id = attrId(link?.getAttribute("href"), "id");
+    const options = text(row.querySelector(".comment-options"));
+    return {
+      artwork_id,
+      message: text(row.querySelector(".comment")),
+      posted_by: text(row.querySelector(".commenter")),
+      is_read: !/not been marked as read/i.test(options),
+      thumbnail: artwork_id ? `https://images.artsonia.com/art/small/${artwork_id}.jpg` : null
+    };
+  });
+}
+function parseAwards(html) {
+  const root = (0, import_node_html_parser.parse)(html);
+  const awards = [];
+  for (const card of root.querySelectorAll(".award-card")) {
+    const content = card.querySelector("div");
+    const lines = content ? content.querySelectorAll("div").map((d) => text(d)).filter(Boolean) : [];
+    const name = lines[0] ?? "";
+    if (!name) continue;
+    awards.push({
+      name,
+      earned: /^earned$/i.test((lines[1] ?? "").trim()),
+      description: lines[2] ?? "",
+      progress: lines[3] ?? "",
+      period: "current"
+    });
+  }
+  for (const card of root.querySelectorAll(".award-card-past")) {
+    const file2 = card.querySelector("img")?.getAttribute("src")?.split("/").pop() ?? "";
+    const slug = file2.replace(/\.gif$/i, "").replace(/_ghosted$/i, "").replace(/^artist_/i, "");
+    const name = slug ? slug.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()) : "Award";
+    awards.push({ name, earned: true, description: "", progress: "", period: "past" });
+  }
+  return awards;
+}
+function parseProfile(html) {
+  const form = (0, import_node_html_parser.parse)(html).querySelector("#TheForm");
+  const val = (name) => form?.querySelector(`input[name="${name}"], select[name="${name}"]`)?.getAttribute("value") ?? "";
+  const checked = (name) => form?.querySelector(`input[name="${name}"]`)?.hasAttribute("checked") ?? false;
+  return {
+    first_name: val("FirstName"),
+    last_name: val("LastName"),
+    email: val("EmailAddress"),
+    mobile: val("MobileNumber"),
+    opt_ins: { news: checked("OptInNews"), artist_activity: checked("OptInArtistActivity"), promos: checked("OptInPromos") }
+  };
+}
 
 // src/tools/healthcheck.ts
 function registerHealthcheckTools(server, client2) {
@@ -38704,11 +38777,177 @@ function registerFanTools(server, client2) {
   );
 }
 
+// src/tools/feedback.ts
+init_zod();
+init_dist();
+var NumericId2 = external_exports.string().regex(/^\d+$/, "must be a numeric id");
+function registerFeedbackTools(server, client2) {
+  server.registerTool(
+    "artsonia_get_feedback",
+    {
+      title: "Get teacher feedback for a student",
+      description: "List the teacher feedback left on a student's artwork \u2014 each item's message, who posted it and when, the artwork it's about, and whether it's been marked as read. Pass the artist_id from artsonia_list_students.",
+      annotations: toolAnnotations({ title: "Get teacher feedback for a student", readOnly: true, openWorld: true }),
+      inputSchema: { artist_id: NumericId2.describe("Student artist_id (from artsonia_list_students).") }
+    },
+    async ({ artist_id }) => {
+      const feedback = parseFeedback(await client2.fetchHtml(`/members/feedback/?artist=${artist_id}`));
+      return textResult({
+        artist_id,
+        unread_count: feedback.filter((f) => !f.is_read).length,
+        feedback
+      });
+    }
+  );
+  server.registerTool(
+    "artsonia_mark_feedback_read",
+    {
+      title: "Mark a student's feedback as read",
+      description: "Mark the student's teacher feedback as read (this is a mark-ALL action \u2014 Artsonia has no per-item control). Without confirm:true this is a DRY RUN that returns a preview and makes no network call.",
+      annotations: toolAnnotations({ title: "Mark a student's feedback as read", readOnly: false, openWorld: true }),
+      inputSchema: {
+        artist_id: NumericId2.describe("Student artist_id (from artsonia_list_students)."),
+        confirm: schemaConfirm
+      }
+    },
+    async ({ artist_id, confirm }) => {
+      const path = `/members/feedback/default.asp?artist=${artist_id}`;
+      const body = new URLSearchParams({ ConfirmAsRead: "Mark as Read" }).toString();
+      if (confirm !== true) {
+        return textResult({
+          preview: true,
+          action: "mark_feedback_read",
+          note: "DRY RUN \u2014 nothing was sent. Re-run with confirm: true to mark ALL of this student's feedback as read.",
+          wouldSend: { path, ConfirmAsRead: "Mark as Read" }
+        });
+      }
+      const res = await client2.write(path, body);
+      return textResult({ marked_read: true, artist_id, status: res.status });
+    }
+  );
+}
+
+// src/tools/account.ts
+init_zod();
+init_dist();
+function registerAccountTools(server, client2) {
+  server.registerTool(
+    "artsonia_get_awards",
+    {
+      title: "Get a student's awards & activities",
+      description: "List a student's Artsonia awards/achievement badges \u2014 current-year badges (name, earned/not, criteria, progress) plus badges earned in prior years. Pass the artist_id from artsonia_list_students.",
+      annotations: toolAnnotations({ title: "Get a student's awards & activities", readOnly: true, openWorld: true }),
+      inputSchema: { artist_id: external_exports.string().regex(/^\d+$/, "must be a numeric id").describe("Student artist_id (from artsonia_list_students).") }
+    },
+    async ({ artist_id }) => {
+      const awards = parseAwards(await client2.fetchHtml(`/artists/awards.asp?id=${artist_id}`));
+      return textResult({
+        artist_id,
+        earned_count: awards.filter((a) => a.earned).length,
+        awards
+      });
+    }
+  );
+  server.registerTool(
+    "artsonia_get_profile",
+    {
+      title: "Get your account profile",
+      description: "Show your Artsonia parent/fan account profile: name, email, mobile, and current notification opt-in states (news / artist activity / promos). Read-only complement to artsonia_set_notifications.",
+      annotations: toolAnnotations({ title: "Get your account profile", readOnly: true, openWorld: true }),
+      inputSchema: {}
+    },
+    async () => textResult(parseProfile(await client2.fetchHtml("/members/profile/")))
+  );
+}
+
+// src/tools/download.ts
+init_zod();
+init_dist();
+import { mkdir, writeFile } from "node:fs/promises";
+import { join as join3 } from "node:path";
+var NumericId3 = external_exports.string().regex(/^\d+$/, "must be a numeric id");
+function normalizeGrade(g) {
+  return (g ?? "").replace(/grade/i, "").trim().toLowerCase();
+}
+function registerDownloadTools(server, client2) {
+  server.registerTool(
+    "artsonia_download_artwork",
+    {
+      title: "Download a student's artwork images",
+      description: "Download full-resolution images of a student's artwork to a local folder. Optionally filter by class/project name (substring), by grade, and/or keep only the most-recent N (Artsonia exposes no real dates, but the portfolio is reliably newest-first). Without confirm:true this is a DRY RUN that lists what WOULD be downloaded and writes nothing. Note: project/grade filters require fetching each artwork's detail page (slower).",
+      annotations: toolAnnotations({ title: "Download a student's artwork images", readOnly: false, openWorld: true }),
+      inputSchema: {
+        artist_id: NumericId3.describe("Student artist_id (from artsonia_list_students)."),
+        dest: external_exports.string().min(1).describe("Local destination folder (a leading ~ is expanded). Created if missing."),
+        project: external_exports.string().min(1).optional().describe("Only artworks whose school-project/class name contains this (case-insensitive)."),
+        grade: external_exports.string().min(1).optional().describe('Only artworks created in this grade, e.g. "6" or "Grade 6".'),
+        limit: external_exports.number().int().positive().optional().describe("Keep only the N most recent matching artworks (portfolio is newest-first)."),
+        resolution: external_exports.enum(["full", "xlarge", "large", "medium", "small"]).default("full").describe('Image resolution. "full" is the original (~0.7 MB each).'),
+        confirm: schemaConfirm
+      }
+    },
+    async ({ artist_id, dest, project, grade, limit, resolution, confirm }) => {
+      const tiles = parsePortfolio(await client2.fetchHtml(`/artists/portfolio.asp?id=${artist_id}`));
+      let items = tiles.map((t) => ({ artwork_id: t.artwork_id }));
+      if (project !== void 0 || grade !== void 0) {
+        const wantGrade = normalizeGrade(grade);
+        const matched = [];
+        for (const t of tiles) {
+          const d = parseArtwork(await client2.fetchHtml(`/museum/art.asp?id=${t.artwork_id}`));
+          const okProject = project === void 0 || (d.project ?? "").toLowerCase().includes(project.toLowerCase());
+          const okGrade = grade === void 0 || normalizeGrade(d.grade) === wantGrade;
+          if (okProject && okGrade) matched.push({ artwork_id: t.artwork_id, title: d.title, project: d.project, grade: d.grade });
+        }
+        items = matched;
+      }
+      if (limit !== void 0) items = items.slice(0, limit);
+      const destDir = expandPath(dest);
+      if (confirm !== true) {
+        return textResult({
+          preview: true,
+          action: "download_artwork",
+          note: `DRY RUN \u2014 would download ${items.length} image(s) at "${resolution}" resolution to ${destDir}. Re-run with confirm: true to download.`,
+          count: items.length,
+          dest: destDir,
+          resolution,
+          artworks: items.slice(0, 100)
+        });
+      }
+      await mkdir(destDir, { recursive: true });
+      const downloaded = [];
+      const failed = [];
+      for (const it of items) {
+        try {
+          const res = await fetch(artworkImageUrl(it.artwork_id, resolution));
+          if (!res.ok) {
+            failed.push({ artwork_id: it.artwork_id, reason: `HTTP ${res.status}` });
+            continue;
+          }
+          const buf = Buffer.from(await res.arrayBuffer());
+          const file2 = join3(destDir, `${it.artwork_id}.jpg`);
+          await writeFile(file2, buf);
+          downloaded.push({ artwork_id: it.artwork_id, file: file2, bytes: buf.length });
+        } catch (e) {
+          failed.push({ artwork_id: it.artwork_id, reason: messageOf(e) });
+        }
+      }
+      return textResult({
+        downloaded_count: downloaded.length,
+        failed_count: failed.length,
+        dest: destDir,
+        resolution,
+        downloaded,
+        ...failed.length ? { failed } : {}
+      });
+    }
+  );
+}
+
 // src/tools/writes.ts
 init_zod();
 var import_node_html_parser2 = __toESM(require_dist2(), 1);
 init_dist();
-var NumericId2 = external_exports.string().regex(/^\d+$/, "must be a numeric id");
+var NumericId4 = external_exports.string().regex(/^\d+$/, "must be a numeric id");
 function previewResult(action, wouldSend, caveat) {
   return textResult({
     preview: true,
@@ -38749,8 +38988,8 @@ function registerWriteTools(server, client2) {
       description: "Post a comment on a student's artwork. Without confirm:true this is a DRY RUN that returns a preview and makes no network call.",
       annotations: toolAnnotations({ title: "Post a comment on an artwork", readOnly: false, openWorld: true }),
       inputSchema: {
-        artist_id: NumericId2.describe("Student artist_id (from artsonia_list_students)."),
-        artwork_id: NumericId2.describe("Artwork id (from artsonia_get_portfolio)."),
+        artist_id: NumericId4.describe("Student artist_id (from artsonia_list_students)."),
+        artwork_id: NumericId4.describe("Artwork id (from artsonia_get_portfolio)."),
         comment: external_exports.string().min(1).describe("The comment text to post."),
         confirm: schemaConfirm
       }
@@ -38770,11 +39009,11 @@ function registerWriteTools(server, client2) {
       description: "Invite someone (by name + email) to follow a student's Artsonia portfolio. Sends them an invite email. Without confirm:true this is a DRY RUN. Use only real addresses you're authorized to invite (test with @example.com).",
       annotations: toolAnnotations({ title: "Invite a fan", readOnly: false, openWorld: true }),
       inputSchema: {
-        artist_id: NumericId2.describe("Student artist_id (from artsonia_list_students)."),
+        artist_id: NumericId4.describe("Student artist_id (from artsonia_list_students)."),
         first_name: external_exports.string().min(1).describe("Fan's first name."),
         last_name: external_exports.string().min(1).describe("Fan's last name."),
         email: external_exports.string().email().describe("Fan's email address (they receive an invite)."),
-        relationship_id: NumericId2.describe("Relationship code (RelationshipID select value from the Add Fans form)."),
+        relationship_id: NumericId4.describe("Relationship code (RelationshipID select value from the Add Fans form)."),
         is_parent: external_exports.boolean().default(false).describe("Whether this fan is also a parent/guardian."),
         confirm: schemaConfirm
       }
@@ -38852,6 +39091,9 @@ var tools = [
   (s) => registerStudentTools(s, client),
   (s) => registerPortfolioTools(s, client),
   (s) => registerFanTools(s, client),
+  (s) => registerFeedbackTools(s, client),
+  (s) => registerAccountTools(s, client),
+  (s) => registerDownloadTools(s, client),
   (s) => registerWriteTools(s, client)
 ];
 await runMcp({

package/dist/{src/index.js → index.js}

@@ -6,6 +6,9 @@ import { registerHealthcheckTools } from './tools/healthcheck.js';
 import { registerStudentTools } from './tools/students.js';
 import { registerPortfolioTools } from './tools/portfolio.js';
 import { registerFanTools } from './tools/fans.js';
+import { registerFeedbackTools } from './tools/feedback.js';
+import { registerAccountTools } from './tools/account.js';
+import { registerDownloadTools } from './tools/download.js';
 import { registerWriteTools } from './tools/writes.js';
 // The client is a module-level singleton (constructed in client.ts) so the
 // deferred-config-error pattern holds: the server boots and answers the host's
@@ -16,6 +19,9 @@ const tools = [
     (s) => registerStudentTools(s, client),
     (s) => registerPortfolioTools(s, client),
     (s) => registerFanTools(s, client),
+    (s) => registerFeedbackTools(s, client),
+    (s) => registerAccountTools(s, client),
+    (s) => registerDownloadTools(s, client),
     (s) => registerWriteTools(s, client),
 ];
 await runMcp({

package/dist/{src/parse.js → parse.js}

@@ -100,9 +100,10 @@ export function parseArtwork(html) {
             break;
         }
     }
-    // project from body text: `from school project "<Project>"`
+    // project + grade from body text: `created by <name> in Grade <N> … from school project "<Project>"`
     const bodyText = root.querySelector('body')?.text ?? '';
     const project = bodyText.match(/from school project "([^"]+)"/)?.[1] ?? '';
+    const grade = bodyText.match(/in Grade\s+(\w+)/i)?.[1] ?? null;
     // comment entry link
     const link = root.querySelector('a[href*="comments/enter.asp"]');
     const href = link?.getAttribute('href');
@@ -117,7 +118,10 @@ export function parseArtwork(html) {
         author: text(c.querySelector('.comment-author')),
         text: text(c.querySelector('.comment-text')),
     }));
-    return { title, artist_screen_name, views, project, comment_entry, comments };
+    return { title, artist_screen_name, views, grade, project, comment_entry, comments };
+}
+export function artworkImageUrl(artworkId, resolution = 'full') {
+    return `https://images.artsonia.com/art/${resolution}/${artworkId}.jpg`;
 }
 export function parseFans(html) {
     const root = parse(html);
@@ -142,3 +146,60 @@ export function parseFans(html) {
         return { name, relationship };
     }).filter((f) => f !== null);
 }
+export function parseFeedback(html) {
+    const root = parse(html);
+    return root.querySelectorAll('.comment-row').map((row) => {
+        const link = row.querySelector('.comment-art a[href*="art.asp"]');
+        const artwork_id = attrId(link?.getAttribute('href'), 'id');
+        const options = text(row.querySelector('.comment-options'));
+        return {
+            artwork_id,
+            message: text(row.querySelector('.comment')),
+            posted_by: text(row.querySelector('.commenter')),
+            is_read: !/not been marked as read/i.test(options),
+            thumbnail: artwork_id ? `https://images.artsonia.com/art/small/${artwork_id}.jpg` : null,
+        };
+    });
+}
+export function parseAwards(html) {
+    const root = parse(html);
+    const awards = [];
+    // Current-year achievement badges: name / status / criteria / progress.
+    // The card is `<img><div>(content)<div>name</div><div>status</div>…</div>`;
+    // walk the content wrapper's child divs (the first descendant div is the wrapper).
+    for (const card of root.querySelectorAll('.award-card')) {
+        const content = card.querySelector('div');
+        const lines = content ? content.querySelectorAll('div').map((d) => text(d)).filter(Boolean) : [];
+        const name = lines[0] ?? '';
+        if (!name)
+            continue;
+        awards.push({
+            name,
+            earned: /^earned$/i.test((lines[1] ?? '').trim()),
+            description: lines[2] ?? '',
+            progress: lines[3] ?? '',
+            period: 'current',
+        });
+    }
+    // Past-year earned badges: just an icon (artist_<name>[_ghosted].gif).
+    for (const card of root.querySelectorAll('.award-card-past')) {
+        const file = card.querySelector('img')?.getAttribute('src')?.split('/').pop() ?? '';
+        const slug = file.replace(/\.gif$/i, '').replace(/_ghosted$/i, '').replace(/^artist_/i, '');
+        const name = slug ? slug.replace(/_/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()) : 'Award';
+        awards.push({ name, earned: true, description: '', progress: '', period: 'past' });
+    }
+    return awards;
+}
+/** Read-only view of the parent profile form (`#TheForm` on /members/profile/). */
+export function parseProfile(html) {
+    const form = parse(html).querySelector('#TheForm');
+    const val = (name) => form?.querySelector(`input[name="${name}"], select[name="${name}"]`)?.getAttribute('value') ?? '';
+    const checked = (name) => form?.querySelector(`input[name="${name}"]`)?.hasAttribute('checked') ?? false;
+    return {
+        first_name: val('FirstName'),
+        last_name: val('LastName'),
+        email: val('EmailAddress'),
+        mobile: val('MobileNumber'),
+        opt_ins: { news: checked('OptInNews'), artist_activity: checked('OptInArtistActivity'), promos: checked('OptInPromos') },
+    };
+}

package/dist/tools/account.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { textResult, toolAnnotations } from '@chrischall/mcp-utils';
+import { parseAwards, parseProfile } from '../parse.js';
+export function registerAccountTools(server, client) {
+    server.registerTool('artsonia_get_awards', {
+        title: "Get a student's awards & activities",
+        description: "List a student's Artsonia awards/achievement badges — current-year badges (name, earned/not, criteria, progress) plus badges earned in prior years. Pass the artist_id from artsonia_list_students.",
+        annotations: toolAnnotations({ title: "Get a student's awards & activities", readOnly: true, openWorld: true }),
+        inputSchema: { artist_id: z.string().regex(/^\d+$/, 'must be a numeric id').describe('Student artist_id (from artsonia_list_students).') },
+    }, async ({ artist_id }) => {
+        const awards = parseAwards(await client.fetchHtml(`/artists/awards.asp?id=${artist_id}`));
+        return textResult({
+            artist_id,
+            earned_count: awards.filter((a) => a.earned).length,
+            awards,
+        });
+    });
+    server.registerTool('artsonia_get_profile', {
+        title: 'Get your account profile',
+        description: 'Show your Artsonia parent/fan account profile: name, email, mobile, and current notification opt-in states (news / artist activity / promos). Read-only complement to artsonia_set_notifications.',
+        annotations: toolAnnotations({ title: 'Get your account profile', readOnly: true, openWorld: true }),
+        inputSchema: {},
+    }, async () => textResult(parseProfile(await client.fetchHtml('/members/profile/'))));
+}

package/dist/tools/download.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { textResult, toolAnnotations, schemaConfirm, expandPath, messageOf } from '@chrischall/mcp-utils';
+import { parsePortfolio, parseArtwork, artworkImageUrl } from '../parse.js';
+const NumericId = z.string().regex(/^\d+$/, 'must be a numeric id');
+/** "Grade 6" / "grade 6" / "6" → "6"; "Grade K" → "k". */
+function normalizeGrade(g) {
+    return (g ?? '').replace(/grade/i, '').trim().toLowerCase();
+}
+export function registerDownloadTools(server, client) {
+    server.registerTool('artsonia_download_artwork', {
+        title: "Download a student's artwork images",
+        description: "Download full-resolution images of a student's artwork to a local folder. Optionally filter by class/project name (substring), by grade, and/or keep only the most-recent N (Artsonia exposes no real dates, but the portfolio is reliably newest-first). Without confirm:true this is a DRY RUN that lists what WOULD be downloaded and writes nothing. Note: project/grade filters require fetching each artwork's detail page (slower).",
+        annotations: toolAnnotations({ title: "Download a student's artwork images", readOnly: false, openWorld: true }),
+        inputSchema: {
+            artist_id: NumericId.describe('Student artist_id (from artsonia_list_students).'),
+            dest: z.string().min(1).describe('Local destination folder (a leading ~ is expanded). Created if missing.'),
+            project: z.string().min(1).optional().describe('Only artworks whose school-project/class name contains this (case-insensitive).'),
+            grade: z.string().min(1).optional().describe('Only artworks created in this grade, e.g. "6" or "Grade 6".'),
+            limit: z.number().int().positive().optional().describe('Keep only the N most recent matching artworks (portfolio is newest-first).'),
+            resolution: z.enum(['full', 'xlarge', 'large', 'medium', 'small']).default('full').describe('Image resolution. "full" is the original (~0.7 MB each).'),
+            confirm: schemaConfirm,
+        },
+    }, async ({ artist_id, dest, project, grade, limit, resolution, confirm }) => {
+        // 1. Portfolio → artwork ids, newest-first.
+        const tiles = parsePortfolio(await client.fetchHtml(`/artists/portfolio.asp?id=${artist_id}`));
+        let items = tiles.map((t) => ({ artwork_id: t.artwork_id }));
+        // 2. project/grade filters need each artwork's detail page.
+        if (project !== undefined || grade !== undefined) {
+            const wantGrade = normalizeGrade(grade);
+            const matched = [];
+            for (const t of tiles) {
+                const d = parseArtwork(await client.fetchHtml(`/museum/art.asp?id=${t.artwork_id}`));
+                const okProject = project === undefined || (d.project ?? '').toLowerCase().includes(project.toLowerCase());
+                const okGrade = grade === undefined || normalizeGrade(d.grade) === wantGrade;
+                if (okProject && okGrade)
+                    matched.push({ artwork_id: t.artwork_id, title: d.title, project: d.project, grade: d.grade });
+            }
+            items = matched;
+        }
+        // 3. Most-recent-N.
+        if (limit !== undefined)
+            items = items.slice(0, limit);
+        const destDir = expandPath(dest);
+        // 4. Dry run.
+        if (confirm !== true) {
+            return textResult({
+                preview: true,
+                action: 'download_artwork',
+                note: `DRY RUN — would download ${items.length} image(s) at "${resolution}" resolution to ${destDir}. Re-run with confirm: true to download.`,
+                count: items.length,
+                dest: destDir,
+                resolution,
+                artworks: items.slice(0, 100),
+            });
+        }
+        // 5. Download.
+        await mkdir(destDir, { recursive: true });
+        const downloaded = [];
+        const failed = [];
+        for (const it of items) {
+            try {
+                const res = await fetch(artworkImageUrl(it.artwork_id, resolution));
+                if (!res.ok) {
+                    failed.push({ artwork_id: it.artwork_id, reason: `HTTP ${res.status}` });
+                    continue;
+                }
+                const buf = Buffer.from(await res.arrayBuffer());
+                const file = join(destDir, `${it.artwork_id}.jpg`);
+                await writeFile(file, buf);
+                downloaded.push({ artwork_id: it.artwork_id, file, bytes: buf.length });
+            }
+            catch (e) {
+                failed.push({ artwork_id: it.artwork_id, reason: messageOf(e) });
+            }
+        }
+        return textResult({
+            downloaded_count: downloaded.length,
+            failed_count: failed.length,
+            dest: destDir,
+            resolution,
+            downloaded,
+            ...(failed.length ? { failed } : {}),
+        });
+    });
+}

package/dist/tools/feedback.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { textResult, toolAnnotations, schemaConfirm } from '@chrischall/mcp-utils';
+import { parseFeedback } from '../parse.js';
+const NumericId = z.string().regex(/^\d+$/, 'must be a numeric id');
+export function registerFeedbackTools(server, client) {
+    server.registerTool('artsonia_get_feedback', {
+        title: 'Get teacher feedback for a student',
+        description: "List the teacher feedback left on a student's artwork — each item's message, who posted it and when, the artwork it's about, and whether it's been marked as read. Pass the artist_id from artsonia_list_students.",
+        annotations: toolAnnotations({ title: 'Get teacher feedback for a student', readOnly: true, openWorld: true }),
+        inputSchema: { artist_id: NumericId.describe('Student artist_id (from artsonia_list_students).') },
+    }, async ({ artist_id }) => {
+        const feedback = parseFeedback(await client.fetchHtml(`/members/feedback/?artist=${artist_id}`));
+        return textResult({
+            artist_id,
+            unread_count: feedback.filter((f) => !f.is_read).length,
+            feedback,
+        });
+    });
+    server.registerTool('artsonia_mark_feedback_read', {
+        title: 'Mark a student\'s feedback as read',
+        description: "Mark the student's teacher feedback as read (this is a mark-ALL action — Artsonia has no per-item control). Without confirm:true this is a DRY RUN that returns a preview and makes no network call.",
+        annotations: toolAnnotations({ title: "Mark a student's feedback as read", readOnly: false, openWorld: true }),
+        inputSchema: {
+            artist_id: NumericId.describe('Student artist_id (from artsonia_list_students).'),
+            confirm: schemaConfirm,
+        },
+    }, async ({ artist_id, confirm }) => {
+        const path = `/members/feedback/default.asp?artist=${artist_id}`;
+        const body = new URLSearchParams({ ConfirmAsRead: 'Mark as Read' }).toString();
+        if (confirm !== true) {
+            return textResult({
+                preview: true,
+                action: 'mark_feedback_read',
+                note: 'DRY RUN — nothing was sent. Re-run with confirm: true to mark ALL of this student\'s feedback as read.',
+                wouldSend: { path, ConfirmAsRead: 'Mark as Read' },
+            });
+        }
+        const res = await client.write(path, body);
+        return textResult({ marked_read: true, artist_id, status: res.status });
+    });
+}

package/dist/{src/transport-fetchproxy.js → transport-fetchproxy.js}

@@ -1,4 +1,3 @@
-import { FetchproxyServer } from '@fetchproxy/server';
 import { ARTSONIA_ORIGIN } from './transport.js';
 import { readEnvVar } from '@chrischall/mcp-utils';
 import { VERSION } from './version.js';
@@ -8,24 +7,34 @@ const DEFAULT_PORT = 37_149; // shared fleet port — do NOT change
 // fetchproxy. Cookies are carried by the browser, so the AuthManager's jar is
 // unused in this mode; login is whatever the browser already holds.
 export class FetchproxyArtsoniaTransport {
-    inner;
+    inner = null;
     started = false;
-    constructor() {
+    starting = null;
+    buildOpts() {
         const portEnv = readEnvVar('ARTSONIA_WS_PORT');
-        const opts = {
+        return {
             port: portEnv ? Number(portEnv) : DEFAULT_PORT,
             serverName: 'artsonia-mcp',
             version: VERSION,
             domains: ['artsonia.com'],
             capabilities: ['fetch'],
         };
-        this.inner = new FetchproxyServer(opts);
     }
     async ensureStarted() {
         if (this.started)
             return;
-        await this.inner.listen();
-        this.started = true;
+        // Single-flight: concurrent first-calls share one init so we never construct
+        // two FetchproxyServers / bind the shared port twice.
+        if (this.starting)
+            return this.starting;
+        this.starting = (async () => {
+            // Lazy import: only loaded when fetchproxy mode is actually used.
+            const { FetchproxyServer } = await import('@fetchproxy/server');
+            this.inner = new FetchproxyServer(this.buildOpts());
+            await this.inner.listen();
+            this.started = true;
+        })().finally(() => { this.starting = null; });
+        return this.starting;
     }
     async request(req) {
         await this.ensureStarted();

package/dist/{src/version.js → version.js}

@@ -1,3 +1,3 @@
 // Single source of truth for the server version. The marker is what
 // release-please bumps; versionSyncTest asserts it equals package.json.
-export const VERSION = '0.2.0'; // x-release-please-version
+export const VERSION = '0.3.0'; // x-release-please-version

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "artsonia-mcp",
   "display_name": "Artsonia",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Artsonia student-art portfolios, comments, and fans for Claude — access via natural language",
   "author": {
     "name": "Chris Chall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artsonia-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "mcpName": "io.github.chrischall/artsonia-mcp",
   "description": "Artsonia MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/artsonia-mcp",
     "source": "github"
   },
-  "version": "0.2.0",
+  "version": "0.3.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "artsonia-mcp",
-      "version": "0.2.0",
+      "version": "0.3.0",
       "transport": {
         "type": "stdio"
       },