canvas-parent-mcp 2.1.11 → 2.2.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Canvas LMS (Instructure) — courses, grades, assignments, announcements, planner, conversations, files",
-    "version": "2.1.11"
+    "version": "2.2.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Canvas LMS",
       "source": "./",
       "description": "Canvas LMS (Instructure) MCP server for Claude — student/observer access via natural language",
-      "version": "2.1.11",
+      "version": "2.2.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "canvas-parent-mcp",
   "displayName": "Canvas LMS",
-  "version": "2.1.11",
+  "version": "2.2.0",
   "description": "Canvas LMS (Instructure) MCP server for Claude — courses, grades, assignments, announcements, planner, conversations, files",
   "author": {
     "name": "Chris Hall",

package/README.md

@@ -29,6 +29,16 @@ Mirrors the read-only parent-portal scope of sibling [`infinitecampus-mcp`](http
 
 Tools that the harness will gate as write/IO operations: `canvas_download_file`.
 
+### Planner: child names and a brief view
+
+`canvas_list_planner_items` takes a child by name. At start the server lists your observees once (bounded to 5 s) and publishes their display names as the `observeeId` enum; the tool accepts either a name (any case) or a Canvas user id, and an unknown name is refused with the list of known ones. If the listing fails or you observe nobody, `observeeId` is published as a plain string and ids pass through as before. Two children with the same display name are listed as `Name (id)`.
+
+`view: "brief"` returns one line per planner item, at most 120 characters: `title — due <ISO date or "no date"> — <submitted|not submitted|missing>`. Items with nothing to submit (planner notes, pages, events) carry no status. The default (`view: "full"`) is Canvas's payload, unchanged.
+
+### Context-group hints
+
+Every tool except `canvas_healthcheck` carries a `_meta.mint` hint for hosts that group tools by context (mcp-host's context groups): `domain: "school"` plus an `intent` — `whats-due` for the planner and missing submissions, `whats-new` for announcements, `whats-on` for the calendar tools, `lookup` for the other reads, `other` for the download. The planner (`whats-due`) and announcements (`whats-new`) are marked `canonical`; the planner also names its subject argument (`observeeId`) and range (`startDate`/`endDate`). Hosts that do not read `_meta` see nothing different.
+
 `canvas_download_file` only fetches `/files/…` URLs on your `CANVAS_BASE_URL` host (https), so your Canvas credential is never sent anywhere else, and it only writes inside a download directory: `CANVAS_OUTPUT_DIR` if set, otherwise `~/Downloads`. A relative `destinationPath` is resolved against that directory. It never writes through a symlink at the destination, and new files are created owner-only (0600).
 
 ## Configuration

package/dist/bundle.js

@@ -289,14 +289,14 @@ var require_util = __commonJS({
     }
     function randomString2(length = 10) {
       const chars = "abcdefghijklmnopqrstuvwxyz";
-      let str = "";
+      let str2 = "";
       for (let i = 0; i < length; i++) {
-        str += chars[Math.floor(Math.random() * chars.length)];
+        str2 += chars[Math.floor(Math.random() * chars.length)];
       }
-      return str;
+      return str2;
     }
-    function esc2(str) {
-      return JSON.stringify(str);
+    function esc2(str2) {
+      return JSON.stringify(str2);
     }
     function slugify2(input2) {
       return input2.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
@@ -411,8 +411,8 @@ var require_util = __commonJS({
       "symbol",
       "undefined"
     ]);
-    function escapeRegex2(str) {
-      return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    function escapeRegex2(str2) {
+      return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
     }
     function clone2(inst, def, params) {
       const cl = new inst._zod.constr(def ?? inst._zod.def);
@@ -678,13 +678,13 @@ var require_util = __commonJS({
       return "unknown";
     }
     var highSurrogate2 = /[\uD800-\uDBFF]/;
-    function codePointLength2(str) {
-      const units = str.length;
-      if (!highSurrogate2.test(str))
+    function codePointLength2(str2) {
+      const units = str2.length;
+      if (!highSurrogate2.test(str2))
         return units;
       let count = units;
       for (let i = 0; i < units - 1; i++) {
-        if ((str.charCodeAt(i) & 64512) === 55296 && (str.charCodeAt(i + 1) & 64512) === 56320) {
+        if ((str2.charCodeAt(i) & 64512) === 55296 && (str2.charCodeAt(i + 1) & 64512) === 56320) {
           count--;
           i++;
         }
@@ -32807,7 +32807,7 @@ var require_code$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
   }
   exports._ = _;
   const plus = new _Code("+");
-  function str(strs, ...args) {
+  function str2(strs, ...args) {
     const expr = [safeStringify(strs[0])];
     let i = 0;
     while (i < args.length) {
@@ -32818,7 +32818,7 @@ var require_code$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
     optimize(expr);
     return new _Code(expr);
   }
-  exports.str = str;
+  exports.str = str2;
   function addCodeArg(code, arg) {
     if (arg instanceof _Code) code.push(...arg._items);
     else if (arg instanceof Name) code.push(arg);
@@ -32851,7 +32851,7 @@ var require_code$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
     if (typeof b == "string" && b[0] === '"' && !(a instanceof Name)) return `"${a}${b.slice(1)}`;
   }
   function strConcat(c1, c2) {
-    return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str`${c1}${c2}`;
+    return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str2`${c1}${c2}`;
   }
   exports.strConcat = strConcat;
   function interpolate(x) {
@@ -33730,21 +33730,21 @@ var require_util2 = /* @__PURE__ */ __commonJSMin(((exports) => {
     return (0, codegen_1._)`${topSchemaRef}${schemaPath}${(0, codegen_1.getProperty)(keyword)}`;
   }
   exports.schemaRefOrVal = schemaRefOrVal;
-  function unescapeFragment(str) {
-    return unescapeJsonPointer(decodeURIComponent(str));
+  function unescapeFragment(str2) {
+    return unescapeJsonPointer(decodeURIComponent(str2));
   }
   exports.unescapeFragment = unescapeFragment;
-  function escapeFragment(str) {
-    return encodeURIComponent(escapeJsonPointer(str));
+  function escapeFragment(str2) {
+    return encodeURIComponent(escapeJsonPointer(str2));
   }
   exports.escapeFragment = escapeFragment;
-  function escapeJsonPointer(str) {
-    if (typeof str == "number") return `${str}`;
-    return str.replace(/~/g, "~0").replace(/\//g, "~1");
+  function escapeJsonPointer(str2) {
+    if (typeof str2 == "number") return `${str2}`;
+    return str2.replace(/~/g, "~0").replace(/\//g, "~1");
   }
   exports.escapeJsonPointer = escapeJsonPointer;
-  function unescapeJsonPointer(str) {
-    return str.replace(/~1/g, "/").replace(/~0/g, "~");
+  function unescapeJsonPointer(str2) {
+    return str2.replace(/~1/g, "/").replace(/~0/g, "~");
   }
   exports.unescapeJsonPointer = unescapeJsonPointer;
   function eachItem(xs, f) {
@@ -34630,8 +34630,8 @@ var require_json_schema_traverse = /* @__PURE__ */ __commonJSMin(((exports, modu
       post(schema, jsonPtr, rootSchema, parentJsonPtr, parentKeyword, parentSchema, keyIndex);
     }
   }
-  function escapeJsonPtr(str) {
-    return str.replace(/~/g, "~0").replace(/\//g, "~1");
+  function escapeJsonPtr(str2) {
+    return str2.replace(/~/g, "~0").replace(/\//g, "~1");
   }
 }));
 var require_resolve = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -35576,9 +35576,9 @@ var require_utils = /* @__PURE__ */ __commonJSMin(((exports, module) => {
       isIPV6: true
     };
   }
-  function findToken(str, token) {
+  function findToken(str2, token) {
     let ind = 0;
-    for (let i = 0; i < str.length; i++) if (str[i] === token) ind++;
+    for (let i = 0; i < str2.length; i++) if (str2[i] === token) ind++;
     return ind;
   }
   function removeDotSegments(path) {
@@ -36393,7 +36393,7 @@ var require_core$3 = /* @__PURE__ */ __commonJSMin(((exports) => {
   const util_1 = require_util2();
   const $dataRefSchema = require_data();
   const uri_1 = require_uri();
-  const defaultRegExp = (str, flags) => new RegExp(str, flags);
+  const defaultRegExp = (str2, flags) => new RegExp(str2, flags);
   defaultRegExp.code = "new RegExp";
   const META_IGNORE_OPTIONS = [
     "removeAdditional",
@@ -37099,16 +37099,16 @@ var require_multipleOf = /* @__PURE__ */ __commonJSMin(((exports) => {
 }));
 var require_ucs2length = /* @__PURE__ */ __commonJSMin(((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
-  function ucs2length(str) {
-    const len = str.length;
+  function ucs2length(str2) {
+    const len = str2.length;
     let length = 0;
     let pos = 0;
     let value;
     while (pos < len) {
       length++;
-      value = str.charCodeAt(pos++);
+      value = str2.charCodeAt(pos++);
       if (value >= 55296 && value <= 56319 && pos < len) {
-        value = str.charCodeAt(pos);
+        value = str2.charCodeAt(pos);
         if ((value & 64512) === 56320) pos++;
       }
     }
@@ -39819,8 +39819,8 @@ var require_formats = /* @__PURE__ */ __commonJSMin(((exports) => {
     30,
     31
   ];
-  function date5(str) {
-    const matches = DATE.exec(str);
+  function date5(str2) {
+    const matches = DATE.exec(str2);
     if (!matches) return false;
     const year = +matches[1];
     const month = +matches[2];
@@ -39835,8 +39835,8 @@ var require_formats = /* @__PURE__ */ __commonJSMin(((exports) => {
   }
   const TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
   function getTime(strictTimeZone) {
-    return function time3(str) {
-      const matches = TIME.exec(str);
+    return function time3(str2) {
+      const matches = TIME.exec(str2);
       if (!matches) return false;
       const hr = +matches[1];
       const min = +matches[2];
@@ -39873,8 +39873,8 @@ var require_formats = /* @__PURE__ */ __commonJSMin(((exports) => {
   const DATE_TIME_SEPARATOR = /t|\s/i;
   function getDateTime(strictTimeZone) {
     const time3 = getTime(strictTimeZone);
-    return function date_time(str) {
-      const dateTime = str.split(DATE_TIME_SEPARATOR);
+    return function date_time(str2) {
+      const dateTime = str2.split(DATE_TIME_SEPARATOR);
       return dateTime.length === 2 && date5(dateTime[0]) && time3(dateTime[1]);
     };
   }
@@ -39895,13 +39895,13 @@ var require_formats = /* @__PURE__ */ __commonJSMin(((exports) => {
   }
   const NOT_URI_FRAGMENT = /\/|:/;
   const URI = /^(?:[a-z][a-z0-9+\-.]*:)(?:\/?\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\.[a-z0-9\-._~!$&'()*+,;=:]+)\]|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?)|(?:[a-z0-9\-._~!$&'()*+,;=]|%[0-9a-f]{2})*)(?::\d*)?(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*|\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)(?:\?(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i;
-  function uri(str) {
-    return NOT_URI_FRAGMENT.test(str) && URI.test(str);
+  function uri(str2) {
+    return NOT_URI_FRAGMENT.test(str2) && URI.test(str2);
   }
   const BYTE = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm;
-  function byte(str) {
+  function byte(str2) {
     BYTE.lastIndex = 0;
-    return BYTE.test(str);
+    return BYTE.test(str2);
   }
   const MIN_INT32 = -(2 ** 31);
   const MAX_INT32 = 2 ** 31 - 1;
@@ -39915,10 +39915,10 @@ var require_formats = /* @__PURE__ */ __commonJSMin(((exports) => {
     return true;
   }
   const Z_ANCHOR = /[^\\]\\Z/;
-  function regex(str) {
-    if (Z_ANCHOR.test(str)) return false;
+  function regex(str2) {
+    if (Z_ANCHOR.test(str2)) return false;
     try {
-      new RegExp(str);
+      new RegExp(str2);
       return true;
     } catch (e) {
       return false;
@@ -41531,17 +41531,17 @@ var McpServer = class {
     if (Array.isArray(variableNames) && variableNames.some((v) => !!template.completeCallback(v))) this.setCompletionRequestHandler();
     return registeredResourceTemplate;
   }
-  _createRegisteredPrompt(name, title, description, argsSchema7, callback, icons, scopeChallenge, _meta) {
-    let currentArgsSchema = argsSchema7;
+  _createRegisteredPrompt(name, title, description, argsSchema6, callback, icons, scopeChallenge, _meta) {
+    let currentArgsSchema = argsSchema6;
     let currentCallback = callback;
     const registeredPrompt = {
       title,
       description,
-      argsSchema: argsSchema7,
+      argsSchema: argsSchema6,
       icons,
       scopeChallenge,
       _meta,
-      handler: createPromptHandler(name, argsSchema7, callback),
+      handler: createPromptHandler(name, argsSchema6, callback),
       enabled: true,
       disable: () => registeredPrompt.update({ enabled: false }),
       enable: () => registeredPrompt.update({ enabled: true }),
@@ -41572,8 +41572,8 @@ var McpServer = class {
       }
     };
     this._registeredPrompts[name] = registeredPrompt;
-    if (argsSchema7) {
-      const shape = getSchemaShape(argsSchema7);
+    if (argsSchema6) {
+      const shape = getSchemaShape(argsSchema6);
       if (shape) {
         if (Object.values(shape).some((field) => {
           return isCompletable(unwrapOptionalSchema(field));
@@ -41657,8 +41657,8 @@ var McpServer = class {
   }
   registerPrompt(name, config2, cb) {
     if (this._registeredPrompts[name]) throw new Error(`Prompt ${name} is already registered`);
-    const { title, description, argsSchema: argsSchema7, icons, scopeChallenge, _meta } = config2;
-    const registeredPrompt = this._createRegisteredPrompt(name, title, description, normalizeRawShapeSchema(argsSchema7), cb, icons, scopeChallenge, _meta);
+    const { title, description, argsSchema: argsSchema6, icons, scopeChallenge, _meta } = config2;
+    const registeredPrompt = this._createRegisteredPrompt(name, title, description, normalizeRawShapeSchema(argsSchema6), cb, icons, scopeChallenge, _meta);
     this.setPromptRequestHandlers();
     this.sendPromptListChanged();
     return registeredPrompt;
@@ -41737,11 +41737,11 @@ function convertOutputSchemaJson(outputSchema) {
     return;
   }
 }
-function createPromptHandler(name, argsSchema7, callback) {
-  if (argsSchema7) {
+function createPromptHandler(name, argsSchema6, callback) {
+  if (argsSchema6) {
     const typedCallback = callback;
     return async (args, ctx) => {
-      const parseResult = await validateStandardSchema(argsSchema7, args ?? {});
+      const parseResult = await validateStandardSchema(argsSchema6, args ?? {});
       if (!parseResult.success) throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Invalid arguments for prompt ${name}: ${parseResult.error}`);
       return typedCallback(parseResult.data, ctx);
     };
@@ -42612,9 +42612,9 @@ function redactValues(text, values, opts = {}) {
   return out;
 }
 function truncateErrorMessage(text, max = DEFAULT_ERROR_MESSAGE_MAX, opts = {}) {
-  const str = text === null || text === void 0 ? "" : String(text);
+  const str2 = text === null || text === void 0 ? "" : String(text);
   const cap = Math.max(ERROR_REDACTION_INPUT_MAX, max);
-  const capped = str.length > cap ? str.slice(0, cap) : str;
+  const capped = str2.length > cap ? str2.slice(0, cap) : str2;
   const scrubbed = opts.values !== void 0 ? redactValues(capped, opts.values, opts.placeholder !== void 0 ? { placeholder: opts.placeholder } : {}) : capped;
   const redacted = redactSecrets(scrubbed);
   if (redacted.length <= max)
@@ -43462,14 +43462,14 @@ function promiseAllObject(promisesObj) {
 }
 function randomString(length = 10) {
   const chars = "abcdefghijklmnopqrstuvwxyz";
-  let str = "";
+  let str2 = "";
   for (let i = 0; i < length; i++) {
-    str += chars[Math.floor(Math.random() * chars.length)];
+    str2 += chars[Math.floor(Math.random() * chars.length)];
   }
-  return str;
+  return str2;
 }
-function esc(str) {
-  return JSON.stringify(str);
+function esc(str2) {
+  return JSON.stringify(str2);
 }
 function slugify(input2) {
   return input2.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
@@ -43583,8 +43583,8 @@ var primitiveTypes = /* @__PURE__ */ new Set([
   "symbol",
   "undefined"
 ]);
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function escapeRegex(str2) {
+  return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function clone(inst, def, params) {
   const cl = new inst._zod.constr(def ?? inst._zod.def);
@@ -43850,13 +43850,13 @@ function getSizableOrigin(input2) {
   return "unknown";
 }
 var highSurrogate = /[\uD800-\uDBFF]/;
-function codePointLength(str) {
-  const units = str.length;
-  if (!highSurrogate.test(str))
+function codePointLength(str2) {
+  const units = str2.length;
+  if (!highSurrogate.test(str2))
     return units;
   let count = units;
   for (let i = 0; i < units - 1; i++) {
-    if ((str.charCodeAt(i) & 64512) === 55296 && (str.charCodeAt(i + 1) & 64512) === 56320) {
+    if ((str2.charCodeAt(i) & 64512) === 55296 && (str2.charCodeAt(i + 1) & 64512) === 56320) {
       count--;
       i++;
     }
@@ -69665,7 +69665,7 @@ function loadAccount(env = process.env) {
 // package.json
 var package_default = {
   name: "canvas-parent-mcp",
-  version: "2.1.11",
+  version: "2.2.0",
   mcpName: "io.github.chrischall/canvas-parent-mcp",
   description: "Canvas LMS (Instructure) MCP server \u2014 student/observer read access with optional file download",
   author: "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -71152,6 +71152,18 @@ var FileExistsError = class extends Error {
   path;
 };
 
+// src/tools/_shared.ts
+var textContent = minifiedResult;
+function buildPath(base, params = {}) {
+  return `${base}${buildQueryString(params)}`;
+}
+function userSegment(observeeId) {
+  return observeeId ? `users/${encodeURIComponent(observeeId)}` : "users/self";
+}
+function schoolMeta(intent, extra = {}) {
+  return { mint: { domain: "school", intent, ...extra } };
+}
+
 // src/view.ts
 var CV_VIEWS = ["compact", "full"];
 var NOTE = `compact removes the avatar URLs Canvas attaches to user objects (avatar_url, avatar_image_url); "full" returns Canvas's payload untouched. Link fields (url, html_url, preview_url) survive both rungs. No field projection: this server passes Canvas's payload through verbatim and has no verified record of which of its fields a caller needs.`;
@@ -71171,6 +71183,7 @@ function registerProfileTools(server, client2) {
   server.registerTool("canvas_get_profile", {
     description: "Get the logged-in user's Canvas profile (id, name, primary_email, login_id, locale, time_zone). Useful first call to confirm credentials.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: argsSchema
   }, async (rawArgs) => {
     const args = argsSchema.parse(rawArgs);
@@ -71187,6 +71200,7 @@ function registerObserveeTools(server, client2) {
   server.registerTool("canvas_list_observees", {
     description: "List students linked to your Canvas observer account. Returns an empty array for plain student tokens.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: argsSchema2
   }, async (rawArgs) => {
     const args = argsSchema2.parse(rawArgs);
@@ -71194,14 +71208,53 @@ function registerObserveeTools(server, client2) {
     return viewResponse(args.view, data);
   });
 }
-
-// src/tools/_shared.ts
-var textContent = minifiedResult;
-function buildPath(base, params = {}) {
-  return `${base}${buildQueryString(params)}`;
+var OBSERVEE_LIST_TIMEOUT_MS = 5e3;
+function readObservees(data) {
+  if (!Array.isArray(data)) return [];
+  const out = [];
+  for (const row of data) {
+    if (!row || typeof row !== "object") continue;
+    const r = row;
+    if (typeof r.id !== "string" && typeof r.id !== "number") continue;
+    const id = String(r.id);
+    const name = [r.name, r.short_name].find((v) => typeof v === "string" && v.trim() !== "");
+    out.push({ id, label: name?.trim() ?? id });
+  }
+  return out;
 }
-function userSegment(observeeId) {
-  return observeeId ? `users/${encodeURIComponent(observeeId)}` : "users/self";
+function buildDirectory(users) {
+  if (users.length === 0) return null;
+  const counts = /* @__PURE__ */ new Map();
+  for (const u of users) counts.set(u.label.toLowerCase(), (counts.get(u.label.toLowerCase()) ?? 0) + 1);
+  const labelled = users.map((u) => ({
+    id: u.id,
+    label: counts.get(u.label.toLowerCase()) > 1 ? `${u.label} (${u.id})` : u.label
+  }));
+  const byLabel = new Map(labelled.map((u) => [u.label.toLowerCase(), u.id]));
+  const ids = new Set(labelled.map((u) => u.id));
+  const labels = labelled.map((u) => u.label);
+  return {
+    labels,
+    resolve(value) {
+      const id = byLabel.get(value.trim().toLowerCase());
+      if (id !== void 0) return id;
+      if (ids.has(value.trim())) return value.trim();
+      throw new Error(`Unknown observee "${value}". Known: ${labels.join(", ")}.`);
+    }
+  };
+}
+async function loadObserveeDirectory(client2, timeoutMs = OBSERVEE_LIST_TIMEOUT_MS) {
+  let timer;
+  const deadline = new Promise((resolve5) => {
+    timer = setTimeout(() => resolve5(null), timeoutMs);
+    timer.unref();
+  });
+  const listing = client2.requestPaginated("/api/v1/users/self/observees").then((data) => buildDirectory(readObservees(data))).catch(() => null);
+  try {
+    return await Promise.race([listing, deadline]);
+  } finally {
+    clearTimeout(timer);
+  }
 }
 
 // src/tools/courses.ts
@@ -71216,6 +71269,7 @@ function registerCourseTools(server, client2) {
   server.registerTool("canvas_list_courses", {
     description: "List active Canvas courses (with course-level grades, total scores, current grading period scores, and term).",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: listArgs
   }, async (rawArgs) => {
     const args = listArgs.parse(rawArgs);
@@ -71230,6 +71284,7 @@ function registerCourseTools(server, client2) {
   server.registerTool("canvas_get_course", {
     description: "Get a single Canvas course with its syllabus, teachers, and term.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: getArgs
   }, async (rawArgs) => {
     const args = getArgs.parse(rawArgs);
@@ -71254,6 +71309,7 @@ function registerAssignmentTools(server, client2) {
   server.registerTool("canvas_list_assignments", {
     description: "List a course's assignments \u2014 homework, quizzes and projects \u2014 with the user's (or child's) submission inline. Supports the standard Canvas `bucket` filter.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: listArgs2
   }, async (rawArgs) => {
     const args = listArgs2.parse(rawArgs);
@@ -71268,6 +71324,7 @@ function registerAssignmentTools(server, client2) {
   server.registerTool("canvas_list_missing_submissions", {
     description: "List missing homework: past-due unsubmitted assignments for the user (or a linked observee, e.g. a child). For an observee, courseIds is required.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("whats-due"),
     inputSchema: missingArgs
   }, async (rawArgs) => {
     const args = missingArgs.parse(rawArgs);
@@ -71301,6 +71358,7 @@ function registerSubmissionTools(server, client2) {
   server.registerTool("canvas_get_submission", {
     description: "Get a single submission with rubric assessment and grader comments. userId defaults to 'self'.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: getArgs2
   }, async (rawArgs) => {
     const args = getArgs2.parse(rawArgs);
@@ -71315,6 +71373,7 @@ function registerSubmissionTools(server, client2) {
   server.registerTool("canvas_list_recent_submissions", {
     description: "List recently graded submissions in a course. Defaults to a 14-day window for the calling user.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: recentArgs
   }, async (rawArgs) => {
     const args = recentArgs.parse(rawArgs);
@@ -71339,6 +71398,7 @@ function registerGradeTools(server, client2) {
   server.registerTool("canvas_list_enrollments", {
     description: "List active student enrollments with per-course grades (current_score, final_score, current_grade, final_grade, current grading period info).",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: argsSchema3
   }, async (rawArgs) => {
     const args = argsSchema3.parse(rawArgs);
@@ -71364,6 +71424,7 @@ function registerCalendarTools(server, client2) {
   server.registerTool("canvas_list_calendar_events", {
     description: "List Canvas calendar events or assignments across selected contexts (courses/users).",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("whats-on"),
     inputSchema: eventsArgs
   }, async (rawArgs) => {
     const args = eventsArgs.parse(rawArgs);
@@ -71379,7 +71440,8 @@ function registerCalendarTools(server, client2) {
   });
   server.registerTool("canvas_list_upcoming_events", {
     description: "List the calling user's upcoming events (Canvas's curated next-7-days view).",
-    annotations: { readOnlyHint: true, openWorldHint: true }
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("whats-on")
   }, async () => {
     const data = await client2.request("/api/v1/users/self/upcoming_events");
     return textContent(data);
@@ -71387,21 +71449,56 @@ function registerCalendarTools(server, client2) {
 }
 
 // src/tools/planner.ts
-var argsSchema4 = external_exports.object({
-  observeeId: external_exports.string().optional(),
-  startDate: external_exports.string().optional(),
-  endDate: external_exports.string().optional(),
-  contextCodes: external_exports.array(external_exports.string()).optional(),
-  filter: external_exports.enum(["new_activity"]).optional()
-});
-function registerPlannerTools(server, client2) {
+var OBSERVEE_DESCRIPTION = "A linked observee (child): their display name as listed, or their Canvas user id. Omit for your own planner.";
+function observeeIdArg(observees2) {
+  const base = external_exports.string();
+  return (observees2 ? base.meta({ enum: observees2.labels }) : base).optional().describe(OBSERVEE_DESCRIPTION);
+}
+var BRIEF_MAX = 120;
+function str(v) {
+  return typeof v === "string" && v.trim() !== "" ? v.trim() : void 0;
+}
+function briefLine(item) {
+  const it = item && typeof item === "object" ? item : {};
+  const p = it.plannable && typeof it.plannable === "object" ? it.plannable : {};
+  const title = str(p.title) ?? str(p.name) ?? str(it.title) ?? "(untitled)";
+  const due = str(p.due_at) ?? str(it.plannable_date) ?? "no date";
+  const sub = it.submissions;
+  let status = "";
+  if (sub && typeof sub === "object") {
+    const s = sub;
+    status = s.missing === true ? "missing" : s.submitted === true ? "submitted" : "not submitted";
+  }
+  const tail = ` \u2014 due ${due}${status ? ` \u2014 ${status}` : ""}`;
+  const room = BRIEF_MAX - tail.length;
+  const shown = title.length > room ? `${title.slice(0, Math.max(room - 1, 0))}\u2026` : title;
+  return `${shown}${tail}`;
+}
+function registerPlannerTools(server, client2, observees2) {
+  const argsSchema6 = external_exports.object({
+    observeeId: observeeIdArg(observees2),
+    startDate: external_exports.string().optional(),
+    endDate: external_exports.string().optional(),
+    contextCodes: external_exports.array(external_exports.string()).optional(),
+    filter: external_exports.enum(["new_activity"]).optional(),
+    view: external_exports.enum(["full", "brief"]).optional().describe(
+      `"full" (default) returns Canvas's planner items verbatim; "brief" returns one line per item: title \u2014 due <ISO date or "no date"> \u2014 <submitted|not submitted|missing>.`
+    )
+  });
   server.registerTool("canvas_list_planner_items", {
     description: "List planner items (assignments + announcements + planner notes + calendar events) for the user or a linked observee.",
     annotations: { readOnlyHint: true, openWorldHint: true },
-    inputSchema: argsSchema4
+    _meta: schoolMeta("whats-due", {
+      canonical: true,
+      subject: "observeeId",
+      when: { start: "startDate", end: "endDate" },
+      aliases: ["homework", "assignments", "due", "kids", "school"]
+    }),
+    inputSchema: argsSchema6
   }, async (rawArgs) => {
-    const args = argsSchema4.parse(rawArgs);
-    const base = args.observeeId ? `/api/v1/users/${encodeURIComponent(args.observeeId)}/planner/items` : "/api/v1/planner/items";
+    const args = argsSchema6.parse(rawArgs);
+    const observeeId = args.observeeId !== void 0 && observees2 ? observees2.resolve(args.observeeId) : args.observeeId;
+    const base = observeeId ? `/api/v1/users/${encodeURIComponent(observeeId)}/planner/items` : "/api/v1/planner/items";
     const path = buildPath(base, {
       start_date: args.startDate,
       end_date: args.endDate,
@@ -71409,12 +71506,15 @@ function registerPlannerTools(server, client2) {
       filter: args.filter
     });
     const data = await client2.requestPaginated(path);
+    if (args.view === "brief") {
+      return { content: [{ type: "text", text: data.map(briefLine).join("\n") }] };
+    }
     return textContent(data);
   });
 }
 
 // src/tools/announcements.ts
-var argsSchema5 = external_exports.object({
+var argsSchema4 = external_exports.object({
   contextCodes: external_exports.array(external_exports.string()).describe('Required. Array like ["course_123", "course_456"].'),
   startDate: external_exports.string().optional(),
   endDate: external_exports.string().optional(),
@@ -71425,9 +71525,10 @@ function registerAnnouncementTools(server, client2) {
   server.registerTool("canvas_list_announcements", {
     description: 'List announcements across one or more courses. `contextCodes` is required (e.g. ["course_123"]). Defaults to active-only.',
     annotations: { readOnlyHint: true, openWorldHint: true },
-    inputSchema: argsSchema5
+    _meta: schoolMeta("whats-new", { canonical: true, aliases: ["teacher", "announcements", "news"] }),
+    inputSchema: argsSchema4
   }, async (rawArgs) => {
-    const args = argsSchema5.parse(rawArgs);
+    const args = argsSchema4.parse(rawArgs);
     const path = buildPath("/api/v1/announcements", {
       "context_codes[]": args.contextCodes,
       start_date: args.startDate,
@@ -71453,6 +71554,7 @@ function registerConversationTools(server, client2) {
   server.registerTool("canvas_list_conversations", {
     description: "List Canvas inbox conversations. Optional `scope` (unread/starred/archived/sent) and `filter` (array of context codes).",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: listArgs3
   }, async (rawArgs) => {
     const args = listArgs3.parse(rawArgs);
@@ -71467,6 +71569,7 @@ function registerConversationTools(server, client2) {
   server.registerTool("canvas_get_conversation", {
     description: "Get a full Canvas conversation thread with all messages. Read-only: does not mark the conversation as read.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: getArgs3
   }, async (rawArgs) => {
     const args = getArgs3.parse(rawArgs);
@@ -71480,7 +71583,7 @@ function registerConversationTools(server, client2) {
 }
 
 // src/tools/discussions.ts
-var argsSchema6 = external_exports.object({
+var argsSchema5 = external_exports.object({
   courseId: external_exports.string(),
   onlyAnnouncements: external_exports.boolean().optional(),
   orderBy: external_exports.enum(["position", "recent_activity", "title"]).optional(),
@@ -71490,9 +71593,10 @@ function registerDiscussionTools(server, client2) {
   server.registerTool("canvas_list_discussion_topics", {
     description: "List discussion topics for a course (read-only).",
     annotations: { readOnlyHint: true, openWorldHint: true },
-    inputSchema: argsSchema6
+    _meta: schoolMeta("lookup"),
+    inputSchema: argsSchema5
   }, async (rawArgs) => {
-    const args = argsSchema6.parse(rawArgs);
+    const args = argsSchema5.parse(rawArgs);
     const path = buildPath(`/api/v1/courses/${encodeURIComponent(args.courseId)}/discussion_topics`, {
       only_announcements: args.onlyAnnouncements ?? false,
       order_by: args.orderBy
@@ -71517,6 +71621,7 @@ function registerFileTools(server, client2) {
   server.registerTool("canvas_list_course_files", {
     description: "List a course's files (metadata only \u2014 use canvas_download_file with the `url` field).",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: schoolMeta("lookup"),
     inputSchema: listArgs4
   }, async (rawArgs) => {
     const args = listArgs4.parse(rawArgs);
@@ -71530,6 +71635,7 @@ function registerFileTools(server, client2) {
   server.registerTool("canvas_download_file", {
     description: "Download a Canvas file to disk. `url` is the absolute URL from canvas_list_course_files (only file URLs on the configured Canvas host are accepted); `destinationPath` is required and must be inside the download directory (CANVAS_OUTPUT_DIR, default ~/Downloads).",
     annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    _meta: schoolMeta("other"),
     inputSchema: downloadArgs
   }, async (rawArgs) => {
     const args = downloadArgs.parse(rawArgs);
@@ -71551,9 +71657,10 @@ try {
   configError = e;
 }
 var client = resolved ? new CanvasClient(resolved.account, { refreshSession: resolved.refresh }) : null;
+var observees = client ? await loadObserveeDirectory(client) : null;
 await runMcp({
   name: "canvas",
-  version: "2.1.11",
+  version: "2.2.0",
   // x-release-please-version
   tools: [
     // Outside the `if (resolved)` on purpose: an unconfigured server must
@@ -71568,7 +71675,7 @@ await runMcp({
         registerSubmissionTools(server, client);
         registerGradeTools(server, client);
         registerCalendarTools(server, client);
-        registerPlannerTools(server, client);
+        registerPlannerTools(server, client, observees);
         registerAnnouncementTools(server, client);
         registerConversationTools(server, client);
         registerDiscussionTools(server, client);

package/dist/index.js

@@ -11,7 +11,7 @@ import { resolveAuth } from './auth.js';
 import { registerHealthcheckTools } from './tools/healthcheck.js';
 import { CanvasClient } from './client.js';
 import { registerProfileTools } from './tools/profile.js';
-import { registerObserveeTools } from './tools/observees.js';
+import { registerObserveeTools, loadObserveeDirectory } from './tools/observees.js';
 import { registerCourseTools } from './tools/courses.js';
 import { registerAssignmentTools } from './tools/assignments.js';
 import { registerSubmissionTools } from './tools/submissions.js';
@@ -46,6 +46,11 @@ catch (e) {
 const client = resolved
     ? new CanvasClient(resolved.account, { refreshSession: resolved.refresh })
     : null;
+// The planner's `observeeId` publishes the observees' display names as an
+// enum (context groups, mcp-host spec 2026-11-03 D5), so list them ONCE here —
+// registrars run per served instance — bounded by OBSERVEE_LIST_TIMEOUT_MS.
+// Null (failure, timeout, nobody observed) publishes the property with no enum.
+const observees = client ? await loadObserveeDirectory(client) : null;
 // `runMcp` (from @chrischall/mcp-utils) builds the McpServer, runs the
 // registrar, then connects the stdio transport and installs SIGINT/SIGTERM
 // shutdown handlers. The deferred-config-error pattern is preserved by
@@ -54,7 +59,7 @@ const client = resolved
 // host's install-time `tools/list` succeeds.
 await runMcp({
     name: 'canvas',
-    version: '2.1.11', // x-release-please-version
+    version: '2.2.0', // x-release-please-version
     tools: [
         // Outside the `if (resolved)` on purpose: an unconfigured server must
         // still expose something that can say WHY (see the tool's docblock).
@@ -68,7 +73,7 @@ await runMcp({
                 registerSubmissionTools(server, client);
                 registerGradeTools(server, client);
                 registerCalendarTools(server, client);
-                registerPlannerTools(server, client);
+                registerPlannerTools(server, client, observees);
                 registerAnnouncementTools(server, client);
                 registerConversationTools(server, client);
                 registerDiscussionTools(server, client);

package/dist/tools/_shared.js

@@ -29,3 +29,7 @@ export function buildPath(base, params = {}) {
 export function userSegment(observeeId) {
     return observeeId ? `users/${encodeURIComponent(observeeId)}` : 'users/self';
 }
+/** `_meta` for a Canvas tool: every tool here is in the `school` domain. */
+export function schoolMeta(intent, extra = {}) {
+    return { mint: { domain: 'school', intent, ...extra } };
+}

package/dist/tools/announcements.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { buildPath } from './_shared.js';
+import { buildPath, schoolMeta } from './_shared.js';
 import { viewArg, viewResponse } from '../view.js';
 const argsSchema = z.object({
     contextCodes: z.array(z.string()).describe('Required. Array like ["course_123", "course_456"].'),
@@ -12,6 +12,7 @@ export function registerAnnouncementTools(server, client) {
     server.registerTool('canvas_list_announcements', {
         description: "List announcements across one or more courses. `contextCodes` is required (e.g. [\"course_123\"]). Defaults to active-only.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('whats-new', { canonical: true, aliases: ['teacher', 'announcements', 'news'] }),
         inputSchema: argsSchema,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);

package/dist/tools/assignments.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, buildPath, userSegment } from './_shared.js';
+import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
 const listArgs = z.object({
     courseId: z.string(),
     bucket: z.enum(['past', 'overdue', 'undated', 'ungraded', 'unsubmitted', 'upcoming', 'future']).optional()
@@ -13,6 +13,7 @@ export function registerAssignmentTools(server, client) {
     server.registerTool('canvas_list_assignments', {
         description: "List a course's assignments — homework, quizzes and projects — with the user's (or child's) submission inline. Supports the standard Canvas `bucket` filter.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: listArgs,
     }, async (rawArgs) => {
         const args = listArgs.parse(rawArgs);
@@ -27,6 +28,7 @@ export function registerAssignmentTools(server, client) {
     server.registerTool('canvas_list_missing_submissions', {
         description: "List missing homework: past-due unsubmitted assignments for the user (or a linked observee, e.g. a child). For an observee, courseIds is required.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('whats-due'),
         inputSchema: missingArgs,
     }, async (rawArgs) => {
         const args = missingArgs.parse(rawArgs);

package/dist/tools/calendar.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, buildPath } from './_shared.js';
+import { textContent, buildPath, schoolMeta } from './_shared.js';
 const eventsArgs = z.object({
     contextCodes: z.array(z.string()).optional().describe('Array like ["course_123", "user_456"].'),
     type: z.enum(['event', 'assignment']).optional(),
@@ -11,6 +11,7 @@ export function registerCalendarTools(server, client) {
     server.registerTool('canvas_list_calendar_events', {
         description: 'List Canvas calendar events or assignments across selected contexts (courses/users).',
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('whats-on'),
         inputSchema: eventsArgs,
     }, async (rawArgs) => {
         const args = eventsArgs.parse(rawArgs);
@@ -27,6 +28,7 @@ export function registerCalendarTools(server, client) {
     server.registerTool('canvas_list_upcoming_events', {
         description: "List the calling user's upcoming events (Canvas's curated next-7-days view).",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('whats-on'),
     }, async () => {
         const data = await client.request('/api/v1/users/self/upcoming_events');
         return textContent(data);

package/dist/tools/conversations.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { buildPath } from './_shared.js';
+import { buildPath, schoolMeta } from './_shared.js';
 import { viewArg, viewResponse } from '../view.js';
 const listArgs = z.object({
     scope: z.enum(['unread', 'starred', 'archived', 'sent']).optional(),
@@ -14,6 +14,7 @@ export function registerConversationTools(server, client) {
     server.registerTool('canvas_list_conversations', {
         description: "List Canvas inbox conversations. Optional `scope` (unread/starred/archived/sent) and `filter` (array of context codes).",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: listArgs,
     }, async (rawArgs) => {
         const args = listArgs.parse(rawArgs);
@@ -28,6 +29,7 @@ export function registerConversationTools(server, client) {
     server.registerTool('canvas_get_conversation', {
         description: 'Get a full Canvas conversation thread with all messages. Read-only: does not mark the conversation as read.',
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: getArgs,
     }, async (rawArgs) => {
         const args = getArgs.parse(rawArgs);

package/dist/tools/courses.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, buildPath, userSegment } from './_shared.js';
+import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
 import { viewArg, viewResponse } from '../view.js';
 const listArgs = z.object({
     observeeId: z.string().optional().describe("Observed student's user ID; omit for self."),
@@ -12,6 +12,7 @@ export function registerCourseTools(server, client) {
     server.registerTool('canvas_list_courses', {
         description: 'List active Canvas courses (with course-level grades, total scores, current grading period scores, and term).',
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: listArgs,
     }, async (rawArgs) => {
         const args = listArgs.parse(rawArgs);
@@ -26,6 +27,7 @@ export function registerCourseTools(server, client) {
     server.registerTool('canvas_get_course', {
         description: 'Get a single Canvas course with its syllabus, teachers, and term.',
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: getArgs,
     }, async (rawArgs) => {
         const args = getArgs.parse(rawArgs);

package/dist/tools/discussions.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { buildPath } from './_shared.js';
+import { buildPath, schoolMeta } from './_shared.js';
 import { viewArg, viewResponse } from '../view.js';
 const argsSchema = z.object({
     courseId: z.string(),
@@ -11,6 +11,7 @@ export function registerDiscussionTools(server, client) {
     server.registerTool('canvas_list_discussion_topics', {
         description: 'List discussion topics for a course (read-only).',
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: argsSchema,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);

package/dist/tools/files.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, buildPath } from './_shared.js';
+import { textContent, buildPath, schoolMeta } from './_shared.js';
 const listArgs = z.object({
     courseId: z.string(),
     searchTerm: z.string().optional(),
@@ -14,6 +14,7 @@ export function registerFileTools(server, client) {
     server.registerTool('canvas_list_course_files', {
         description: "List a course's files (metadata only — use canvas_download_file with the `url` field).",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: listArgs,
     }, async (rawArgs) => {
         const args = listArgs.parse(rawArgs);
@@ -27,6 +28,7 @@ export function registerFileTools(server, client) {
     server.registerTool('canvas_download_file', {
         description: "Download a Canvas file to disk. `url` is the absolute URL from canvas_list_course_files (only file URLs on the configured Canvas host are accepted); `destinationPath` is required and must be inside the download directory (CANVAS_OUTPUT_DIR, default ~/Downloads).",
         annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+        _meta: schoolMeta('other'),
         inputSchema: downloadArgs,
     }, async (rawArgs) => {
         const args = downloadArgs.parse(rawArgs);

package/dist/tools/grades.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { textContent, buildPath, userSegment } from './_shared.js';
+import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
 const argsSchema = z.object({
     observeeId: z.string().optional(),
 });
@@ -7,6 +7,7 @@ export function registerGradeTools(server, client) {
     server.registerTool('canvas_list_enrollments', {
         description: 'List active student enrollments with per-course grades (current_score, final_score, current_grade, final_grade, current grading period info).',
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: argsSchema,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);

package/dist/tools/observees.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { viewArg, viewResponse } from '../view.js';
+import { schoolMeta } from './_shared.js';
 const argsSchema = z.object({
     view: viewArg(),
 });
@@ -7,6 +8,7 @@ export function registerObserveeTools(server, client) {
     server.registerTool('canvas_list_observees', {
         description: "List students linked to your Canvas observer account. Returns an empty array for plain student tokens.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: argsSchema,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);
@@ -14,3 +16,72 @@ export function registerObserveeTools(server, client) {
         return viewResponse(args.view, data);
     });
 }
+/** Bound on the start-time listing: a host must not wait on it to list tools. */
+export const OBSERVEE_LIST_TIMEOUT_MS = 5_000;
+function readObservees(data) {
+    if (!Array.isArray(data))
+        return [];
+    const out = [];
+    for (const row of data) {
+        if (!row || typeof row !== 'object')
+            continue;
+        const r = row;
+        if (typeof r.id !== 'string' && typeof r.id !== 'number')
+            continue;
+        const id = String(r.id);
+        const name = [r.name, r.short_name].find((v) => typeof v === 'string' && v.trim() !== '');
+        out.push({ id, label: name?.trim() ?? id });
+    }
+    return out;
+}
+function buildDirectory(users) {
+    if (users.length === 0)
+        return null;
+    const counts = new Map();
+    for (const u of users)
+        counts.set(u.label.toLowerCase(), (counts.get(u.label.toLowerCase()) ?? 0) + 1);
+    // Two children with one display name would make the name ambiguous, so each
+    // carries its id; the label stays resolvable and never picks the wrong child.
+    const labelled = users.map((u) => ({
+        id: u.id,
+        label: counts.get(u.label.toLowerCase()) > 1 ? `${u.label} (${u.id})` : u.label,
+    }));
+    const byLabel = new Map(labelled.map((u) => [u.label.toLowerCase(), u.id]));
+    const ids = new Set(labelled.map((u) => u.id));
+    const labels = labelled.map((u) => u.label);
+    return {
+        labels,
+        resolve(value) {
+            const id = byLabel.get(value.trim().toLowerCase());
+            if (id !== undefined)
+                return id;
+            if (ids.has(value.trim()))
+                return value.trim();
+            throw new Error(`Unknown observee "${value}". Known: ${labels.join(', ')}.`);
+        },
+    };
+}
+/**
+ * List the observees ONCE, at server start, for the planner's `observeeId`
+ * enum. Answers null — so the property is published with no `enum` keyword,
+ * never an empty one — when the account observes nobody, when the listing
+ * fails (no browser for the fetchproxy path, a dead credential), or when it has
+ * not answered within `timeoutMs`. Never throws.
+ */
+export async function loadObserveeDirectory(client, timeoutMs = OBSERVEE_LIST_TIMEOUT_MS) {
+    let timer;
+    const deadline = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(null), timeoutMs);
+        timer.unref();
+    });
+    const listing = client
+        .requestPaginated('/api/v1/users/self/observees')
+        .then((data) => buildDirectory(readObservees(data)))
+        .catch(() => null);
+    try {
+        return await Promise.race([listing, deadline]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/dist/tools/planner.js

@@ -1,21 +1,72 @@
 import { z } from 'zod';
-import { textContent, buildPath } from './_shared.js';
-const argsSchema = z.object({
-    observeeId: z.string().optional(),
-    startDate: z.string().optional(),
-    endDate: z.string().optional(),
-    contextCodes: z.array(z.string()).optional(),
-    filter: z.enum(['new_activity']).optional(),
-});
-export function registerPlannerTools(server, client) {
+import { textContent, buildPath, schoolMeta } from './_shared.js';
+const OBSERVEE_DESCRIPTION = "A linked observee (child): their display name as listed, or their Canvas user id. Omit for your own planner.";
+/**
+ * `observeeId` publishes the observee LABELS as a JSON Schema `enum` when the
+ * server could list them at start (mcp-host spec D5), via `.meta()` — so the
+ * runtime schema is still any string and the handler accepts a label or an id.
+ * With no listing the property is published plain: an empty `enum` is invalid
+ * JSON Schema.
+ */
+function observeeIdArg(observees) {
+    const base = z.string();
+    return (observees ? base.meta({ enum: observees.labels }) : base).optional().describe(OBSERVEE_DESCRIPTION);
+}
+const BRIEF_MAX = 120;
+function str(v) {
+    return typeof v === 'string' && v.trim() !== '' ? v.trim() : undefined;
+}
+/**
+ * One planner item as one line, `title — due <ISO date | no date> — <status>`,
+ * at most 120 characters (the title is shortened). Read only from the fields
+ * Canvas's planner item carries: `plannable.title`/`name`, `plannable.due_at`
+ * (else `plannable_date`), and `submissions`. An item with no submission at
+ * all (`submissions: false` — a note, a page, an event) gets no status, since
+ * "not submitted" would be untrue of something nobody submits.
+ */
+export function briefLine(item) {
+    const it = (item && typeof item === 'object' ? item : {});
+    const p = (it.plannable && typeof it.plannable === 'object' ? it.plannable : {});
+    const title = str(p.title) ?? str(p.name) ?? str(it.title) ?? '(untitled)';
+    const due = str(p.due_at) ?? str(it.plannable_date) ?? 'no date';
+    const sub = it.submissions;
+    let status = '';
+    if (sub && typeof sub === 'object') {
+        const s = sub;
+        status = s.missing === true ? 'missing' : s.submitted === true ? 'submitted' : 'not submitted';
+    }
+    const tail = ` — due ${due}${status ? ` — ${status}` : ''}`;
+    const room = BRIEF_MAX - tail.length;
+    const shown = title.length > room ? `${title.slice(0, Math.max(room - 1, 0))}…` : title;
+    return `${shown}${tail}`;
+}
+export function registerPlannerTools(server, client, observees) {
+    const argsSchema = z.object({
+        observeeId: observeeIdArg(observees),
+        startDate: z.string().optional(),
+        endDate: z.string().optional(),
+        contextCodes: z.array(z.string()).optional(),
+        filter: z.enum(['new_activity']).optional(),
+        view: z.enum(['full', 'brief']).optional().describe('"full" (default) returns Canvas\'s planner items verbatim; "brief" returns one line per item: ' +
+            'title — due <ISO date or "no date"> — <submitted|not submitted|missing>.'),
+    });
     server.registerTool('canvas_list_planner_items', {
         description: "List planner items (assignments + announcements + planner notes + calendar events) for the user or a linked observee.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('whats-due', {
+            canonical: true,
+            subject: 'observeeId',
+            when: { start: 'startDate', end: 'endDate' },
+            aliases: ['homework', 'assignments', 'due', 'kids', 'school'],
+        }),
         inputSchema: argsSchema,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);
-        const base = args.observeeId
-            ? `/api/v1/users/${encodeURIComponent(args.observeeId)}/planner/items`
+        const observeeId = args.observeeId !== undefined && observees
+            ? observees.resolve(args.observeeId)
+            : args.observeeId;
+        const base = observeeId
+            ? `/api/v1/users/${encodeURIComponent(observeeId)}/planner/items`
             : '/api/v1/planner/items';
         const path = buildPath(base, {
             start_date: args.startDate,
@@ -24,6 +75,9 @@ export function registerPlannerTools(server, client) {
             filter: args.filter,
         });
         const data = await client.requestPaginated(path);
+        if (args.view === 'brief') {
+            return { content: [{ type: 'text', text: data.map(briefLine).join('\n') }] };
+        }
         return textContent(data);
     });
 }

package/dist/tools/profile.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { schoolMeta } from './_shared.js';
 import { viewArg, viewResponse } from '../view.js';
 const argsSchema = z.object({
     view: viewArg(),
@@ -7,6 +8,7 @@ export function registerProfileTools(server, client) {
     server.registerTool('canvas_get_profile', {
         description: "Get the logged-in user's Canvas profile (id, name, primary_email, login_id, locale, time_zone). Useful first call to confirm credentials.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: argsSchema,
     }, async (rawArgs) => {
         const args = argsSchema.parse(rawArgs);

package/dist/tools/submissions.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { buildPath } from './_shared.js';
+import { buildPath, schoolMeta } from './_shared.js';
 import { viewArg, viewResponse } from '../view.js';
 const getArgs = z.object({
     courseId: z.string(),
@@ -17,6 +17,7 @@ export function registerSubmissionTools(server, client) {
     server.registerTool('canvas_get_submission', {
         description: "Get a single submission with rubric assessment and grader comments. userId defaults to 'self'.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: getArgs,
     }, async (rawArgs) => {
         const args = getArgs.parse(rawArgs);
@@ -28,6 +29,7 @@ export function registerSubmissionTools(server, client) {
     server.registerTool('canvas_list_recent_submissions', {
         description: "List recently graded submissions in a course. Defaults to a 14-day window for the calling user.",
         annotations: { readOnlyHint: true, openWorldHint: true },
+        _meta: schoolMeta('lookup'),
         inputSchema: recentArgs,
     }, async (rawArgs) => {
         const args = recentArgs.parse(rawArgs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "canvas-parent-mcp",
-  "version": "2.1.11",
+  "version": "2.2.0",
   "mcpName": "io.github.chrischall/canvas-parent-mcp",
   "description": "Canvas LMS (Instructure) MCP server — student/observer read access with optional file download",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

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