infinitecampus-mcp 2.3.6 → 2.4.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Infinite Campus (Campus Parent) — grades, attendance, assignments, messages, documents",
-    "version": "2.3.6"
+    "version": "2.4.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Infinite Campus",
       "source": "./",
       "description": "Infinite Campus (Campus Parent) MCP server for Claude — grades, attendance, assignments, messages, and documents via natural language",
-      "version": "2.3.6",
+      "version": "2.4.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "infinitecampus-mcp",
   "displayName": "Infinite Campus",
-  "version": "2.3.6",
+  "version": "2.4.0",
   "description": "Infinite Campus (Campus Parent) MCP server for Claude — grades, attendance, assignments, messages, and documents",
   "author": {
     "name": "Chris Hall",
@@ -18,6 +18,6 @@
     "k12",
     "mcp"
   ],
-  "skills": "./SKILL.md",
+  "skills": "./skills/",
   "mcp": "./.mcp.json"
 }

package/dist/bundle.js

@@ -34845,6 +34845,7 @@ var KNOWN_CAPABILITIES = /* @__PURE__ */ new Set([
   "capture_request_header",
   "capture_redirect",
   "read_indexed_db",
+  "read_dom",
   "download"
 ]);
 
@@ -35146,6 +35147,44 @@ function assertIndexedDbScopesArray(value, label) {
     }
   }
 }
+var DOM_SELECTOR_RE = /^[^-]{1,512}$/;
+var DOM_ATTRIBUTE_RE = /^[A-Za-z_:][A-Za-z0-9_:.\-]{0,127}$/;
+function assertDomSelectorsArray(value, label) {
+  if (!Array.isArray(value)) {
+    throw new ProtocolError(`${label}: expected array, got ${typeof value}`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (let i = 0; i < value.length; i++) {
+    const entry = value[i];
+    assertObject(entry, `${label}[${i}]`);
+    if (entry.name === void 0) {
+      throw new ProtocolError(`${label}[${i}].name: missing`);
+    }
+    if (entry.selector === void 0) {
+      throw new ProtocolError(`${label}[${i}].selector: missing`);
+    }
+    if (typeof entry.name !== "string" || !SCOPE_KEY_RE.test(entry.name)) {
+      throw new ProtocolError(`${label}[${i}].name: invalid ${JSON.stringify(entry.name)}`);
+    }
+    if (typeof entry.selector !== "string" || !DOM_SELECTOR_RE.test(entry.selector)) {
+      throw new ProtocolError(`${label}[${i}].selector: invalid ${JSON.stringify(entry.selector)}`);
+    }
+    if (entry.attribute !== void 0) {
+      if (typeof entry.attribute !== "string" || !DOM_ATTRIBUTE_RE.test(entry.attribute)) {
+        throw new ProtocolError(`${label}[${i}].attribute: invalid ${JSON.stringify(entry.attribute)}`);
+      }
+    }
+    if (seen.has(entry.name)) {
+      throw new ProtocolError(`${label}: duplicate name ${JSON.stringify(entry.name)}`);
+    }
+    seen.add(entry.name);
+    for (const k of Object.keys(entry)) {
+      if (k !== "name" && k !== "selector" && k !== "attribute") {
+        throw new ProtocolError(`${label}[${i}]: unexpected field ${JSON.stringify(k)}`);
+      }
+    }
+  }
+}
 function validateFrame(raw) {
   assertObject(raw, "frame");
   const t = raw.type;
@@ -35221,6 +35260,9 @@ function validateHello(raw) {
     if (raw.sessionStoragePointers !== void 0) {
       assertStoragePointersArray(raw.sessionStoragePointers, "hello.sessionStoragePointers", raw.sessionStorageKeys);
     }
+    if (raw.domSelectors !== void 0) {
+      assertDomSelectorsArray(raw.domSelectors, "hello.domSelectors");
+    }
     assertBase64(raw.identityX25519Pub, "hello.identityX25519Pub");
     assertBase64(raw.identityEd25519Pub, "hello.identityEd25519Pub");
     assertBase64(raw.sessionNonce, "hello.sessionNonce");
@@ -35455,6 +35497,21 @@ function validateInnerRequest(raw) {
     }
     return raw;
   }
+  if (raw.op === "read_dom") {
+    assertObject(raw.init, "inner.init");
+    if (raw.init.origin === void 0)
+      throw new ProtocolError("inner.init.origin: missing");
+    if (raw.init.names === void 0)
+      throw new ProtocolError("inner.init.names: missing");
+    assertHttpsOriginOnly(raw.init.origin, "inner.init.origin");
+    assertNonEmptyKeyArray(raw.init.names, "inner.init.names");
+    for (const k of Object.keys(raw.init)) {
+      if (k !== "origin" && k !== "names") {
+        throw new ProtocolError(`inner.init: unexpected field ${JSON.stringify(k)} on read_dom`);
+      }
+    }
+    return raw;
+  }
   if (raw.op === "download") {
     assertObject(raw.init, "inner.init");
     if (raw.init.url === void 0) {
@@ -35480,7 +35537,7 @@ function validateInnerRequest(raw) {
     }
     return raw;
   }
-  throw new ProtocolError(`inner.op: must be one of "fetch", "read_cookies", "read_local_storage", "read_session_storage", "capture_request_header", "capture_redirect", "read_indexed_db", "download"; got ${JSON.stringify(raw.op)}`);
+  throw new ProtocolError(`inner.op: must be one of "fetch", "read_cookies", "read_local_storage", "read_session_storage", "capture_request_header", "capture_redirect", "read_indexed_db", "read_dom", "download"; got ${JSON.stringify(raw.op)}`);
 }
 function assertNonEmptyKeyArray(value, label) {
   if (!Array.isArray(value)) {
@@ -35565,6 +35622,13 @@ function validateInnerResponse(raw) {
       assertObject(raw.values, "inner.values");
       return raw;
     }
+    if (op === "read_dom") {
+      if (raw.values === void 0) {
+        throw new ProtocolError("inner.values: missing on read_dom response");
+      }
+      assertStringMap(raw.values, "inner.values");
+      return raw;
+    }
     if (op === "download") {
       assertObject(raw.value, "inner.value");
       assertString(raw.value.path, "inner.value.path");
@@ -35904,6 +35968,13 @@ async function buildServerHello(opts) {
       jsonPointer: d.jsonPointer
     }));
   }
+  if (opts.domSelectors && opts.domSelectors.length > 0) {
+    hello.domSelectors = opts.domSelectors.map((d) => ({
+      name: d.name,
+      selector: d.selector,
+      ...d.attribute !== void 0 ? { attribute: d.attribute } : {}
+    }));
+  }
   return hello;
 }
 
@@ -35993,7 +36064,8 @@ async function startHost(opts) {
     captureHeaders: opts.ownCaptureHeaders,
     indexedDbScopes: opts.ownIndexedDbScopes,
     localStoragePointers: opts.ownLocalStoragePointers,
-    sessionStoragePointers: opts.ownSessionStoragePointers
+    sessionStoragePointers: opts.ownSessionStoragePointers,
+    domSelectors: opts.ownDomSelectors
   });
   const ownSessionNonce = fromB64(ownHello.sessionNonce);
   let extensionWs = null;
@@ -36228,6 +36300,7 @@ async function startPeer(opts) {
     sessionStorageKeys: opts.sessionStorageKeys,
     captureHeaders: opts.captureHeaders,
     indexedDbScopes: opts.indexedDbScopes,
+    domSelectors: opts.domSelectors,
     localStoragePointers: opts.localStoragePointers,
     sessionStoragePointers: opts.sessionStoragePointers
   });
@@ -36635,6 +36708,11 @@ var FetchproxyServer = class {
         key: d.key,
         jsonPointer: d.jsonPointer
       })),
+      domSelectors: (opts.domSelectors ?? []).map((d) => ({
+        name: d.name,
+        selector: d.selector,
+        ...d.attribute !== void 0 ? { attribute: d.attribute } : {}
+      })),
       // 0.8.0+: timer + lazy-revive default to ON. Every realty MCP
       // adapter was about to set these to the same numbers anyway; the
       // back-door is `0` (explicit opt-out) if a caller genuinely wants
@@ -36755,6 +36833,7 @@ var FetchproxyServer = class {
         ownIndexedDbScopes: this.opts.indexedDbScopes,
         ownLocalStoragePointers: this.opts.localStoragePointers,
         ownSessionStoragePointers: this.opts.sessionStoragePointers,
+        ownDomSelectors: this.opts.domSelectors,
         onPairCode: this.opts.onPairCode
       });
       this.hostHandle.onOwnInner((inner) => this.onInner(inner));
@@ -36782,7 +36861,8 @@ var FetchproxyServer = class {
         captureHeaders: this.opts.captureHeaders,
         indexedDbScopes: this.opts.indexedDbScopes,
         localStoragePointers: this.opts.localStoragePointers,
-        sessionStoragePointers: this.opts.sessionStoragePointers
+        sessionStoragePointers: this.opts.sessionStoragePointers,
+        domSelectors: this.opts.domSelectors
       });
       this.peerHandle.onInner((inner) => this.onInner(inner));
       this.peerHandle.onRenegotiate(() => {
@@ -37757,6 +37837,46 @@ var FetchproxyServer = class {
     await this.sendInnerFrame(inner);
     return this._withVerbTimeout(pending, this.pendingIdb, id, origin);
   }
+  /**
+   * 1.4.0+: read declared DOM values from the user's signed-in tab.
+   * Requires `'read_dom'` in capabilities AND every requested `name` to
+   * match a declared `domSelectors` entry. The extension reads each
+   * declared selector from the matched tab's DOM (isolated-world
+   * `querySelector`, value or attribute) — no page-JS execution.
+   *
+   * Returns a `Record<string, string>` of `name → value`, with names
+   * whose element (or attribute) was absent omitted. Throws
+   * `FetchproxyProtocolError` on bridge failures and a plain `Error` on
+   * developer mistakes (undeclared capability, undeclared name).
+   */
+  async readDom(opts) {
+    if (!this.opts.capabilities.includes("read_dom")) {
+      throw new Error('FetchproxyServer.readDom(): MCP did not declare "read_dom" in capabilities');
+    }
+    await this.ensureConnected();
+    this.throwIfPendingPair();
+    if (!Array.isArray(opts.names) || opts.names.length === 0) {
+      throw new Error("FetchproxyServer.readDom: opts.names must be a non-empty array");
+    }
+    this.assertScopeSubset(opts.names, this.opts.domSelectors.map((d) => d.name), "domSelectors");
+    if (opts.subdomain !== void 0)
+      assertSubdomainLabel(opts.subdomain);
+    const baseDomain = this.resolveBaseDomain(opts.domain);
+    const host = opts.subdomain ? `${opts.subdomain}.${baseDomain}` : baseDomain;
+    const origin = `https://${host}`;
+    const id = this.nextRequestId++;
+    const inner = {
+      type: "request",
+      id,
+      op: "read_dom",
+      init: { origin, names: [...opts.names] }
+    };
+    const pending = new Promise((resolve, reject) => {
+      this.pendingStorage.set(id, { resolve, reject });
+    });
+    await this.sendInnerFrame(inner);
+    return this._withVerbTimeout(pending, this.pendingStorage, id, origin);
+  }
   assertScopeSubset(requested, declared, label) {
     const undeclared = undeclaredKeys(requested, declared);
     if (undeclared.length > 0) {
@@ -37828,7 +37948,7 @@ var FetchproxyServer = class {
     if (storageCb) {
       this.pendingStorage.delete(inner.id);
       if (inner.ok) {
-        if ((inner.op === "read_local_storage" || inner.op === "read_session_storage") && inner.values) {
+        if ((inner.op === "read_local_storage" || inner.op === "read_session_storage" || inner.op === "read_dom") && inner.values) {
           storageCb.resolve({ ...inner.values });
         } else {
           storageCb.reject(new FetchproxyProtocolError(`unexpected ${String(inner.op)} response on storage awaiter`));
@@ -38191,7 +38311,7 @@ function loadAccount(env = process.env) {
 // package.json
 var package_default = {
   name: "infinitecampus-mcp",
-  version: "2.3.6",
+  version: "2.4.0",
   mcpName: "io.github.chrischall/infinitecampus-mcp",
   description: "Infinite Campus (Campus Parent) MCP server \u2014 multi-district read + message/document write",
   author: "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -38233,19 +38353,19 @@ var package_default = {
     "test:watch": "vitest"
   },
   dependencies: {
-    "@chrischall/mcp-utils": "^0.12.0",
+    "@chrischall/mcp-utils": "^0.13.0",
     "@fetchproxy/bootstrap": "^1.0.0",
     "@fetchproxy/server": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     dotenv: "^17.4.2",
-    "node-html-parser": "^8.0.2",
+    "node-html-parser": "^9.0.0",
     zod: "^4.4.3"
   },
   devDependencies: {
     "@types/node": "^26.0.0",
     "@vitest/coverage-v8": "^4.1.7",
     esbuild: "^0.28.0",
-    typescript: "^6.0.3",
+    typescript: "^7.0.2",
     vitest: "^4.1.7"
   }
 };
@@ -39807,7 +39927,7 @@ try {
 }
 var COMMON = {
   name: "infinitecampus",
-  version: "2.3.6"
+  version: "2.4.0"
   // x-release-please-version
 };
 if (account) {

package/dist/index.js

@@ -57,7 +57,7 @@ catch (e) {
 // actionable stderr message (banner) instead of a crash loop.
 const COMMON = {
     name: 'infinitecampus',
-    version: '2.3.6', // x-release-please-version
+    version: '2.4.0', // x-release-please-version
 };
 if (account) {
     const client = new ICClient(account, { preloaded });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infinitecampus-mcp",
-  "version": "2.3.6",
+  "version": "2.4.0",
   "mcpName": "io.github.chrischall/infinitecampus-mcp",
   "description": "Infinite Campus (Campus Parent) MCP server — multi-district read + message/document write",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -42,19 +42,19 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.12.0",
+    "@chrischall/mcp-utils": "^0.13.0",
     "@fetchproxy/bootstrap": "^1.0.0",
     "@fetchproxy/server": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.2",
-    "node-html-parser": "^8.0.2",
+    "node-html-parser": "^9.0.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",
     "@vitest/coverage-v8": "^4.1.7",
     "esbuild": "^0.28.0",
-    "typescript": "^6.0.3",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.7"
   }
 }

package/server.json

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

package/skills/infinitecampus-api/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: infinitecampus-api
+description: >-
+  Query an Infinite Campus (Campus Parent portal) district directly with curl
+  instead of running the infinitecampus-mcp server — log in with a real
+  username/password, capture the session cookie + XSRF token, and curl grades,
+  attendance, assignments, schedule, messages, documents, and fees. Use when
+  you want IC data without the MCP, in a script, or on a machine where the MCP
+  isn't installed. Infinite Campus is per-district: the base URL and district
+  app name are configurable, not hardcoded.
+---
+
+# Infinite Campus via curl (no MCP)
+
+Infinite Campus's Campus Parent portal is a classic server-rendered site
+(no public API, no bot wall). A plain form POST to `verify.jsp` logs a
+parent in and hands back a session cookie — no browser bridge needed. This
+is the same login `infinitecampus-mcp`'s `src/client.ts`/`src/auth.ts` do;
+this skill reproduces it with `curl` + a cookie jar.
+
+**Infinite Campus is per-district.** Every parent's portal lives at their
+own district's host (`https://campus.<district>.k12.example.us` or similar)
+under an `appName` path segment. There is no shared IC endpoint — carry the
+base URL and district from the same config the MCP uses:
+
+```sh
+: "${IC_BASE_URL:?set to your district's portal URL, e.g. https://campus.yourdistrict.org}"
+: "${IC_DISTRICT:?set to the appName path segment, e.g. yourdistrict}"
+: "${IC_USERNAME:?parent portal username}"
+: "${IC_PASSWORD:?parent portal password}"
+```
+
+(Same 4 env vars the MCP reads — reuse the repo's `.env` or the host's
+secret store; don't hardcode a district.)
+
+## One-time setup
+
+None — `curl` and `jq` are the only tools needed (`brew install jq` if
+missing). No profile/pairing step, no extension.
+
+## Login (capture cookies + XSRF token)
+
+`verify.jsp` accepts a urlencoded form POST and returns 200 with an
+`<AUTHENTICATION>state</AUTHENTICATION>` marker in the body — **not**
+via HTTP status — plus ~20 `Set-Cookie` headers. Use a cookie jar so curl
+does the Set-Cookie parsing/deduping for you:
+
+```sh
+JAR=$(mktemp)
+BODY=$(curl -sS -c "$JAR" \
+  "$IC_BASE_URL/campus/verify.jsp?nonBrowser=true" \
+  --data-urlencode "username=$IC_USERNAME" \
+  --data-urlencode "password=$IC_PASSWORD" \
+  --data-urlencode "appName=$IC_DISTRICT" \
+  --data-urlencode "portalLoginPage=parents")
+
+echo "$BODY" | grep -o '<AUTHENTICATION>[^<]*' # AUTHENTICATIONsuccess = good
+```
+
+`password-error` / `account-locked` / any non-`success` state means the
+login failed — check that string before doing anything else. Credentials
+go in the form body (never the query string — it lands in access logs).
+
+Pull the XSRF token out of the jar (IC's JS reads it back and echoes it on
+every request as `X-XSRF-TOKEN`; `JSESSIONID` alone is not enough):
+
+```sh
+XSRF=$(awk -F'\t' '$6=="XSRF-TOKEN"{print $7}' "$JAR")
+```
+
+## Core call pattern
+
+Every subsequent request rides the jar + the XSRF header:
+
+```sh
+ic_get() { # ic_get <path-with-query>
+  curl -sS -b "$JAR" -H "X-XSRF-TOKEN: $XSRF" -H 'Accept: application/json' \
+    "$IC_BASE_URL$1"
+}
+
+ic_get '/campus/api/portal/students' | jq .
+```
+
+A **401** means the session expired (IC sessions last ~5-6h) — re-run the
+Login step to get a fresh `$JAR`/`$XSRF` and retry once. There is no retry
+budget beyond that in this shell version (the MCP's `CookieSessionManager`
+does this automatically; here just redo the login block).
+
+## The one rule: resolve student + enrollment first
+
+Almost every read is scoped to a `personID` (student), and several need the
+student's **enrollment** (`enrollmentID` / `calendarID` / `structureID`).
+Always start with:
+
+```sh
+ic_get '/campus/api/portal/students' | jq '.[] | {personID, firstName, lastName, enrollments}'
+```
+
+Take `personID` for `studentId`/`personID` params, and the first (or
+relevant) `enrollments[]` entry's `enrollmentID`/`calendarID`/`structureID`
+for the endpoints that need them (attendance, school days, assessments,
+features). There is no name→id search — `ic_list_students` (i.e. this call)
+*is* the resolve step.
+
+## Endpoints
+
+All 17 read endpoints (grades, attendance, assignments, schedule, messages,
+documents, fees, teachers, assessments, feature flags) with ready-to-run
+`curl`+`jq` recipes are in `references/endpoints.md`. Two (`behavior`,
+`food_service`) have real paths that were never confirmed live against a
+district with that module enabled — try them, expect a 404 if the module
+is off or the district's shape differs.
+
+## Downloads
+
+`ic_download_document`'s `url` field (from the documents list) may be a
+relative `/campus/...` path or an absolute URL. Same jar + header pattern,
+just write to a file instead of piping to `jq`:
+
+```sh
+curl -sS -b "$JAR" -H "X-XSRF-TOKEN: $XSRF" -o report-card.pdf "$IC_BASE_URL$DOC_URL"
+```
+
+## FeatureDisabled districts
+
+Some districts turn whole modules off (behavior, food service, assessments,
+documents, attendance). The MCP checks `displayOptions` first and falls
+back to treating a 404 as "disabled." Doing the same by hand: fetch
+`/campus/api/portal/displayOptions/{structureID}?personID=X` (see
+references) and check the flag before assuming a 404 is a bug.
+
+## Notes
+
+- Read-only in practice: every recipe here is a GET. `ic_get_message`
+  fetching a message body *may* mark it read on some district configs — the
+  MCP's own probe couldn't confirm the side effect either way.
+- No CUPS linked-district switching in this skill (a parent with kids in
+  2+ IC instances under shared SSO) — that's a multi-step token-exchange
+  flow (`src/client.ts`'s `discoverLinkedDistricts`); out of scope here.
+  Run the login flow again against the linked district's own
+  `IC_BASE_URL`/`IC_DISTRICT` if you need it.
+- This project is developed and maintained by AI (Claude).

package/skills/infinitecampus-api/references/endpoints.md

@@ -0,0 +1,225 @@
+# Infinite Campus endpoints for curl
+
+Assumes the Login block from `../SKILL.md` has already run (`$JAR`, `$XSRF`,
+`$IC_BASE_URL` set) and the `ic_get` helper is defined:
+
+```sh
+ic_get() { curl -sS -b "$JAR" -H "X-XSRF-TOKEN: $XSRF" -H 'Accept: application/json' "$IC_BASE_URL$1"; }
+```
+
+All paths are transcribed from `infinitecampus-mcp`'s `src/tools/*.ts` and
+`docs/endpoints.md` — the same requests the `ic_*` MCP tools make. `$PID` =
+a student's `personID` from the resolve-first step.
+
+Some IC/prism responses serialize a 1-item collection as a bare object
+instead of a 1-element array — pipe through `jq 'if type=="array" then . else [.] end'`
+if a recipe below assumes an array and you get an object back.
+
+---
+
+## Students (resolve-first — always start here)
+
+```sh
+ic_get '/campus/api/portal/students' \
+  | jq '.[] | {personID, firstName, lastName, enrollments}'
+```
+
+Each `enrollments[]` entry carries `enrollmentID`, `calendarID`,
+`structureID`, `schoolName`, `endDate` — needed by several endpoints below.
+
+## Schedule
+
+```sh
+ic_get "/campus/resources/portal/roster?personID=$PID" | jq .
+```
+
+(Only `personID` is honored server-side — no working date/term filter, even
+though the MCP tool's schema accepts `date`/`termFilter` args.)
+
+## Assignments
+
+```sh
+# all assignments (full term history, ~hundreds of rows)
+ic_get "/campus/api/portal/assignment/listView?personID=$PID" | jq .
+
+# scoped to one course (sectionID from the schedule call above)
+ic_get "/campus/api/portal/assignment/listView?personID=$PID&sectionID=$SECTION_ID" | jq .
+
+# client-side filters (server ignores date/missing params entirely):
+ic_get "/campus/api/portal/assignment/listView?personID=$PID" \
+  | jq --arg since 2026-01-01 '[.[] | select(.dueDate >= $since)]'
+```
+
+## Recent (recently-graded) assignments
+
+Server-side filtered by `modifiedDate` (defaults to 14 days ago in the MCP;
+reproduce with `date -u -v-14d '+%Y-%m-%dT00:00:00'` on macOS):
+
+```sh
+SINCE=$(date -u -v-14d '+%Y-%m-%dT00:00:00')
+ic_get "/campus/api/portal/assignment/recentlyScored?modifiedDate=$SINCE&personID=$PID" | jq .
+```
+
+## Grades
+
+```sh
+ic_get "/campus/resources/portal/grades?personID=$PID" | jq .
+# scoped to one term:
+ic_get "/campus/resources/portal/grades?personID=$PID&termID=$TERM_ID" | jq .
+```
+
+## Attendance (per-course summary, loop over each enrollment)
+
+```sh
+ic_get "/campus/resources/portal/attendance/$ENROLLMENT_ID?courseSummary=true&personID=$PID" \
+  | jq '.terms[]?.courses[]? | {absentList, tardyList, presentList, earlyReleaseList}'
+```
+
+Feature-gated: check `displayOptions.attendance` first (see Feature flags,
+below) — a 404 here on a district with attendance disabled is expected, not
+a bug.
+
+## Attendance events (individual absences/tardies, loop over each enrollment)
+
+```sh
+ic_get "/campus/resources/portal/attendance/events?enrollmentID=$ENROLLMENT_ID&personID=$PID" \
+  | jq '.events[]? | {date: .localDate, code, description, excuse, comments}'
+
+# excused-only, since a date (client-side filter):
+ic_get "/campus/resources/portal/attendance/events?enrollmentID=$ENROLLMENT_ID&personID=$PID" \
+  | jq --arg since 2026-01-01 '[.events[]? | select((.localDate[0:10] >= $since) and (.excuse == "E"))]'
+```
+
+## School days / calendar (loop over each enrollment)
+
+Two calls per enrollment, then join term windows to days client-side:
+
+```sh
+ic_get "/campus/resources/term?structureID=$STRUCTURE_ID" | jq .          # term boundaries
+ic_get "/campus/resources/calendar/instructionalDay?calendarID=$CALENDAR_ID" | jq .  # day list
+
+# days within term N's [startDate,endDate]:
+jq --slurpfile terms terms.json --arg t "$TERM_ID" \
+  '[.[] | select(.date >= $terms[0][0].startDate and .date <= $terms[0][0].endDate)]' days.json
+```
+
+## Assessments (standardized tests, loop over each enrollment)
+
+```sh
+ic_get "/campus/resources/prism/portal/assessments?personID=$PID&calendarID=$CALENDAR_ID" \
+  | jq '{stateTests, nationalTests, districtTests}'
+```
+
+Feature-gated on `displayOptions.assessment`; test-item shape varies by
+district/test type — pass through unchanged, don't assume field names
+beyond `stateTests`/`nationalTests`/`districtTests`.
+
+## Behavior *(path unconfirmed — never verified live against a district with the module on)*
+
+```sh
+ic_get "/campus/resources/portal/behavior?personID=$PID" | jq .
+# with a date range:
+ic_get "/campus/resources/portal/behavior?personID=$PID&startDate=2026-01-01&endDate=2026-06-01" | jq .
+```
+
+Feature-gated on `displayOptions.behavior` — a 404 is the expected result
+on most districts (few enable this module for parent portal).
+
+## Food service *(path unconfirmed — same caveat as behavior)*
+
+```sh
+ic_get "/campus/resources/portal/foodService?personID=$PID" | jq .
+ic_get "/campus/resources/portal/foodService?personID=$PID&startDate=2026-01-01&endDate=2026-06-01" | jq .
+```
+
+Feature-gated on `displayOptions.foodService`.
+
+## Documents + download
+
+```sh
+ic_get "/campus/resources/portal/report/all?personID=$PID" \
+  | jq '.[] | {name, type, url, moduleLabel, endYear}'
+
+# download (url may be relative /campus/... or an absolute URL — handle both):
+DOC_URL='/campus/resources/portal/report/...'   # from the .url field above
+curl -sS -b "$JAR" -H "X-XSRF-TOKEN: $XSRF" -o report-card.pdf \
+  "$( [[ "$DOC_URL" == http* ]] && echo "$DOC_URL" || echo "$IC_BASE_URL$DOC_URL" )"
+```
+
+Feature-gated on `displayOptions.documents`.
+
+## Teachers + counselors
+
+```sh
+ic_get "/campus/resources/portal/section/contacts?personID=$PID" | jq .
+ic_get "/campus/resources/portal/studentCounselor/byUser?personID=$PID" | jq .
+```
+
+Either endpoint 404ing is treated as "no results" (not FeatureDisabled) by
+the MCP — do the same.
+
+## Messages (three independent sources — combine client-side)
+
+```sh
+# 1. prism notifications (assignment/grade/attendance alerts)
+ic_get '/campus/prism?x=notifications.Notification-retrieve&limitCount=20' \
+  | jq '.data.NotificationList.Notification'
+
+# 2. Messenger 2.0 inbox (teacher messages, district announcements)
+ic_get '/campus/api/portal/process-message' | jq .
+
+# 3. portal userNotice announcements
+ic_get '/campus/resources/portal/userNotice' | jq .
+```
+
+Each inbox item's `url` field feeds `ic_get_message` below (normalize a bare
+or `portal/...`-relative URL to `/campus/portal/...` first).
+
+## Get one message body (HTML → text)
+
+```sh
+# normalize: bare "portal/..." → "/campus/portal/..."; already-absolute /campus/... stays as-is
+MSG_PATH='/campus/portal/messageView.xsl?x=messenger.MessengerEngine-getMessageRecipientView&messageID=...&messageRecipientID=...'
+curl -sS -b "$JAR" -H "X-XSRF-TOKEN: $XSRF" -H 'Accept: text/html' "$IC_BASE_URL$MSG_PATH"
+# then strip tags/entities yourself, or eyeball the rendered HTML — this is
+# an HTML fragment, not JSON, so `jq` doesn't apply.
+```
+
+Fetching a message body *may* mark it read on some district configs
+(unconfirmed either way).
+
+## Fees (two endpoints in parallel; either can 404 independently)
+
+```sh
+ic_get "/campus/api/portal/fees/feeAssignments?personID=$PID" | jq .
+ic_get "/campus/api/portal/fees/feeTransactionDetail/totalSurplus/-1?personID=$PID" | jq .
+```
+
+Both 404 → module is off for this district. One 404 → report the other
+side plus a note that the failing endpoint may be disabled.
+
+## Feature flags (displayOptions — check before assuming a 404 is a bug)
+
+```sh
+ic_get "/campus/api/portal/displayOptions/$STRUCTURE_ID?personID=$PID" \
+  | jq '{attendance, behavior, assessment, documents, foodService, grades, schedule}'
+```
+
+`false` = district has that module turned off for this enrollment; `true`
+or absent = available. ~90 flags total; the MCP caches this per
+`(district, structureID)` for the session lifetime since it rarely changes
+mid-session — worth doing the same if you're calling it more than once.
+
+---
+
+## Not covered here (out of scope for this skill)
+
+- **CUPS linked-district discovery/switching** — a parent with kids at 2+
+  IC-hosted districts under shared SSO. Multi-step: fetch
+  `cups/linkedAccounts`, `userAccountSwitch/originalDistrict`,
+  `districts/current`, then per linked account a `cups/loginToken` POST
+  followed by a second `verify.jsp`-style POST at the *linked* district's
+  own host with the CUPS token. Fully discoverable in `src/client.ts`
+  (`discoverLinkedDistricts`) but a lot of shell for a one-shot skill —
+  just re-run the Login block against the linked district's own
+  `IC_BASE_URL`/`IC_DISTRICT` instead.