infinitecampus-mcp 0.1.1 → 0.1.2

package/README.md

@@ -15,9 +15,9 @@ MCP server for Infinite Campus (Campus Parent portal). Single-account config —
 | Behavior | `ic_list_behavior` |
 | Food service | `ic_list_food_service` |
 | Documents | `ic_list_documents`, `ic_download_document` |
-| Messages | `ic_list_messages`, `ic_get_message`, `ic_list_message_recipients`, `ic_send_message` |
+| Notifications | `ic_list_messages` (prism notifications), `ic_get_message` (unread count) |
 
-Tools that the harness will gate as write/IO operations: `ic_send_message`, `ic_download_document`.
+Tools that the harness will gate as write/IO operations: `ic_download_document`.
 
 ## Configuration
 

package/dist/bundle.js

@@ -30155,8 +30155,13 @@ var ICClient = class {
   sessions = /* @__PURE__ */ new Map();
   linkedTo = /* @__PURE__ */ new Map();
   // linkedDistrictName → primaryDistrictName
+  primaryName;
   constructor(account2) {
     this.accounts.set(account2.name, account2);
+    this.primaryName = account2.name;
+  }
+  async ensureDiscovery() {
+    await this.ensureSession(this.accounts.get(this.primaryName));
   }
   listDistricts() {
     return [...this.accounts.values()].map((a) => ({
@@ -30454,6 +30459,7 @@ function registerDistrictTools(server2, client2) {
     description: "List Infinite Campus districts configured for this MCP server. Returns names + base URLs (no credentials).",
     annotations: { readOnlyHint: true }
   }, async () => {
+    await client2.ensureDiscovery();
     const data = client2.listDistricts();
     return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
   });
@@ -30687,24 +30693,40 @@ var downloadArgs = external_exports3.object({
 });
 function registerDocumentTools(server2, client2) {
   server2.registerTool("ic_list_documents", {
-    description: "List a student's available documents (report cards, transcripts, etc.). Returns metadata only \u2014 use ic_download_document to fetch the file.",
+    description: "List a student's available documents (report cards, transcripts, etc.). Returns metadata only \u2014 use ic_download_document to fetch the file. Returns FeatureDisabled if the district has the module turned off.",
     annotations: { readOnlyHint: true },
     inputSchema: listArgs2.shape
   }, async (rawArgs) => {
     const args = listArgs2.parse(rawArgs);
-    const data = await client2.request(args.district, `/campus/resources/portal/documents?personID=${encodeURIComponent(args.studentId)}`);
-    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    try {
+      const data = await client2.request(args.district, `/campus/resources/portal/documents?personID=${encodeURIComponent(args.studentId)}`);
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    } catch (e) {
+      if (e instanceof Error && e.message.startsWith("IC 404 ")) {
+        const warn = { warning: "FeatureDisabled", feature: "documents", district: args.district, data: [] };
+        return { content: [{ type: "text", text: JSON.stringify(warn, null, 2) }] };
+      }
+      throw e;
+    }
   });
   server2.registerTool("ic_download_document", {
-    description: "Download a student's document (PDF) to disk. documentId is the downloadUrl returned by ic_list_documents.",
+    description: "Download a student's document (PDF) to disk. documentId is the downloadUrl returned by ic_list_documents. Returns FeatureDisabled if the district has the module turned off.",
     annotations: { destructiveHint: true },
     inputSchema: downloadArgs.shape
   }, async (rawArgs) => {
     const args = downloadArgs.parse(rawArgs);
-    const meta3 = await client2.download(args.district, args.documentId, args.destinationPath, {
-      overwrite: args.overwrite ?? false
-    });
-    return { content: [{ type: "text", text: JSON.stringify(meta3, null, 2) }] };
+    try {
+      const meta3 = await client2.download(args.district, args.documentId, args.destinationPath, {
+        overwrite: args.overwrite ?? false
+      });
+      return { content: [{ type: "text", text: JSON.stringify(meta3, null, 2) }] };
+    } catch (e) {
+      if (e instanceof Error && e.message.startsWith("IC download 404")) {
+        const warn = { warning: "FeatureDisabled", feature: "documents", district: args.district };
+        return { content: [{ type: "text", text: JSON.stringify(warn, null, 2) }] };
+      }
+      throw e;
+    }
   });
 }
 
@@ -30717,7 +30739,7 @@ try {
 }
 var account = loadAccount();
 var client = new ICClient(account);
-var server = new McpServer({ name: "infinitecampus", version: "0.1.1" });
+var server = new McpServer({ name: "infinitecampus", version: "0.1.2" });
 registerDistrictTools(server, client);
 registerStudentTools(server, client);
 registerScheduleTools(server, client);

package/dist/client.js

@@ -5,8 +5,14 @@ export class ICClient {
     accounts = new Map();
     sessions = new Map();
     linkedTo = new Map(); // linkedDistrictName → primaryDistrictName
+    primaryName;
     constructor(account) {
         this.accounts.set(account.name, account);
+        this.primaryName = account.name;
+    }
+    async ensureDiscovery() {
+        // Ensure primary account is logged in, which triggers CUPS linked-district discovery
+        await this.ensureSession(this.accounts.get(this.primaryName));
     }
     listDistricts() {
         return [...this.accounts.values()].map((a) => ({

package/dist/index.js

@@ -27,7 +27,7 @@ import { registerMessageTools } from './tools/messages.js';
 import { registerDocumentTools } from './tools/documents.js';
 const account = loadAccount();
 const client = new ICClient(account);
-const server = new McpServer({ name: 'infinitecampus', version: '0.1.1' });
+const server = new McpServer({ name: 'infinitecampus', version: '0.1.2' });
 registerDistrictTools(server, client);
 registerStudentTools(server, client);
 registerScheduleTools(server, client);

package/dist/tools/districts.js

@@ -3,6 +3,7 @@ export function registerDistrictTools(server, client) {
         description: 'List Infinite Campus districts configured for this MCP server. Returns names + base URLs (no credentials).',
         annotations: { readOnlyHint: true },
     }, async () => {
+        await client.ensureDiscovery();
         const data = client.listDistricts();
         return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
     });

package/dist/tools/documents.js

@@ -11,23 +11,41 @@ const downloadArgs = z.object({
 });
 export function registerDocumentTools(server, client) {
     server.registerTool('ic_list_documents', {
-        description: "List a student's available documents (report cards, transcripts, etc.). Returns metadata only — use ic_download_document to fetch the file.",
+        description: "List a student's available documents (report cards, transcripts, etc.). Returns metadata only — use ic_download_document to fetch the file. Returns FeatureDisabled if the district has the module turned off.",
         annotations: { readOnlyHint: true },
         inputSchema: listArgs.shape,
     }, async (rawArgs) => {
         const args = listArgs.parse(rawArgs);
-        const data = await client.request(args.district, `/campus/resources/portal/documents?personID=${encodeURIComponent(args.studentId)}`);
-        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        try {
+            const data = await client.request(args.district, `/campus/resources/portal/documents?personID=${encodeURIComponent(args.studentId)}`);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof Error && e.message.startsWith('IC 404 ')) {
+                const warn = { warning: 'FeatureDisabled', feature: 'documents', district: args.district, data: [] };
+                return { content: [{ type: 'text', text: JSON.stringify(warn, null, 2) }] };
+            }
+            throw e;
+        }
     });
     server.registerTool('ic_download_document', {
-        description: "Download a student's document (PDF) to disk. documentId is the downloadUrl returned by ic_list_documents.",
+        description: "Download a student's document (PDF) to disk. documentId is the downloadUrl returned by ic_list_documents. Returns FeatureDisabled if the district has the module turned off.",
         annotations: { destructiveHint: true },
         inputSchema: downloadArgs.shape,
     }, async (rawArgs) => {
         const args = downloadArgs.parse(rawArgs);
-        const meta = await client.download(args.district, args.documentId, args.destinationPath, {
-            overwrite: args.overwrite ?? false,
-        });
-        return { content: [{ type: 'text', text: JSON.stringify(meta, null, 2) }] };
+        try {
+            const meta = await client.download(args.district, args.documentId, args.destinationPath, {
+                overwrite: args.overwrite ?? false,
+            });
+            return { content: [{ type: 'text', text: JSON.stringify(meta, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof Error && e.message.startsWith('IC download 404')) {
+                const warn = { warning: 'FeatureDisabled', feature: 'documents', district: args.district };
+                return { content: [{ type: 'text', text: JSON.stringify(warn, null, 2) }] };
+            }
+            throw e;
+        }
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infinitecampus-mcp",
-  "version": "0.1.1",
+  "version": "0.1.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

@@ -114,16 +114,14 @@ Every tool except `ic_list_districts` takes `district` as its first arg (the dis
 ### Documents
 | Tool | Notes |
 |------|-------|
-| `ic_list_documents(district, studentId)` | Metadata only (report cards, transcripts, etc.). |
-| `ic_download_document(district, studentId, documentId, destinationPath)` | Writes the PDF to `destinationPath` on disk. **`destinationPath` is required** — confirm the path with the user before calling. |
+| `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. |
 
-### Messages
+### Notifications
 | Tool | Notes |
 |------|-------|
-| `ic_list_messages(district, folder?, page?, size?)` | `folder` is `inbox` or `sent`. Paginated. |
-| `ic_get_message(district, messageId)` | Full message body. |
-| `ic_list_message_recipients(district)` | Valid recipient IDs (teachers, staff) for this district. Call before `ic_send_message` to validate recipients. |
-| `ic_send_message(district, subject, body, recipientIds[])` | **Sends a real message through the portal.** Recipients must come from `ic_list_message_recipients` — made-up IDs will fail. |
+| `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. |
 
 ## Workflows
 
@@ -139,11 +137,6 @@ Every tool except `ic_list_districts` takes `district` as its first arg (the dis
 **Today's schedule:**
 - `ic_get_schedule(district, studentId)` — returns today's classes by default
 
-**Email a teacher:**
-1. `ic_list_message_recipients(district)` → find the teacher's recipient ID
-2. Draft subject/body with the user and confirm
-3. `ic_send_message(district, subject, body, [teacherRecipientId])`
-
 **Get the report card:**
 1. `ic_list_documents(district, studentId)` → find the report card's `documentId`
 2. Confirm destination path with the user
@@ -151,6 +144,5 @@ Every tool except `ic_list_districts` takes `district` as its first arg (the dis
 
 ## Caution
 
-- `ic_send_message` actually sends a portal message to teachers/staff — always confirm subject, body, and recipients with the user before calling.
 - `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` or `ic_list_food_service` returns a `FeatureDisabled` warning, that module is simply turned off for the district — it's not an error.
+- 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.