infinitecampus-mcp 2.1.0 → 2.1.2

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.2"
+  },
+  "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.2",
+      "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.2",
+  "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/dist/bundle.js

@@ -30118,12 +30118,21 @@ var StdioServerTransport = class {
 };
 
 // src/config.ts
+function readVar(env, key) {
+  const raw = env[key];
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) return void 0;
+  if (trimmed === "undefined" || trimmed === "null") return void 0;
+  if (/^\$\{[^}]*\}$/.test(trimmed)) return void 0;
+  return trimmed;
+}
 function loadAccount(env = process.env) {
-  const baseUrl = env.IC_BASE_URL;
-  const district = env.IC_DISTRICT;
-  const username = env.IC_USERNAME;
-  const password = env.IC_PASSWORD;
-  const name = env.IC_NAME || district;
+  const baseUrl = readVar(env, "IC_BASE_URL");
+  const district = readVar(env, "IC_DISTRICT");
+  const username = readVar(env, "IC_USERNAME");
+  const password = readVar(env, "IC_PASSWORD");
+  const name = readVar(env, "IC_NAME") ?? district;
   const missing = [];
   if (!baseUrl) missing.push("IC_BASE_URL");
   if (!district) missing.push("IC_DISTRICT");
@@ -30188,8 +30197,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 +30231,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 +30448,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 +31346,7 @@ try {
 }
 var account = loadAccount();
 var client = new ICClient(account);
-var server = new McpServer({ name: "infinitecampus", version: "2.1.0" });
+var server = new McpServer({ name: "infinitecampus", version: "2.1.2" });
 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);
@@ -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/config.js

@@ -1,9 +1,27 @@
+/**
+ * Read an env var, trim whitespace, and treat as unset if blank or if the value
+ * looks like an unsubstituted shell placeholder (e.g. `${FOO}`) — defends
+ * against MCP hosts that pass .mcp.json env blocks through unexpanded.
+ */
+function readVar(env, key) {
+    const raw = env[key];
+    if (typeof raw !== 'string')
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    if (trimmed === 'undefined' || trimmed === 'null')
+        return undefined;
+    if (/^\$\{[^}]*\}$/.test(trimmed))
+        return undefined;
+    return trimmed;
+}
 export function loadAccount(env = process.env) {
-    const baseUrl = env.IC_BASE_URL;
-    const district = env.IC_DISTRICT;
-    const username = env.IC_USERNAME;
-    const password = env.IC_PASSWORD;
-    const name = env.IC_NAME || district;
+    const baseUrl = readVar(env, 'IC_BASE_URL');
+    const district = readVar(env, 'IC_DISTRICT');
+    const username = readVar(env, 'IC_USERNAME');
+    const password = readVar(env, 'IC_PASSWORD');
+    const name = readVar(env, 'IC_NAME') ?? district;
     const missing = [];
     if (!baseUrl)
         missing.push('IC_BASE_URL');

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

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "infinitecampus-mcp",
-  "version": "2.1.0",
+  "version": "2.1.2",
+  "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.2",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "infinitecampus-mcp",
+      "version": "2.1.2",
+      "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"
+        }
+      ]
+    }
+  ]
+}