infinitecampus-mcp 2.0.0 → 2.0.2

package/README.md

@@ -4,18 +4,25 @@ MCP server for Infinite Campus (Campus Parent portal). Single-account config —
 
 ## Tools
 
+19 tools across academics, daily life, documents, messaging, and feature discovery.
+
 | Domain | Tools |
 |---|---|
 | Districts | `ic_list_districts` |
 | Students | `ic_list_students` |
 | Schedule | `ic_get_schedule` |
-| Assignments | `ic_list_assignments` (with `missingOnly` filter) |
-| Grades | `ic_list_grades` |
-| Attendance | `ic_list_attendance` |
-| Behavior | `ic_list_behavior` |
-| Food service | `ic_list_food_service` |
+| Assignments | `ic_list_assignments` (sectionID server-side; `missingOnly` / date filters client-side) |
+| Grades | `ic_list_grades`, `ic_list_recent_grades` (default 14d window) |
+| School calendar | `ic_list_school_days` |
+| Attendance | `ic_list_attendance` (per-course summary), `ic_list_attendance_events` (individual events with codes + comments) |
+| Behavior | `ic_list_behavior` (FeatureDisabled-aware) |
+| Food service | `ic_list_food_service` (FeatureDisabled-aware) |
 | Documents | `ic_list_documents`, `ic_download_document` |
-| Notifications | `ic_list_messages` (prism notifications), `ic_get_message` (unread count) |
+| Messaging | `ic_list_messages` (3 sources: prism notifications + Messenger 2.0 inbox + portal announcements), `ic_get_message` (fetch parsed HTML body of an inbox message) |
+| Teachers | `ic_list_teachers` (teachers per section + assigned counselors) |
+| Assessments | `ic_list_assessments` (standardized test scores) |
+| Fees | `ic_list_fees` (assignments + surplus balance) |
+| Features | `ic_get_features` (per-enrollment displayOptions flags) |
 
 Tools that the harness will gate as write/IO operations: `ic_download_document`.
 
@@ -31,10 +38,10 @@ IC_PASSWORD=...
 IC_NAME=Myers Park           # optional, defaults to IC_DISTRICT
 ```
 
-Linked districts (via CUPS SSO) are auto-discovered after login — no extra config needed. If you have truly separate IC instances with different credentials, run two MCP instances.
+Linked districts (via CUPS SSO) are auto-discovered after primary login — a parent with kids in two districts only configures the primary. No extra config needed. If you have truly separate IC instances with different credentials, run two MCP instances.
 
 See `.env.example`.
 
 ## Status
 
-This project was developed and is maintained by AI (Claude). Use at your own discretion. Unofficial — not affiliated with Infinite Campus.
+Unofficial — not affiliated with Infinite Campus. AI-maintained.

package/dist/bundle.js

@@ -29746,11 +29746,11 @@ var McpServer = class {
     }
     return registeredResourceTemplate;
   }
-  _createRegisteredPrompt(name, title, description, argsSchema14, callback) {
+  _createRegisteredPrompt(name, title, description, argsSchema15, callback) {
     const registeredPrompt = {
       title,
       description,
-      argsSchema: argsSchema14 === void 0 ? void 0 : objectFromShape(argsSchema14),
+      argsSchema: argsSchema15 === void 0 ? void 0 : objectFromShape(argsSchema15),
       callback,
       enabled: true,
       disable: () => registeredPrompt.update({ enabled: false }),
@@ -29776,8 +29776,8 @@ var McpServer = class {
       }
     };
     this._registeredPrompts[name] = registeredPrompt;
-    if (argsSchema14) {
-      const hasCompletable = Object.values(argsSchema14).some((field) => {
+    if (argsSchema15) {
+      const hasCompletable = Object.values(argsSchema15).some((field) => {
         const inner = field instanceof ZodOptional2 ? field._def?.innerType : field;
         return isCompletable(inner);
       });
@@ -29884,12 +29884,12 @@ var McpServer = class {
     if (typeof rest[0] === "string") {
       description = rest.shift();
     }
-    let argsSchema14;
+    let argsSchema15;
     if (rest.length > 1) {
-      argsSchema14 = rest.shift();
+      argsSchema15 = rest.shift();
     }
     const cb = rest[0];
-    const registeredPrompt = this._createRegisteredPrompt(name, void 0, description, argsSchema14, cb);
+    const registeredPrompt = this._createRegisteredPrompt(name, void 0, description, argsSchema15, cb);
     this.setPromptRequestHandlers();
     this.sendPromptListChanged();
     return registeredPrompt;
@@ -29901,8 +29901,8 @@ var McpServer = class {
     if (this._registeredPrompts[name]) {
       throw new Error(`Prompt ${name} is already registered`);
     }
-    const { title, description, argsSchema: argsSchema14 } = config2;
-    const registeredPrompt = this._createRegisteredPrompt(name, title, description, argsSchema14, cb);
+    const { title, description, argsSchema: argsSchema15 } = config2;
+    const registeredPrompt = this._createRegisteredPrompt(name, title, description, argsSchema15, cb);
     this.setPromptRequestHandlers();
     this.sendPromptListChanged();
     return registeredPrompt;
@@ -30156,6 +30156,7 @@ var ICClient = class {
   linkedTo = /* @__PURE__ */ new Map();
   // linkedDistrictName → primaryDistrictName
   primaryName;
+  featuresCache = /* @__PURE__ */ new Map();
   constructor(account2) {
     this.accounts.set(account2.name, account2);
     this.primaryName = account2.name;
@@ -30170,6 +30171,22 @@ var ICClient = class {
       linked: this.linkedTo.has(a.name)
     }));
   }
+  /**
+   * Fetch the per-structure displayOptions feature-flag allowlist for a student.
+   * Results are cached per (district, structureID) for the duration of the
+   * session TTL — flags rarely change mid-session and the call costs ~1 RT.
+   */
+  async getFeatures(district, structureID, studentId) {
+    const key = `${district}:${structureID}`;
+    const cached2 = this.featuresCache.get(key);
+    if (cached2 && Date.now() - cached2.fetchedAt < SESSION_TTL_MS) return cached2.data;
+    const data = await this.request(
+      district,
+      `/campus/api/portal/displayOptions/${structureID}?personID=${encodeURIComponent(studentId)}`
+    );
+    this.featuresCache.set(key, { data, fetchedAt: Date.now() });
+    return data;
+  }
   async request(district, path, opts = {}) {
     const account2 = this.accounts.get(district);
     if (!account2) throw new UnknownDistrictError(district, [...this.accounts.keys()]);
@@ -30475,6 +30492,18 @@ async function findStudent(client2, district, studentId) {
 function studentNotFound(studentId) {
   return textContent({ error: "StudentNotFound", studentId });
 }
+async function checkFeatureDisabled(client2, district, studentId, student, flag, toolName, emptyData = []) {
+  const structureID = student.enrollments?.[0]?.structureID;
+  if (!structureID) return null;
+  try {
+    const features = await client2.getFeatures(district, structureID, studentId);
+    if (features[flag] === false) return featureDisabled(toolName, district, emptyData);
+    return null;
+  } catch (e) {
+    console.error(`[ic] displayOptions check failed for ${district}/${flag}: ${e instanceof Error ? e.message : e}`);
+    return null;
+  }
+}
 function toArray(value) {
   if (value === null || value === void 0) return [];
   return Array.isArray(value) ? value : [value];
@@ -30625,6 +30654,8 @@ function registerAttendanceTools(server2, client2) {
     const args = argsSchema5.parse(rawArgs);
     const student = await findStudent(client2, args.district, args.studentId);
     if (!student) return studentNotFound(args.studentId);
+    const disabled = await checkFeatureDisabled(client2, args.district, args.studentId, student, "attendance", "attendance");
+    if (disabled) return disabled;
     const enrollments = student.enrollments ?? [];
     const results = [];
     try {
@@ -30665,11 +30696,15 @@ var argsSchema6 = external_exports3.object({
 });
 function registerBehaviorTools(server2, client2) {
   server2.registerTool("ic_list_behavior", {
-    description: "List a student's behavior events / referrals. Returns FeatureDisabled if the district has the behavior module turned off.",
+    description: "List a student's behavior events / referrals. Returns FeatureDisabled if the district has the behavior module turned off (detected via displayOptions or a 404 backstop).",
     annotations: { readOnlyHint: true },
     inputSchema: argsSchema6.shape
   }, async (rawArgs) => {
     const args = argsSchema6.parse(rawArgs);
+    const student = await findStudent(client2, args.district, args.studentId);
+    if (!student) return studentNotFound(args.studentId);
+    const disabled = await checkFeatureDisabled(client2, args.district, args.studentId, student, "behavior", "behavior");
+    if (disabled) return disabled;
     const params = new URLSearchParams({ personID: args.studentId });
     if (args.since) params.set("startDate", args.since);
     if (args.until) params.set("endDate", args.until);
@@ -30690,13 +30725,26 @@ var argsSchema7 = external_exports3.object({
   since: external_exports3.string().optional(),
   until: external_exports3.string().optional()
 });
+var EMPTY_FOOD = { balance: null, transactions: [] };
 function registerFoodServiceTools(server2, client2) {
   server2.registerTool("ic_list_food_service", {
-    description: "List a student's lunch balance and recent food-service transactions. Returns FeatureDisabled if the district has the module turned off.",
+    description: "List a student's lunch balance and recent food-service transactions. Returns FeatureDisabled if the district has the module turned off (detected via displayOptions or a 404 backstop).",
     annotations: { readOnlyHint: true },
     inputSchema: argsSchema7.shape
   }, async (rawArgs) => {
     const args = argsSchema7.parse(rawArgs);
+    const student = await findStudent(client2, args.district, args.studentId);
+    if (!student) return studentNotFound(args.studentId);
+    const disabled = await checkFeatureDisabled(
+      client2,
+      args.district,
+      args.studentId,
+      student,
+      "foodService",
+      "foodService",
+      EMPTY_FOOD
+    );
+    if (disabled) return disabled;
     const params = new URLSearchParams({ personID: args.studentId });
     if (args.since) params.set("startDate", args.since);
     if (args.until) params.set("endDate", args.until);
@@ -30704,7 +30752,7 @@ function registerFoodServiceTools(server2, client2) {
       const data = await client2.request(args.district, `/campus/resources/portal/foodService?${params}`);
       return textContent(data);
     } catch (e) {
-      if (is404(e)) return featureDisabled("foodService", args.district, { balance: null, transactions: [] });
+      if (is404(e)) return featureDisabled("foodService", args.district, EMPTY_FOOD);
       throw e;
     }
   });
@@ -30839,6 +30887,10 @@ function registerDocumentTools(server2, client2) {
     inputSchema: listArgs2.shape
   }, async (rawArgs) => {
     const args = listArgs2.parse(rawArgs);
+    const student = await findStudent(client2, args.district, args.studentId);
+    if (!student) return studentNotFound(args.studentId);
+    const disabled = await checkFeatureDisabled(client2, args.district, args.studentId, student, "documents", "documents");
+    if (disabled) return disabled;
     try {
       const raw = await client2.request(
         args.district,
@@ -30991,6 +31043,8 @@ function registerAttendanceEventsTools(server2, client2) {
     const args = argsSchema9.parse(rawArgs);
     const student = await findStudent(client2, args.district, args.studentId);
     if (!student) return studentNotFound(args.studentId);
+    const disabled = await checkFeatureDisabled(client2, args.district, args.studentId, student, "attendance", "attendance_events");
+    if (disabled) return disabled;
     const enrollments = student.enrollments ?? [];
     const results = [];
     try {
@@ -31089,6 +31143,7 @@ var DROP_KEYS = /* @__PURE__ */ new Set([
   "mTime",
   "action",
   "personID",
+  "studentPersonID",
   "isKentucky",
   "pairID",
   "pairedEvent"
@@ -31145,6 +31200,8 @@ function registerAssessmentTools(server2, client2) {
     const args = argsSchema12.parse(rawArgs);
     const student = await findStudent(client2, args.district, args.studentId);
     if (!student) return studentNotFound(args.studentId);
+    const disabled = await checkFeatureDisabled(client2, args.district, args.studentId, student, "assessment", "assessments");
+    if (disabled) return disabled;
     const personIDEnc = encodeURIComponent(args.studentId);
     const result = [];
     let feature404 = false;
@@ -31187,7 +31244,7 @@ var argsSchema13 = external_exports3.object({
 });
 function registerFeeTools(server2, client2) {
   server2.registerTool("ic_list_fees", {
-    description: "List a student's fee assignments (charges owed) and running balance/surplus. Combines two endpoints: fee assignments and totalSurplus. Returns FeatureDisabled only if both endpoints 404; if only one works, returns that with a note.",
+    description: "List a student's fee assignments (charges owed) and running balance/surplus. Combines two endpoints: fee assignments and totalSurplus. Returns FeatureDisabled only if both endpoints 404; if only one works, returns that side with warning: 'PartialSuccess' and an issues[] explaining which endpoint failed.",
     annotations: { readOnlyHint: true },
     inputSchema: argsSchema13.shape
   }, async (rawArgs) => {
@@ -31211,18 +31268,47 @@ function registerFeeTools(server2, client2) {
     if (!assignments.ok && !surplus.ok) {
       return featureDisabled("fees", args.district, { totalSurplus: null, feeAssignments: [] });
     }
+    const issues = [];
+    if (!assignments.ok) issues.push("feeAssignments endpoint returned 404 (module may be disabled for this district)");
+    if (!surplus.ok) issues.push("totalSurplus endpoint returned 404 (module may be disabled for this district)");
     const response = {
+      ...issues.length > 0 ? { warning: "PartialSuccess" } : {},
       totalSurplus: surplus.ok ? surplus.value : null,
-      feeAssignments: assignments.ok ? assignments.value : []
+      feeAssignments: assignments.ok ? assignments.value : [],
+      ...issues.length > 0 ? { issues } : {}
     };
-    const notes = [];
-    if (!assignments.ok) notes.push("feeAssignments endpoint returned 404 (module may be disabled for this district)");
-    if (!surplus.ok) notes.push("totalSurplus endpoint returned 404 (module may be disabled for this district)");
-    if (notes.length > 0) response.notes = notes;
     return textContent(response);
   });
 }
 
+// src/tools/features.ts
+var argsSchema14 = external_exports3.object({
+  district: external_exports3.string(),
+  studentId: external_exports3.string().describe("Student personID from ic_list_students")
+});
+function registerFeaturesTools(server2, client2) {
+  server2.registerTool("ic_get_features", {
+    description: "List the district's displayOptions feature-flag allow-list for each of a student's enrollments. Each enrollment's `features` object is a map of ~90 flag names (attendance, behavior, assessment, documents, grades, schedule, etc.) to booleans. A `false` value means the district has that feature disabled for this enrollment; `true` or missing means it's available. Used internally by other tools to short-circuit disabled features, but exposed here so the LLM can answer capability questions directly.",
+    annotations: { readOnlyHint: true },
+    inputSchema: argsSchema14.shape
+  }, async (rawArgs) => {
+    const args = argsSchema14.parse(rawArgs);
+    const student = await findStudent(client2, args.district, args.studentId);
+    if (!student) return studentNotFound(args.studentId);
+    const result = [];
+    for (const enr of student.enrollments ?? []) {
+      const features = await client2.getFeatures(args.district, enr.structureID, args.studentId);
+      result.push({
+        enrollmentID: enr.enrollmentID,
+        structureID: enr.structureID,
+        schoolName: enr.schoolName,
+        features
+      });
+    }
+    return textContent(result);
+  });
+}
+
 // src/index.ts
 try {
   const { config: config2 } = await import("dotenv");
@@ -31232,7 +31318,7 @@ try {
 }
 var account = loadAccount();
 var client = new ICClient(account);
-var server = new McpServer({ name: "infinitecampus", version: "2.0.0" });
+var server = new McpServer({ name: "infinitecampus", version: "2.0.2" });
 registerDistrictTools(server, client);
 registerStudentTools(server, client);
 registerScheduleTools(server, client);
@@ -31249,6 +31335,7 @@ registerRecentGradesTools(server, client);
 registerTeacherTools(server, client);
 registerAssessmentTools(server, client);
 registerFeeTools(server, client);
+registerFeaturesTools(server, client);
 console.error(`[infinitecampus-mcp] District: ${account.name} (${account.baseUrl})`);
 console.error("[infinitecampus-mcp] Developed and maintained by AI (Claude). Use at your own discretion.");
 var transport = new StdioServerTransport();

package/dist/client.js

@@ -6,6 +6,7 @@ export class ICClient {
     sessions = new Map();
     linkedTo = new Map(); // linkedDistrictName → primaryDistrictName
     primaryName;
+    featuresCache = new Map();
     constructor(account) {
         this.accounts.set(account.name, account);
         this.primaryName = account.name;
@@ -21,6 +22,20 @@ export class ICClient {
             linked: this.linkedTo.has(a.name),
         }));
     }
+    /**
+     * Fetch the per-structure displayOptions feature-flag allowlist for a student.
+     * Results are cached per (district, structureID) for the duration of the
+     * session TTL — flags rarely change mid-session and the call costs ~1 RT.
+     */
+    async getFeatures(district, structureID, studentId) {
+        const key = `${district}:${structureID}`;
+        const cached = this.featuresCache.get(key);
+        if (cached && Date.now() - cached.fetchedAt < SESSION_TTL_MS)
+            return cached.data;
+        const data = await this.request(district, `/campus/api/portal/displayOptions/${structureID}?personID=${encodeURIComponent(studentId)}`);
+        this.featuresCache.set(key, { data, fetchedAt: Date.now() });
+        return data;
+    }
     async request(district, path, opts = {}) {
         const account = this.accounts.get(district);
         if (!account)

package/dist/index.js

@@ -31,9 +31,10 @@ import { registerRecentGradesTools } from './tools/recent_grades.js';
 import { registerTeacherTools } from './tools/teachers.js';
 import { registerAssessmentTools } from './tools/assessments.js';
 import { registerFeeTools } from './tools/fees.js';
+import { registerFeaturesTools } from './tools/features.js';
 const account = loadAccount();
 const client = new ICClient(account);
-const server = new McpServer({ name: 'infinitecampus', version: '2.0.0' });
+const server = new McpServer({ name: 'infinitecampus', version: '2.0.2' });
 registerDistrictTools(server, client);
 registerStudentTools(server, client);
 registerScheduleTools(server, client);
@@ -50,6 +51,7 @@ registerRecentGradesTools(server, client);
 registerTeacherTools(server, client);
 registerAssessmentTools(server, client);
 registerFeeTools(server, client);
+registerFeaturesTools(server, client);
 console.error(`[infinitecampus-mcp] District: ${account.name} (${account.baseUrl})`);
 console.error('[infinitecampus-mcp] Developed and maintained by AI (Claude). Use at your own discretion.');
 const transport = new StdioServerTransport();

package/dist/tools/_shared.js

@@ -19,6 +19,31 @@ export async function findStudent(client, district, studentId) {
 export function studentNotFound(studentId) {
     return textContent({ error: 'StudentNotFound', studentId });
 }
+/**
+ * Check a feature flag via the district's displayOptions allow-list for the
+ * student's first enrollment's structureID. Returns a FeatureDisabled content
+ * block when the flag is explicitly `false`. Returns `null` in every other
+ * case (flag is `true`, flag is absent, no enrollments, or the displayOptions
+ * call itself fails) — callers then fall through to hit the real endpoint.
+ *
+ * Non-fatal by design: if the allow-list can't be fetched we don't want to
+ * break the tool, since the 404-catch backstop still protects it.
+ */
+export async function checkFeatureDisabled(client, district, studentId, student, flag, toolName, emptyData = []) {
+    const structureID = student.enrollments?.[0]?.structureID;
+    if (!structureID)
+        return null;
+    try {
+        const features = await client.getFeatures(district, structureID, studentId);
+        if (features[flag] === false)
+            return featureDisabled(toolName, district, emptyData);
+        return null;
+    }
+    catch (e) {
+        console.error(`[ic] displayOptions check failed for ${district}/${flag}: ${e instanceof Error ? e.message : e}`);
+        return null;
+    }
+}
 /**
  * Coerce a value to an array. Defensive against IC's prism XML→JSON
  * serializer which returns a bare object (not a 1-element array) for

package/dist/tools/assessments.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, findStudent, studentNotFound, featureDisabled, is404, toArray } from './_shared.js';
+import { textContent, findStudent, studentNotFound, featureDisabled, is404, toArray, checkFeatureDisabled } from './_shared.js';
 const argsSchema = z.object({
     district: z.string(),
     studentId: z.string().describe('Student personID from ic_list_students'),
@@ -14,6 +14,9 @@ export function registerAssessmentTools(server, client) {
         const student = await findStudent(client, args.district, args.studentId);
         if (!student)
             return studentNotFound(args.studentId);
+        const disabled = await checkFeatureDisabled(client, args.district, args.studentId, student, 'assessment', 'assessments');
+        if (disabled)
+            return disabled;
         const personIDEnc = encodeURIComponent(args.studentId);
         const result = [];
         let feature404 = false;

package/dist/tools/attendance.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, is404, featureDisabled, findStudent, studentNotFound, toArray } from './_shared.js';
+import { textContent, is404, featureDisabled, findStudent, studentNotFound, toArray, checkFeatureDisabled } from './_shared.js';
 const argsSchema = z.object({
     district: z.string(),
     studentId: z.string(),
@@ -47,6 +47,9 @@ export function registerAttendanceTools(server, client) {
         const student = await findStudent(client, args.district, args.studentId);
         if (!student)
             return studentNotFound(args.studentId);
+        const disabled = await checkFeatureDisabled(client, args.district, args.studentId, student, 'attendance', 'attendance');
+        if (disabled)
+            return disabled;
         const enrollments = student.enrollments ?? [];
         const results = [];
         try {

package/dist/tools/attendance_events.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, is404, featureDisabled, findStudent, studentNotFound, toArray } from './_shared.js';
+import { textContent, is404, featureDisabled, findStudent, studentNotFound, toArray, checkFeatureDisabled } from './_shared.js';
 const argsSchema = z.object({
     district: z.string(),
     studentId: z.string().describe('Student personID from ic_list_students'),
@@ -48,6 +48,9 @@ export function registerAttendanceEventsTools(server, client) {
         const student = await findStudent(client, args.district, args.studentId);
         if (!student)
             return studentNotFound(args.studentId);
+        const disabled = await checkFeatureDisabled(client, args.district, args.studentId, student, 'attendance', 'attendance_events');
+        if (disabled)
+            return disabled;
         const enrollments = student.enrollments ?? [];
         const results = [];
         try {

package/dist/tools/behavior.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, is404, featureDisabled } from './_shared.js';
+import { textContent, is404, featureDisabled, findStudent, studentNotFound, checkFeatureDisabled } from './_shared.js';
 const argsSchema = z.object({
     district: z.string(),
     studentId: z.string(),
@@ -8,11 +8,17 @@ const argsSchema = z.object({
 });
 export function registerBehaviorTools(server, client) {
     server.registerTool('ic_list_behavior', {
-        description: "List a student's behavior events / referrals. Returns FeatureDisabled if the district has the behavior module turned off.",
+        description: "List a student's behavior events / referrals. Returns FeatureDisabled if the district has the behavior module turned off (detected via displayOptions or a 404 backstop).",
         annotations: { readOnlyHint: true },
         inputSchema: argsSchema.shape,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);
+        const student = await findStudent(client, args.district, args.studentId);
+        if (!student)
+            return studentNotFound(args.studentId);
+        const disabled = await checkFeatureDisabled(client, args.district, args.studentId, student, 'behavior', 'behavior');
+        if (disabled)
+            return disabled;
         const params = new URLSearchParams({ personID: args.studentId });
         if (args.since)
             params.set('startDate', args.since);

package/dist/tools/documents.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, is404, featureDisabled, toArray } from './_shared.js';
+import { textContent, is404, featureDisabled, toArray, findStudent, studentNotFound, checkFeatureDisabled } from './_shared.js';
 const listArgs = z.object({
     district: z.string(),
     studentId: z.string(),
@@ -17,6 +17,12 @@ export function registerDocumentTools(server, client) {
         inputSchema: listArgs.shape,
     }, async (rawArgs) => {
         const args = listArgs.parse(rawArgs);
+        const student = await findStudent(client, args.district, args.studentId);
+        if (!student)
+            return studentNotFound(args.studentId);
+        const disabled = await checkFeatureDisabled(client, args.district, args.studentId, student, 'documents', 'documents');
+        if (disabled)
+            return disabled;
         try {
             const raw = await client.request(args.district, `/campus/resources/portal/report/all?personID=${encodeURIComponent(args.studentId)}`);
             const trimmed = toArray(raw).map((d) => {

package/dist/tools/features.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { textContent, findStudent, studentNotFound } from './_shared.js';
+const argsSchema = z.object({
+    district: z.string(),
+    studentId: z.string().describe('Student personID from ic_list_students'),
+});
+export function registerFeaturesTools(server, client) {
+    server.registerTool('ic_get_features', {
+        description: "List the district's displayOptions feature-flag allow-list for each of a student's enrollments. Each enrollment's `features` object is a map of ~90 flag names (attendance, behavior, assessment, documents, grades, schedule, etc.) to booleans. A `false` value means the district has that feature disabled for this enrollment; `true` or missing means it's available. Used internally by other tools to short-circuit disabled features, but exposed here so the LLM can answer capability questions directly.",
+        annotations: { readOnlyHint: true },
+        inputSchema: argsSchema.shape,
+    }, async (rawArgs) => {
+        const args = argsSchema.parse(rawArgs);
+        const student = await findStudent(client, args.district, args.studentId);
+        if (!student)
+            return studentNotFound(args.studentId);
+        const result = [];
+        for (const enr of student.enrollments ?? []) {
+            const features = await client.getFeatures(args.district, enr.structureID, args.studentId);
+            result.push({
+                enrollmentID: enr.enrollmentID,
+                structureID: enr.structureID,
+                schoolName: enr.schoolName,
+                features,
+            });
+        }
+        return textContent(result);
+    });
+}

package/dist/tools/fees.js

@@ -6,7 +6,7 @@ const argsSchema = z.object({
 });
 export function registerFeeTools(server, client) {
     server.registerTool('ic_list_fees', {
-        description: "List a student's fee assignments (charges owed) and running balance/surplus. Combines two endpoints: fee assignments and totalSurplus. Returns FeatureDisabled only if both endpoints 404; if only one works, returns that with a note.",
+        description: "List a student's fee assignments (charges owed) and running balance/surplus. Combines two endpoints: fee assignments and totalSurplus. Returns FeatureDisabled only if both endpoints 404; if only one works, returns that side with warning: 'PartialSuccess' and an issues[] explaining which endpoint failed.",
         annotations: { readOnlyHint: true },
         inputSchema: argsSchema.shape,
     }, async (rawArgs) => {
@@ -27,17 +27,17 @@ export function registerFeeTools(server, client) {
         if (!assignments.ok && !surplus.ok) {
             return featureDisabled('fees', args.district, { totalSurplus: null, feeAssignments: [] });
         }
+        const issues = [];
+        if (!assignments.ok)
+            issues.push('feeAssignments endpoint returned 404 (module may be disabled for this district)');
+        if (!surplus.ok)
+            issues.push('totalSurplus endpoint returned 404 (module may be disabled for this district)');
         const response = {
+            ...(issues.length > 0 ? { warning: 'PartialSuccess' } : {}),
             totalSurplus: surplus.ok ? surplus.value : null,
             feeAssignments: assignments.ok ? assignments.value : [],
+            ...(issues.length > 0 ? { issues } : {}),
         };
-        const notes = [];
-        if (!assignments.ok)
-            notes.push('feeAssignments endpoint returned 404 (module may be disabled for this district)');
-        if (!surplus.ok)
-            notes.push('totalSurplus endpoint returned 404 (module may be disabled for this district)');
-        if (notes.length > 0)
-            response.notes = notes;
         return textContent(response);
     });
 }

package/dist/tools/foodservice.js

@@ -1,18 +1,25 @@
 import { z } from 'zod';
-import { textContent, is404, featureDisabled } from './_shared.js';
+import { textContent, is404, featureDisabled, findStudent, studentNotFound, checkFeatureDisabled } from './_shared.js';
 const argsSchema = z.object({
     district: z.string(),
     studentId: z.string(),
     since: z.string().optional(),
     until: z.string().optional(),
 });
+const EMPTY_FOOD = { balance: null, transactions: [] };
 export function registerFoodServiceTools(server, client) {
     server.registerTool('ic_list_food_service', {
-        description: "List a student's lunch balance and recent food-service transactions. Returns FeatureDisabled if the district has the module turned off.",
+        description: "List a student's lunch balance and recent food-service transactions. Returns FeatureDisabled if the district has the module turned off (detected via displayOptions or a 404 backstop).",
         annotations: { readOnlyHint: true },
         inputSchema: argsSchema.shape,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);
+        const student = await findStudent(client, args.district, args.studentId);
+        if (!student)
+            return studentNotFound(args.studentId);
+        const disabled = await checkFeatureDisabled(client, args.district, args.studentId, student, 'foodService', 'foodService', EMPTY_FOOD);
+        if (disabled)
+            return disabled;
         const params = new URLSearchParams({ personID: args.studentId });
         if (args.since)
             params.set('startDate', args.since);
@@ -24,7 +31,7 @@ export function registerFoodServiceTools(server, client) {
         }
         catch (e) {
             if (is404(e))
-                return featureDisabled('foodService', args.district, { balance: null, transactions: [] });
+                return featureDisabled('foodService', args.district, EMPTY_FOOD);
             throw e;
         }
     });

package/dist/tools/teachers.js

@@ -6,7 +6,7 @@ const argsSchema = z.object({
 });
 // Fields we drop from teacher/counselor contact records (internal IDs, model markers)
 const DROP_KEYS = new Set([
-    '_id', '_model', '_hashCode', 'mTime', 'action', 'personID',
+    '_id', '_model', '_hashCode', 'mTime', 'action', 'personID', 'studentPersonID',
     'isKentucky', 'pairID', 'pairedEvent',
 ]);
 function trimRecord(raw) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infinitecampus-mcp",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Infinite Campus (Campus Parent) MCP server — multi-district read + message/document write",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
   "repository": {

package/skills/ic/SKILL.md

@@ -1,17 +1,19 @@
 ---
 name: ic
-description: This skill should be used when the user asks about Infinite Campus (Campus Parent portal) data for their kids. Triggers on phrases like "check IC", "Infinite Campus", "what's my kid's grade", "any missing assignments", "school messages", "report card", "lunch balance", or any request about a student's schedule, grades, attendance, behavior, food service, documents, or portal messages. Linked districts are auto-discovered via CUPS SSO.
+description: This skill should be used when the user asks about Infinite Campus (Campus Parent portal) data for their kids. Triggers on phrases like "check IC", "Infinite Campus", "what's my kid's grade", "any missing assignments", "school messages", "report card", "lunch balance", "recent grades", "assessments", "fees", or any request about a student's schedule, grades, assignments, attendance, behavior, food service, documents, messages, teachers, assessments, or fees. Linked districts are auto-discovered via CUPS SSO.
 ---
 
 # infinitecampus-mcp
 
-MCP server for Infinite Campus (Campus Parent portal) — read student schedules, grades, assignments, attendance, behavior, food service, documents, and portal messages. Linked districts are auto-discovered via CUPS SSO after primary login.
+MCP server for Infinite Campus (Campus Parent portal) — 19 tools covering schedule, grades (current + recently-scored), assignments, attendance (summary + per-event), behavior, food service, documents, messages (3 sources), teachers, assessments, and fees. Linked districts are auto-discovered via CUPS SSO after primary login.
 
 - **Source:** [github.com/chrischall/infinitecampus-mcp](https://github.com/chrischall/infinitecampus-mcp)
 - **npm:** [npmjs.com/package/infinitecampus-mcp](https://www.npmjs.com/package/infinitecampus-mcp)
 
 ## Setup
 
+Single-account config. Set env vars for your primary IC account; linked districts come from CUPS discovery.
+
 ### Option A — Claude Code (direct MCP, no mcporter)
 
 Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
@@ -34,7 +36,7 @@ Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
 }
 ```
 
-Linked districts (via CUPS SSO) are auto-discovered after login — no extra config needed. `IC_NAME` is optional and defaults to `IC_DISTRICT`.
+Only `IC_BASE_URL`, `IC_DISTRICT`, `IC_USERNAME`, `IC_PASSWORD` are required. `IC_NAME` is optional (defaults to `IC_DISTRICT`). Linked districts (via CUPS SSO) are auto-discovered after login — a parent with kids in two districts only configures the primary.
 
 ### Option B — mcporter
 
@@ -100,28 +102,39 @@ Every tool except `ic_list_districts` takes `district` as its first arg (the dis
 ### Academics
 | Tool | Notes |
 |------|-------|
-| `ic_get_schedule(district, studentId)` | Today's class schedule by default. |
-| `ic_list_assignments(district, studentId, courseId?, since?, until?, missingOnly?)` | Pass `missingOnly=true` to see only missing/late work across all courses. |
-| `ic_list_grades(district, studentId, termId?)` | Grades summary. Omit `termId` for all terms. |
+| `ic_get_schedule(district, studentId)` | Today's class schedule by default, with section placements. |
+| `ic_list_assignments(district, studentId, courseId?, since?, until?, missingOnly?)` | `sectionID` is the only server-side filter; `since`/`until`/`missingOnly` are applied client-side. Pass `missingOnly=true` to see only missing/late work across all courses. |
+| `ic_list_grades(district, studentId, termId?)` | Term + in-progress grade summary. Omit `termId` for all terms. |
+| `ic_list_recent_grades(district, studentId, since?)` | Recently-scored assignments. Defaults to a 14-day window; pass `since` (YYYY-MM-DD) to widen. |
+| `ic_list_assessments(district, studentId)` | Standardized test scores (state/national/district tests). FeatureDisabled-aware. |
+| `ic_list_teachers(district, studentId)` | Teachers per enrolled section + assigned counselor(s). |
 
 ### Daily life
 | Tool | Notes |
 |------|-------|
-| `ic_list_attendance(district, studentId, since?, until?)` | Absences/tardies with dates. |
+| `ic_list_school_days(district, studentId)` | Instructional calendar with term boundaries. |
+| `ic_list_attendance(district, studentId, since?, until?)` | Per-course attendance summary grouped by term. |
+| `ic_list_attendance_events(district, studentId, since?, until?, excusedOnly?)` | Individual absence/tardy events with codes and human comments. |
 | `ic_list_behavior(district, studentId, since?, until?)` | Returns a `FeatureDisabled` warning if the district has no behavior module enabled — this is not an error. |
 | `ic_list_food_service(district, studentId, since?, until?)` | Lunch balance and transactions. Same `FeatureDisabled` fallback as behavior. |
+| `ic_list_fees(district, studentId)` | Fee assignments + surplus/balance. Returns `PartialSuccess` if only one endpoint works, `FeatureDisabled` if both 404. |
 
 ### Documents
 | Tool | Notes |
 |------|-------|
-| `ic_list_documents(district, studentId)` | Metadata only (report cards, transcripts, etc.). Returns `FeatureDisabled` if the district has the documents module turned off. |
-| `ic_download_document(district, documentId, destinationPath)` | Writes the PDF to `destinationPath` on disk. **`destinationPath` is required** — confirm the path with the user before calling. Returns `FeatureDisabled` if unavailable. |
+| `ic_list_documents(district, studentId)` | Metadata only (report cards, schedules, transcripts). Each item has a `url` to pass to `ic_download_document`. Returns `FeatureDisabled` if the documents module is off. |
+| `ic_download_document(district, url, destinationPath)` | Writes the document to `destinationPath` on disk. **`destinationPath` is required** — confirm the path with the user before calling. |
+
+### Messaging
+| Tool | Notes |
+|------|-------|
+| `ic_list_messages(district, limit?)` | Combines three sources: **prism notifications** (grade/attendance/assignment alerts), **Messenger 2.0 inbox** (teacher messages, priority announcements like closures), and **portal userNotice** (district banners). `limit` caps prism only. Per-source `error` field if one fails. |
+| `ic_get_message(district, url)` | Fetches and parses the HTML body of an inbox message. Returns `{ subject, date, body, url }`. |
 
-### Notifications
+### Features
 | Tool | Notes |
 |------|-------|
-| `ic_list_messages(district, limit?)` | Portal notifications (district announcements, teacher messages, system alerts) via prism notification system. |
-| `ic_get_message(district)` | Unread notification/message count. |
+| `ic_get_features(district, studentId)` | Raw per-enrollment `displayOptions` flags (attendance/behavior/assessment/documents/…). Useful for diagnosing why another tool returned `FeatureDisabled`. |
 
 ## Workflows
 
@@ -129,20 +142,34 @@ Every tool except `ic_list_districts` takes `district` as its first arg (the dis
 1. `ic_list_districts` → see configured + linked districts
 2. For each district: `ic_list_students(district)` → collect kids and personIDs
 
-**Are my kids OK?**
-1. `ic_list_assignments(district, studentId, missingOnly=true)` for each kid
-2. `ic_list_grades(district, studentId)` for a current snapshot
-3. `ic_list_attendance(district, studentId, since=<recent>)` for recent absences
+**Is everything OK at school?**
+1. `ic_list_districts`
+2. For each student:
+   - `ic_list_recent_grades(district, studentId)` — last 14 days of scored work
+   - `ic_list_attendance_events(district, studentId, excusedOnly=false)` — recent absences/tardies
+   - `ic_list_messages(district)` — any alerts from teachers or the district
+
+**What got graded this week?**
+- `ic_list_recent_grades(district, studentId, since="YYYY-MM-DD")`
+
+**Check upcoming or missing assignments:**
+- `ic_list_assignments(district, studentId, missingOnly=true)` — only the late/missing set
+- Or `ic_list_assignments(district, studentId, since=..., until=...)` for a date window
 
 **Today's schedule:**
 - `ic_get_schedule(district, studentId)` — returns today's classes by default
 
-**Get the report card:**
-1. `ic_list_documents(district, studentId)` → find the report card's `documentId`
+**Weather closure or priority announcement?**
+- `ic_list_messages(district)` — scan the Messenger 2.0 inbox entries for priority subjects
+- `ic_get_message(district, url)` to read a specific one
+
+**Download a report card:**
+1. `ic_list_documents(district, studentId)` → find the report card's `url`
 2. Confirm destination path with the user
-3. `ic_download_document(district, studentId, documentId, destinationPath="/Users/.../report-card.pdf")`
+3. `ic_download_document(district, url, destinationPath="/Users/.../report-card.pdf")`
 
 ## Caution
 
-- `ic_download_document` writes a PDF to disk at `destinationPath` — confirm the path with the user; overwrites silently.
-- Endpoint behavior varies by district. If `ic_list_behavior`, `ic_list_food_service`, `ic_list_documents`, or `ic_download_document` returns a `FeatureDisabled` warning, that module is simply turned off for the district — it's not an error.
+- `ic_download_document` writes to disk at `destinationPath` — confirm the path with the user; overwrites silently.
+- `ic_list_messages` / `ic_get_message` are nominally read-only, but on some district configurations fetching an inbox message or enumerating the list may mark entries as read. Behavior was not confirmable against an empty test inbox.
+- Endpoint behavior varies by district. If `ic_list_behavior`, `ic_list_food_service`, `ic_list_documents`, `ic_list_assessments`, or `ic_list_fees` returns a `FeatureDisabled` warning, that module is simply turned off for the district — it's not an error. `ic_list_fees` may also return `PartialSuccess` when only one of its two sub-endpoints works.