canvas-parent-mcp 2.1.10 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -11,7 +11,7 @@ import { resolveAuth } from './auth.js';
11
11
  import { registerHealthcheckTools } from './tools/healthcheck.js';
12
12
  import { CanvasClient } from './client.js';
13
13
  import { registerProfileTools } from './tools/profile.js';
14
- import { registerObserveeTools } from './tools/observees.js';
14
+ import { registerObserveeTools, loadObserveeDirectory } from './tools/observees.js';
15
15
  import { registerCourseTools } from './tools/courses.js';
16
16
  import { registerAssignmentTools } from './tools/assignments.js';
17
17
  import { registerSubmissionTools } from './tools/submissions.js';
@@ -46,6 +46,11 @@ catch (e) {
46
46
  const client = resolved
47
47
  ? new CanvasClient(resolved.account, { refreshSession: resolved.refresh })
48
48
  : null;
49
+ // The planner's `observeeId` publishes the observees' display names as an
50
+ // enum (context groups, mcp-host spec 2026-11-03 D5), so list them ONCE here —
51
+ // registrars run per served instance — bounded by OBSERVEE_LIST_TIMEOUT_MS.
52
+ // Null (failure, timeout, nobody observed) publishes the property with no enum.
53
+ const observees = client ? await loadObserveeDirectory(client) : null;
49
54
  // `runMcp` (from @chrischall/mcp-utils) builds the McpServer, runs the
50
55
  // registrar, then connects the stdio transport and installs SIGINT/SIGTERM
51
56
  // shutdown handlers. The deferred-config-error pattern is preserved by
@@ -54,7 +59,7 @@ const client = resolved
54
59
  // host's install-time `tools/list` succeeds.
55
60
  await runMcp({
56
61
  name: 'canvas',
57
- version: '2.1.10', // x-release-please-version
62
+ version: '2.2.0', // x-release-please-version
58
63
  tools: [
59
64
  // Outside the `if (resolved)` on purpose: an unconfigured server must
60
65
  // still expose something that can say WHY (see the tool's docblock).
@@ -68,7 +73,7 @@ await runMcp({
68
73
  registerSubmissionTools(server, client);
69
74
  registerGradeTools(server, client);
70
75
  registerCalendarTools(server, client);
71
- registerPlannerTools(server, client);
76
+ registerPlannerTools(server, client, observees);
72
77
  registerAnnouncementTools(server, client);
73
78
  registerConversationTools(server, client);
74
79
  registerDiscussionTools(server, client);
@@ -29,3 +29,7 @@ export function buildPath(base, params = {}) {
29
29
  export function userSegment(observeeId) {
30
30
  return observeeId ? `users/${encodeURIComponent(observeeId)}` : 'users/self';
31
31
  }
32
+ /** `_meta` for a Canvas tool: every tool here is in the `school` domain. */
33
+ export function schoolMeta(intent, extra = {}) {
34
+ return { mint: { domain: 'school', intent, ...extra } };
35
+ }
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { buildPath } from './_shared.js';
2
+ import { buildPath, schoolMeta } from './_shared.js';
3
3
  import { viewArg, viewResponse } from '../view.js';
4
4
  const argsSchema = z.object({
5
5
  contextCodes: z.array(z.string()).describe('Required. Array like ["course_123", "course_456"].'),
@@ -12,6 +12,7 @@ export function registerAnnouncementTools(server, client) {
12
12
  server.registerTool('canvas_list_announcements', {
13
13
  description: "List announcements across one or more courses. `contextCodes` is required (e.g. [\"course_123\"]). Defaults to active-only.",
14
14
  annotations: { readOnlyHint: true, openWorldHint: true },
15
+ _meta: schoolMeta('whats-new', { canonical: true, aliases: ['teacher', 'announcements', 'news'] }),
15
16
  inputSchema: argsSchema,
16
17
  }, async (rawArgs) => {
17
18
  const args = argsSchema.parse(rawArgs);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { textContent, buildPath, userSegment } from './_shared.js';
2
+ import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
3
3
  const listArgs = z.object({
4
4
  courseId: z.string(),
5
5
  bucket: z.enum(['past', 'overdue', 'undated', 'ungraded', 'unsubmitted', 'upcoming', 'future']).optional()
@@ -11,8 +11,9 @@ const missingArgs = z.object({
11
11
  });
12
12
  export function registerAssignmentTools(server, client) {
13
13
  server.registerTool('canvas_list_assignments', {
14
- description: "List a course's assignments (with the user's submission inline). Supports the standard Canvas `bucket` filter.",
14
+ 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.",
15
15
  annotations: { readOnlyHint: true, openWorldHint: true },
16
+ _meta: schoolMeta('lookup'),
16
17
  inputSchema: listArgs,
17
18
  }, async (rawArgs) => {
18
19
  const args = listArgs.parse(rawArgs);
@@ -25,8 +26,9 @@ export function registerAssignmentTools(server, client) {
25
26
  return textContent(data);
26
27
  });
27
28
  server.registerTool('canvas_list_missing_submissions', {
28
- description: "List past-due unsubmitted assignments for the user (or a linked observee). For an observee, courseIds is required.",
29
+ 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.",
29
30
  annotations: { readOnlyHint: true, openWorldHint: true },
31
+ _meta: schoolMeta('whats-due'),
30
32
  inputSchema: missingArgs,
31
33
  }, async (rawArgs) => {
32
34
  const args = missingArgs.parse(rawArgs);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { textContent, buildPath } from './_shared.js';
2
+ import { textContent, buildPath, schoolMeta } from './_shared.js';
3
3
  const eventsArgs = z.object({
4
4
  contextCodes: z.array(z.string()).optional().describe('Array like ["course_123", "user_456"].'),
5
5
  type: z.enum(['event', 'assignment']).optional(),
@@ -11,6 +11,7 @@ export function registerCalendarTools(server, client) {
11
11
  server.registerTool('canvas_list_calendar_events', {
12
12
  description: 'List Canvas calendar events or assignments across selected contexts (courses/users).',
13
13
  annotations: { readOnlyHint: true, openWorldHint: true },
14
+ _meta: schoolMeta('whats-on'),
14
15
  inputSchema: eventsArgs,
15
16
  }, async (rawArgs) => {
16
17
  const args = eventsArgs.parse(rawArgs);
@@ -27,6 +28,7 @@ export function registerCalendarTools(server, client) {
27
28
  server.registerTool('canvas_list_upcoming_events', {
28
29
  description: "List the calling user's upcoming events (Canvas's curated next-7-days view).",
29
30
  annotations: { readOnlyHint: true, openWorldHint: true },
31
+ _meta: schoolMeta('whats-on'),
30
32
  }, async () => {
31
33
  const data = await client.request('/api/v1/users/self/upcoming_events');
32
34
  return textContent(data);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { buildPath } from './_shared.js';
2
+ import { buildPath, schoolMeta } from './_shared.js';
3
3
  import { viewArg, viewResponse } from '../view.js';
4
4
  const listArgs = z.object({
5
5
  scope: z.enum(['unread', 'starred', 'archived', 'sent']).optional(),
@@ -14,6 +14,7 @@ export function registerConversationTools(server, client) {
14
14
  server.registerTool('canvas_list_conversations', {
15
15
  description: "List Canvas inbox conversations. Optional `scope` (unread/starred/archived/sent) and `filter` (array of context codes).",
16
16
  annotations: { readOnlyHint: true, openWorldHint: true },
17
+ _meta: schoolMeta('lookup'),
17
18
  inputSchema: listArgs,
18
19
  }, async (rawArgs) => {
19
20
  const args = listArgs.parse(rawArgs);
@@ -28,6 +29,7 @@ export function registerConversationTools(server, client) {
28
29
  server.registerTool('canvas_get_conversation', {
29
30
  description: 'Get a full Canvas conversation thread with all messages. Read-only: does not mark the conversation as read.',
30
31
  annotations: { readOnlyHint: true, openWorldHint: true },
32
+ _meta: schoolMeta('lookup'),
31
33
  inputSchema: getArgs,
32
34
  }, async (rawArgs) => {
33
35
  const args = getArgs.parse(rawArgs);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { textContent, buildPath, userSegment } from './_shared.js';
2
+ import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
3
3
  import { viewArg, viewResponse } from '../view.js';
4
4
  const listArgs = z.object({
5
5
  observeeId: z.string().optional().describe("Observed student's user ID; omit for self."),
@@ -12,6 +12,7 @@ export function registerCourseTools(server, client) {
12
12
  server.registerTool('canvas_list_courses', {
13
13
  description: 'List active Canvas courses (with course-level grades, total scores, current grading period scores, and term).',
14
14
  annotations: { readOnlyHint: true, openWorldHint: true },
15
+ _meta: schoolMeta('lookup'),
15
16
  inputSchema: listArgs,
16
17
  }, async (rawArgs) => {
17
18
  const args = listArgs.parse(rawArgs);
@@ -26,6 +27,7 @@ export function registerCourseTools(server, client) {
26
27
  server.registerTool('canvas_get_course', {
27
28
  description: 'Get a single Canvas course with its syllabus, teachers, and term.',
28
29
  annotations: { readOnlyHint: true, openWorldHint: true },
30
+ _meta: schoolMeta('lookup'),
29
31
  inputSchema: getArgs,
30
32
  }, async (rawArgs) => {
31
33
  const args = getArgs.parse(rawArgs);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { buildPath } from './_shared.js';
2
+ import { buildPath, schoolMeta } from './_shared.js';
3
3
  import { viewArg, viewResponse } from '../view.js';
4
4
  const argsSchema = z.object({
5
5
  courseId: z.string(),
@@ -11,6 +11,7 @@ export function registerDiscussionTools(server, client) {
11
11
  server.registerTool('canvas_list_discussion_topics', {
12
12
  description: 'List discussion topics for a course (read-only).',
13
13
  annotations: { readOnlyHint: true, openWorldHint: true },
14
+ _meta: schoolMeta('lookup'),
14
15
  inputSchema: argsSchema,
15
16
  }, async (rawArgs) => {
16
17
  const args = argsSchema.parse(rawArgs);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { textContent, buildPath } from './_shared.js';
2
+ import { textContent, buildPath, schoolMeta } from './_shared.js';
3
3
  const listArgs = z.object({
4
4
  courseId: z.string(),
5
5
  searchTerm: z.string().optional(),
@@ -14,6 +14,7 @@ export function registerFileTools(server, client) {
14
14
  server.registerTool('canvas_list_course_files', {
15
15
  description: "List a course's files (metadata only — use canvas_download_file with the `url` field).",
16
16
  annotations: { readOnlyHint: true, openWorldHint: true },
17
+ _meta: schoolMeta('lookup'),
17
18
  inputSchema: listArgs,
18
19
  }, async (rawArgs) => {
19
20
  const args = listArgs.parse(rawArgs);
@@ -27,6 +28,7 @@ export function registerFileTools(server, client) {
27
28
  server.registerTool('canvas_download_file', {
28
29
  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).",
29
30
  annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
31
+ _meta: schoolMeta('other'),
30
32
  inputSchema: downloadArgs,
31
33
  }, async (rawArgs) => {
32
34
  const args = downloadArgs.parse(rawArgs);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { textContent, buildPath, userSegment } from './_shared.js';
2
+ import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
3
3
  const argsSchema = z.object({
4
4
  observeeId: z.string().optional(),
5
5
  });
@@ -7,6 +7,7 @@ export function registerGradeTools(server, client) {
7
7
  server.registerTool('canvas_list_enrollments', {
8
8
  description: 'List active student enrollments with per-course grades (current_score, final_score, current_grade, final_grade, current grading period info).',
9
9
  annotations: { readOnlyHint: true, openWorldHint: true },
10
+ _meta: schoolMeta('lookup'),
10
11
  inputSchema: argsSchema,
11
12
  }, async (rawArgs) => {
12
13
  const args = argsSchema.parse(rawArgs);
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { viewArg, viewResponse } from '../view.js';
3
+ import { schoolMeta } from './_shared.js';
3
4
  const argsSchema = z.object({
4
5
  view: viewArg(),
5
6
  });
@@ -7,6 +8,7 @@ export function registerObserveeTools(server, client) {
7
8
  server.registerTool('canvas_list_observees', {
8
9
  description: "List students linked to your Canvas observer account. Returns an empty array for plain student tokens.",
9
10
  annotations: { readOnlyHint: true, openWorldHint: true },
11
+ _meta: schoolMeta('lookup'),
10
12
  inputSchema: argsSchema,
11
13
  }, async (rawArgs) => {
12
14
  const args = argsSchema.parse(rawArgs);
@@ -14,3 +16,72 @@ export function registerObserveeTools(server, client) {
14
16
  return viewResponse(args.view, data);
15
17
  });
16
18
  }
19
+ /** Bound on the start-time listing: a host must not wait on it to list tools. */
20
+ export const OBSERVEE_LIST_TIMEOUT_MS = 5_000;
21
+ function readObservees(data) {
22
+ if (!Array.isArray(data))
23
+ return [];
24
+ const out = [];
25
+ for (const row of data) {
26
+ if (!row || typeof row !== 'object')
27
+ continue;
28
+ const r = row;
29
+ if (typeof r.id !== 'string' && typeof r.id !== 'number')
30
+ continue;
31
+ const id = String(r.id);
32
+ const name = [r.name, r.short_name].find((v) => typeof v === 'string' && v.trim() !== '');
33
+ out.push({ id, label: name?.trim() ?? id });
34
+ }
35
+ return out;
36
+ }
37
+ function buildDirectory(users) {
38
+ if (users.length === 0)
39
+ return null;
40
+ const counts = new Map();
41
+ for (const u of users)
42
+ counts.set(u.label.toLowerCase(), (counts.get(u.label.toLowerCase()) ?? 0) + 1);
43
+ // Two children with one display name would make the name ambiguous, so each
44
+ // carries its id; the label stays resolvable and never picks the wrong child.
45
+ const labelled = users.map((u) => ({
46
+ id: u.id,
47
+ label: counts.get(u.label.toLowerCase()) > 1 ? `${u.label} (${u.id})` : u.label,
48
+ }));
49
+ const byLabel = new Map(labelled.map((u) => [u.label.toLowerCase(), u.id]));
50
+ const ids = new Set(labelled.map((u) => u.id));
51
+ const labels = labelled.map((u) => u.label);
52
+ return {
53
+ labels,
54
+ resolve(value) {
55
+ const id = byLabel.get(value.trim().toLowerCase());
56
+ if (id !== undefined)
57
+ return id;
58
+ if (ids.has(value.trim()))
59
+ return value.trim();
60
+ throw new Error(`Unknown observee "${value}". Known: ${labels.join(', ')}.`);
61
+ },
62
+ };
63
+ }
64
+ /**
65
+ * List the observees ONCE, at server start, for the planner's `observeeId`
66
+ * enum. Answers null — so the property is published with no `enum` keyword,
67
+ * never an empty one — when the account observes nobody, when the listing
68
+ * fails (no browser for the fetchproxy path, a dead credential), or when it has
69
+ * not answered within `timeoutMs`. Never throws.
70
+ */
71
+ export async function loadObserveeDirectory(client, timeoutMs = OBSERVEE_LIST_TIMEOUT_MS) {
72
+ let timer;
73
+ const deadline = new Promise((resolve) => {
74
+ timer = setTimeout(() => resolve(null), timeoutMs);
75
+ timer.unref();
76
+ });
77
+ const listing = client
78
+ .requestPaginated('/api/v1/users/self/observees')
79
+ .then((data) => buildDirectory(readObservees(data)))
80
+ .catch(() => null);
81
+ try {
82
+ return await Promise.race([listing, deadline]);
83
+ }
84
+ finally {
85
+ clearTimeout(timer);
86
+ }
87
+ }
@@ -1,21 +1,72 @@
1
1
  import { z } from 'zod';
2
- import { textContent, buildPath } from './_shared.js';
3
- const argsSchema = z.object({
4
- observeeId: z.string().optional(),
5
- startDate: z.string().optional(),
6
- endDate: z.string().optional(),
7
- contextCodes: z.array(z.string()).optional(),
8
- filter: z.enum(['new_activity']).optional(),
9
- });
10
- export function registerPlannerTools(server, client) {
2
+ import { textContent, buildPath, schoolMeta } from './_shared.js';
3
+ const OBSERVEE_DESCRIPTION = "A linked observee (child): their display name as listed, or their Canvas user id. Omit for your own planner.";
4
+ /**
5
+ * `observeeId` publishes the observee LABELS as a JSON Schema `enum` when the
6
+ * server could list them at start (mcp-host spec D5), via `.meta()` — so the
7
+ * runtime schema is still any string and the handler accepts a label or an id.
8
+ * With no listing the property is published plain: an empty `enum` is invalid
9
+ * JSON Schema.
10
+ */
11
+ function observeeIdArg(observees) {
12
+ const base = z.string();
13
+ return (observees ? base.meta({ enum: observees.labels }) : base).optional().describe(OBSERVEE_DESCRIPTION);
14
+ }
15
+ const BRIEF_MAX = 120;
16
+ function str(v) {
17
+ return typeof v === 'string' && v.trim() !== '' ? v.trim() : undefined;
18
+ }
19
+ /**
20
+ * One planner item as one line, `title — due <ISO date | no date> — <status>`,
21
+ * at most 120 characters (the title is shortened). Read only from the fields
22
+ * Canvas's planner item carries: `plannable.title`/`name`, `plannable.due_at`
23
+ * (else `plannable_date`), and `submissions`. An item with no submission at
24
+ * all (`submissions: false` — a note, a page, an event) gets no status, since
25
+ * "not submitted" would be untrue of something nobody submits.
26
+ */
27
+ export function briefLine(item) {
28
+ const it = (item && typeof item === 'object' ? item : {});
29
+ const p = (it.plannable && typeof it.plannable === 'object' ? it.plannable : {});
30
+ const title = str(p.title) ?? str(p.name) ?? str(it.title) ?? '(untitled)';
31
+ const due = str(p.due_at) ?? str(it.plannable_date) ?? 'no date';
32
+ const sub = it.submissions;
33
+ let status = '';
34
+ if (sub && typeof sub === 'object') {
35
+ const s = sub;
36
+ status = s.missing === true ? 'missing' : s.submitted === true ? 'submitted' : 'not submitted';
37
+ }
38
+ const tail = ` — due ${due}${status ? ` — ${status}` : ''}`;
39
+ const room = BRIEF_MAX - tail.length;
40
+ const shown = title.length > room ? `${title.slice(0, Math.max(room - 1, 0))}…` : title;
41
+ return `${shown}${tail}`;
42
+ }
43
+ export function registerPlannerTools(server, client, observees) {
44
+ const argsSchema = z.object({
45
+ observeeId: observeeIdArg(observees),
46
+ startDate: z.string().optional(),
47
+ endDate: z.string().optional(),
48
+ contextCodes: z.array(z.string()).optional(),
49
+ filter: z.enum(['new_activity']).optional(),
50
+ view: z.enum(['full', 'brief']).optional().describe('"full" (default) returns Canvas\'s planner items verbatim; "brief" returns one line per item: ' +
51
+ 'title — due <ISO date or "no date"> — <submitted|not submitted|missing>.'),
52
+ });
11
53
  server.registerTool('canvas_list_planner_items', {
12
54
  description: "List planner items (assignments + announcements + planner notes + calendar events) for the user or a linked observee.",
13
55
  annotations: { readOnlyHint: true, openWorldHint: true },
56
+ _meta: schoolMeta('whats-due', {
57
+ canonical: true,
58
+ subject: 'observeeId',
59
+ when: { start: 'startDate', end: 'endDate' },
60
+ aliases: ['homework', 'assignments', 'due', 'kids', 'school'],
61
+ }),
14
62
  inputSchema: argsSchema,
15
63
  }, async (rawArgs) => {
16
64
  const args = argsSchema.parse(rawArgs);
17
- const base = args.observeeId
18
- ? `/api/v1/users/${encodeURIComponent(args.observeeId)}/planner/items`
65
+ const observeeId = args.observeeId !== undefined && observees
66
+ ? observees.resolve(args.observeeId)
67
+ : args.observeeId;
68
+ const base = observeeId
69
+ ? `/api/v1/users/${encodeURIComponent(observeeId)}/planner/items`
19
70
  : '/api/v1/planner/items';
20
71
  const path = buildPath(base, {
21
72
  start_date: args.startDate,
@@ -24,6 +75,9 @@ export function registerPlannerTools(server, client) {
24
75
  filter: args.filter,
25
76
  });
26
77
  const data = await client.requestPaginated(path);
78
+ if (args.view === 'brief') {
79
+ return { content: [{ type: 'text', text: data.map(briefLine).join('\n') }] };
80
+ }
27
81
  return textContent(data);
28
82
  });
29
83
  }
@@ -1,4 +1,5 @@
1
1
  import { z } from 'zod';
2
+ import { schoolMeta } from './_shared.js';
2
3
  import { viewArg, viewResponse } from '../view.js';
3
4
  const argsSchema = z.object({
4
5
  view: viewArg(),
@@ -7,6 +8,7 @@ export function registerProfileTools(server, client) {
7
8
  server.registerTool('canvas_get_profile', {
8
9
  description: "Get the logged-in user's Canvas profile (id, name, primary_email, login_id, locale, time_zone). Useful first call to confirm credentials.",
9
10
  annotations: { readOnlyHint: true, openWorldHint: true },
11
+ _meta: schoolMeta('lookup'),
10
12
  inputSchema: argsSchema,
11
13
  }, async (rawArgs) => {
12
14
  const args = argsSchema.parse(rawArgs);
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { buildPath } from './_shared.js';
2
+ import { buildPath, schoolMeta } from './_shared.js';
3
3
  import { viewArg, viewResponse } from '../view.js';
4
4
  const getArgs = z.object({
5
5
  courseId: z.string(),
@@ -17,6 +17,7 @@ export function registerSubmissionTools(server, client) {
17
17
  server.registerTool('canvas_get_submission', {
18
18
  description: "Get a single submission with rubric assessment and grader comments. userId defaults to 'self'.",
19
19
  annotations: { readOnlyHint: true, openWorldHint: true },
20
+ _meta: schoolMeta('lookup'),
20
21
  inputSchema: getArgs,
21
22
  }, async (rawArgs) => {
22
23
  const args = getArgs.parse(rawArgs);
@@ -28,6 +29,7 @@ export function registerSubmissionTools(server, client) {
28
29
  server.registerTool('canvas_list_recent_submissions', {
29
30
  description: "List recently graded submissions in a course. Defaults to a 14-day window for the calling user.",
30
31
  annotations: { readOnlyHint: true, openWorldHint: true },
32
+ _meta: schoolMeta('lookup'),
31
33
  inputSchema: recentArgs,
32
34
  }, async (rawArgs) => {
33
35
  const args = recentArgs.parse(rawArgs);
package/mint.yaml CHANGED
@@ -2,10 +2,15 @@ version: 1
2
2
  name: Canvas Parent
3
3
  slug: canvas-parent
4
4
  summary: >-
5
- Canvas LMS courses, assignments, grades and messages for a parent/observer.
6
- The package ships TWO bins, so command.bin below is required — without it the
7
- install refuses. A token or OAuth registration hosts on any tier; the
8
- username/password and bridge paths need a browser and do not.
5
+ Canvas LMS courses, assignments, grades, announcements, calendar and messages
6
+ for a parent/observer. Signs in with a token, OAuth or password; the
7
+ browser-bridge fallback needs a signed-in browser.
8
+ examples:
9
+ - prompt: Which assignments are missing or past due for my kids on Canvas right now?
10
+ note: Uses the observee list, then missing submissions per course.
11
+ - prompt: What are my child's current grades in each Canvas course?
12
+ - prompt: What's due on Canvas in the next two weeks, and are there any new teacher announcements?
13
+ note: Combines planner items with recent course announcements.
9
14
  command:
10
15
  # REQUIRED: package.json declares canvas-parent-mcp (the server) and
11
16
  # canvas-parent-mcp-qr-login (a local CLI). Without this the install refuses.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "canvas-parent-mcp",
3
- "version": "2.1.10",
3
+ "version": "2.2.0",
4
4
  "mcpName": "io.github.chrischall/canvas-parent-mcp",
5
5
  "description": "Canvas LMS (Instructure) MCP server — student/observer read access with optional file download",
6
6
  "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -61,5 +61,9 @@
61
61
  "esbuild": "^0.28.0",
62
62
  "typescript": "^7.0.2",
63
63
  "vitest": "^5.0.0"
64
+ },
65
+ "allowScripts": {
66
+ "esbuild": false,
67
+ "fsevents": false
64
68
  }
65
69
  }
package/server.json CHANGED
@@ -6,12 +6,12 @@
6
6
  "url": "https://github.com/chrischall/canvas-parent-mcp",
7
7
  "source": "github"
8
8
  },
9
- "version": "2.1.10",
9
+ "version": "2.2.0",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "identifier": "canvas-parent-mcp",
14
- "version": "2.1.10",
14
+ "version": "2.2.0",
15
15
  "transport": {
16
16
  "type": "stdio"
17
17
  },