infinitecampus-mcp 2.0.2 → 2.1.1

package/.claude-plugin/marketplace.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "infinitecampus-mcp",
+  "owner": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "metadata": {
+    "description": "MCP server for Infinite Campus (Campus Parent) — grades, attendance, assignments, messages, documents",
+    "version": "2.1.1"
+  },
+  "plugins": [
+    {
+      "name": "infinitecampus-mcp",
+      "displayName": "Infinite Campus",
+      "source": "./",
+      "description": "Infinite Campus (Campus Parent) MCP server for Claude — grades, attendance, assignments, messages, and documents via natural language",
+      "version": "2.1.1",
+      "author": {
+        "name": "Chris Hall"
+      },
+      "homepage": "https://github.com/chrischall/infinitecampus-mcp",
+      "repository": "https://github.com/chrischall/infinitecampus-mcp",
+      "license": "MIT",
+      "keywords": [
+        "infinite-campus",
+        "campus-parent",
+        "school",
+        "education",
+        "k12",
+        "mcp"
+      ],
+      "category": "productivity"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,11 +1,23 @@
 {
   "name": "infinitecampus-mcp",
-  "version": "0.1.0",
-  "description": "Infinite Campus Campus Parent MCP server (multi-district)",
-  "mcp_servers": {
-    "infinitecampus": {
-      "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/bundle.js"]
-    }
-  }
+  "displayName": "Infinite Campus",
+  "version": "2.1.1",
+  "description": "Infinite Campus (Campus Parent) MCP server for Claude — grades, attendance, assignments, messages, and documents",
+  "author": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "homepage": "https://github.com/chrischall/infinitecampus-mcp",
+  "repository": "https://github.com/chrischall/infinitecampus-mcp",
+  "license": "MIT",
+  "keywords": [
+    "infinite-campus",
+    "campus-parent",
+    "school",
+    "education",
+    "k12",
+    "mcp"
+  ],
+  "skills": "./SKILL.md",
+  "mcp": "./.mcp.json"
 }

package/.mcp.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "infinitecampus": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/bundle.js"],
+      "env": {
+        "IC_BASE_URL": "${IC_BASE_URL}",
+        "IC_DISTRICT": "${IC_DISTRICT}",
+        "IC_USERNAME": "${IC_USERNAME}",
+        "IC_PASSWORD": "${IC_PASSWORD}",
+        "IC_NAME": "${IC_NAME}"
+      }
+    }
+  }
+}

package/README.md

@@ -31,11 +31,11 @@ Tools that the harness will gate as write/IO operations: `ic_download_document`.
 Set a single set of env vars for your primary Infinite Campus account:
 
 ```
-IC_BASE_URL=https://600.ncsis.gov
-IC_DISTRICT=psu600cms
+IC_BASE_URL=https://campus.springfield.k12.example.us
+IC_DISTRICT=springfield
 IC_USERNAME=parent@example.com
 IC_PASSWORD=...
-IC_NAME=Myers Park           # optional, defaults to IC_DISTRICT
+IC_NAME=Springfield           # optional, defaults to IC_DISTRICT
 ```
 
 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.

package/dist/bundle.js

@@ -30188,8 +30188,12 @@ var ICClient = class {
     return data;
   }
   async request(district, path, opts = {}) {
-    const account2 = this.accounts.get(district);
-    if (!account2) throw new UnknownDistrictError(district, [...this.accounts.keys()]);
+    let account2 = this.accounts.get(district);
+    if (!account2) {
+      await this.ensureDiscovery();
+      account2 = this.accounts.get(district);
+      if (!account2) throw new UnknownDistrictError(district, [...this.accounts.keys()]);
+    }
     await this.ensureSession(account2);
     return this.doRequest(account2, path, opts, false);
   }
@@ -30218,11 +30222,21 @@ var ICClient = class {
     );
     if (postRes.status >= 500) throw new PortalUnreachableError(account2.name, postRes.status);
     const body = await postRes.text();
-    if (postRes.status >= 400 || body.includes("password-error")) {
-      throw new AuthFailedError(account2.name);
+    if (postRes.status >= 400) {
+      throw new AuthFailedError(account2.name, `HTTP ${postRes.status} from verify.jsp`);
+    }
+    const authMatch = body.match(/<AUTHENTICATION>([^<]+)<\/AUTHENTICATION>/i);
+    const authState = authMatch?.[1]?.trim().toLowerCase() ?? "";
+    if (authState === "password-error") {
+      throw new AuthFailedError(account2.name, "IC returned password-error \u2014 wrong username or password");
+    }
+    if (authState && authState !== "success") {
+      throw new AuthFailedError(account2.name, `IC returned authentication state '${authState}'`);
     }
     const cookies = parseSetCookies(postRes.headers);
-    if (!cookies.cookieHeader) throw new AuthFailedError(account2.name);
+    if (!cookies.cookieHeader) {
+      throw new AuthFailedError(account2.name, "login response missing session cookies");
+    }
     const session = this.sessions.get(account2.name);
     session.cookie = cookies.cookieHeader;
     session.xsrfToken = cookies.xsrfToken;
@@ -30425,12 +30439,17 @@ var UnknownDistrictError = class extends Error {
   available;
 };
 var AuthFailedError = class extends Error {
-  constructor(district) {
-    super(`Login failed for district '${district}'. Check IC_USERNAME and IC_PASSWORD.`);
+  constructor(district, reason) {
+    const detail = reason ? ` (${reason})` : "";
+    super(
+      `Login failed for district '${district}'${detail}. Check IC_USERNAME and IC_PASSWORD; if those are correct, the account may be locked or the portal may be down.`
+    );
     this.district = district;
+    this.reason = reason;
     this.name = "AuthFailedError";
   }
   district;
+  reason;
 };
 var PortalUnreachableError = class extends Error {
   constructor(district, status) {
@@ -31318,7 +31337,7 @@ try {
 }
 var account = loadAccount();
 var client = new ICClient(account);
-var server = new McpServer({ name: "infinitecampus", version: "2.0.2" });
+var server = new McpServer({ name: "infinitecampus", version: "2.1.1" });
 registerDistrictTools(server, client);
 registerStudentTools(server, client);
 registerScheduleTools(server, client);

package/dist/client.js

@@ -37,9 +37,18 @@ export class ICClient {
         return data;
     }
     async request(district, path, opts = {}) {
-        const account = this.accounts.get(district);
-        if (!account)
-            throw new UnknownDistrictError(district, [...this.accounts.keys()]);
+        let account = this.accounts.get(district);
+        if (!account) {
+            // Cold-start: linked districts are only added to the accounts map after
+            // primary login + CUPS discovery. If the caller asks for a linked
+            // district before any other request triggered login, we'd otherwise
+            // throw UnknownDistrictError despite the district being valid. Run
+            // discovery once before giving up.
+            await this.ensureDiscovery();
+            account = this.accounts.get(district);
+            if (!account)
+                throw new UnknownDistrictError(district, [...this.accounts.keys()]);
+        }
         await this.ensureSession(account);
         return this.doRequest(account, path, opts, false);
     }
@@ -69,16 +78,27 @@ export class ICClient {
         const postRes = await fetch(`${account.baseUrl}/campus/verify.jsp?nonBrowser=true&username=${encodeURIComponent(account.username)}&password=${encodeURIComponent(account.password)}&appName=${encodeURIComponent(account.district)}&portalLoginPage=parents`, { method: 'POST' });
         if (postRes.status >= 500)
             throw new PortalUnreachableError(account.name, postRes.status);
-        // Check for login failure — IC returns 200 with "password-error" in the
-        // body on bad credentials, not a 4xx status code.
+        // IC's verify.jsp returns 200 with an <AUTHENTICATION>X</AUTHENTICATION>
+        // body where X is the auth state (success / password-error / account-locked
+        // / etc.). 4xx is also possible on misconfigured endpoints. Surface the
+        // actual reason so the LLM can give the user something useful.
         const body = await postRes.text();
-        if (postRes.status >= 400 || body.includes('password-error')) {
-            throw new AuthFailedError(account.name);
+        if (postRes.status >= 400) {
+            throw new AuthFailedError(account.name, `HTTP ${postRes.status} from verify.jsp`);
+        }
+        const authMatch = body.match(/<AUTHENTICATION>([^<]+)<\/AUTHENTICATION>/i);
+        const authState = authMatch?.[1]?.trim().toLowerCase() ?? '';
+        if (authState === 'password-error') {
+            throw new AuthFailedError(account.name, 'IC returned password-error — wrong username or password');
+        }
+        if (authState && authState !== 'success') {
+            throw new AuthFailedError(account.name, `IC returned authentication state '${authState}'`);
         }
         // Capture cookies, deduplicating and filtering out deletions (Max-Age=0).
         const cookies = parseSetCookies(postRes.headers);
-        if (!cookies.cookieHeader)
-            throw new AuthFailedError(account.name);
+        if (!cookies.cookieHeader) {
+            throw new AuthFailedError(account.name, 'login response missing session cookies');
+        }
         // Mutate the in-map session in place so concurrent callers'
         // references stay live (see ensureSession).
         const session = this.sessions.get(account.name);
@@ -271,7 +291,7 @@ export class ICClient {
  * Parse Set-Cookie headers into a deduplicated cookie string + XSRF token.
  *
  * IC's login response sets ~20 cookies including deletion markers (Max-Age=0).
- * Sending both `appName=` (delete) and `appName=psu600cms` (set) causes IC to
+ * Sending both `appName=` (delete) and `appName=springfield` (set) causes IC to
  * reject requests with "conflicting app name values". This parser:
  * - Filters out cookies with Max-Age=0 (deletion markers)
  * - Deduplicates by name (last value wins)
@@ -319,9 +339,14 @@ export class UnknownDistrictError extends Error {
 }
 export class AuthFailedError extends Error {
     district;
-    constructor(district) {
-        super(`Login failed for district '${district}'. Check IC_USERNAME and IC_PASSWORD.`);
+    reason;
+    constructor(district, reason) {
+        const detail = reason ? ` (${reason})` : '';
+        super(`Login failed for district '${district}'${detail}. ` +
+            `Check IC_USERNAME and IC_PASSWORD; ` +
+            `if those are correct, the account may be locked or the portal may be down.`);
         this.district = district;
+        this.reason = reason;
         this.name = 'AuthFailedError';
     }
 }

package/dist/index.js

@@ -34,7 +34,7 @@ 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.2' });
+const server = new McpServer({ name: 'infinitecampus', version: '2.1.1' });
 registerDistrictTools(server, client);
 registerStudentTools(server, client);
 registerScheduleTools(server, client);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "infinitecampus-mcp",
-  "version": "2.0.2",
+  "version": "2.1.1",
+  "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>",
   "repository": {
@@ -30,7 +31,8 @@
     "dist",
     ".claude-plugin",
     "skills",
-    ".mcp.json"
+    ".mcp.json",
+    "server.json"
   ],
   "scripts": {
     "build": "tsc && npm run bundle",

package/server.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.chrischall/infinitecampus-mcp",
+  "description": "Infinite Campus (Campus Parent) for Claude — grades, attendance, assignments, messages",
+  "repository": {
+    "url": "https://github.com/chrischall/infinitecampus-mcp",
+    "source": "github"
+  },
+  "version": "2.1.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "infinitecampus-mcp",
+      "version": "2.1.1",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "IC_BASE_URL",
+          "description": "Campus Parent portal base URL, e.g. https://campus.district.k12.example.us",
+          "isRequired": true,
+          "format": "string"
+        },
+        {
+          "name": "IC_DISTRICT",
+          "description": "Infinite Campus district app name (appName path segment from the portal URL)",
+          "isRequired": true,
+          "format": "string"
+        },
+        {
+          "name": "IC_USERNAME",
+          "description": "Campus Parent portal username",
+          "isRequired": true,
+          "format": "string"
+        },
+        {
+          "name": "IC_PASSWORD",
+          "description": "Campus Parent portal password",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        },
+        {
+          "name": "IC_NAME",
+          "description": "Friendly name for the district (defaults to district appname)",
+          "isRequired": false,
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}