@mtgibbs/canvas-lms-mcp 0.2.16 → 0.2.18

package/README.md

@@ -297,6 +297,34 @@ Once connected, Claude has access to these capabilities:
 | `get_stats`                | Late/missing statistics by course                              |
 | `get_todo`                 | Planner items and to-do list                                   |
 
+### Grading Period Filtering
+
+By default, all tools return data for the **current grading period only** (e.g., Semester 2). This
+matches what parents see in the Canvas portal and prevents showing old assignments from previous
+semesters.
+
+**Affected tools:**
+
+- `get_courses` - Grades are for the current grading period
+- `get_missing_assignments` - Only shows missing work from the current period
+- `get_unsubmitted_past_due` - Only shows unsubmitted work from the current period
+- `get_comprehensive_status` - All data filtered to the current period
+
+**To include all grading periods** (e.g., for a full-year view), use the `all_grading_periods`
+parameter:
+
+```
+"Show me all missing assignments including previous semesters"
+→ Claude will call get_missing_assignments with all_grading_periods: true
+```
+
+For the CLI, use the `--all-grading-periods` flag:
+
+```bash
+canvas missing --all-grading-periods
+canvas unsubmitted --all-grading-periods
+```
+
 ---
 
 ## Standalone CLI
@@ -335,18 +363,20 @@ canvas courses --format table
 canvas status
 canvas status --format table
 
-# List missing assignments
+# List missing assignments (current grading period by default)
 canvas missing
 canvas missing --summary              # Counts by course
 canvas missing --include-unsubmitted  # Include past-due not yet flagged
+canvas missing --all-grading-periods  # Include previous semesters
 
 # List assignments due soon
 canvas due --days 7
 canvas due --show-graded              # Include already-graded items
 
-# List unsubmitted past-due assignments
+# List unsubmitted past-due assignments (current grading period by default)
 canvas unsubmitted
 canvas unsubmitted --course-id 12345
+canvas unsubmitted --all-grading-periods  # Include previous semesters
 
 # List assignments with filters
 canvas assignments --all-courses --due-this-week

package/esm/src/api/calendar.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Canvas Calendar Events API
+ */
+import type { CalendarEvent } from "../types/canvas.js";
+export interface ListCalendarEventsOptions {
+    type?: "event" | "assignment";
+    context_codes?: string[];
+    start_date?: string;
+    end_date?: string;
+}
+/**
+ * List calendar events
+ * Uses GET /api/v1/calendar_events
+ */
+export declare function listCalendarEvents(options?: ListCalendarEventsOptions): Promise<CalendarEvent[]>;
+//# sourceMappingURL=calendar.d.ts.map

package/esm/src/api/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/src/api/calendar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,aAAa,EAAE,CAAC,CAmB1B"}

package/esm/src/api/calendar.js

@@ -0,0 +1,25 @@
+/**
+ * Canvas Calendar Events API
+ */
+import { getClient } from "./client.js";
+/**
+ * List calendar events
+ * Uses GET /api/v1/calendar_events
+ */
+export function listCalendarEvents(options = {}) {
+    const client = getClient();
+    const params = {};
+    if (options.type) {
+        params.type = options.type;
+    }
+    if (options.context_codes) {
+        params.context_codes = options.context_codes;
+    }
+    if (options.start_date) {
+        params.start_date = options.start_date;
+    }
+    if (options.end_date) {
+        params.end_date = options.end_date;
+    }
+    return client.getAll("/calendar_events", params);
+}

package/esm/src/api/courses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"courses.d.ts","sourceRoot":"","sources":["../../../src/src/api/courses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmB3E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAWnF;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA2B/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,UAAU,EAAE,CAAC,CAsBvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,GAAE,MAAM,GAAG,MAAe,GAC/B,OAAO,CAAC,CAAC,MAAM,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAAC,CAgG7E"}
+{"version":3,"file":"courses.d.ts","sourceRoot":"","sources":["../../../src/src/api/courses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmB3E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAWnF;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA2B/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,UAAU,EAAE,CAAC,CAsBvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,GAAE,MAAM,GAAG,MAAe,GAC/B,OAAO,CAAC,CAAC,MAAM,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAAC,CAkG7E"}

package/esm/src/api/discussions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Canvas Discussion Topics API
+ */
+import type { DiscussionTopic } from "../types/canvas.js";
+export interface ListDiscussionTopicsOptions {
+    course_id: number;
+    order_by?: "position" | "recent_activity" | "title";
+    per_page?: number;
+}
+/**
+ * List discussion topics for a course
+ * Uses GET /api/v1/courses/:course_id/discussion_topics
+ */
+export declare function listDiscussionTopics(options: ListDiscussionTopicsOptions): Promise<DiscussionTopic[]>;
+//# sourceMappingURL=discussions.d.ts.map

package/esm/src/api/discussions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussions.d.ts","sourceRoot":"","sources":["../../../src/src/api/discussions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,UAAU,GAAG,iBAAiB,GAAG,OAAO,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,eAAe,EAAE,CAAC,CAgB5B"}

package/esm/src/api/discussions.js

@@ -0,0 +1,19 @@
+/**
+ * Canvas Discussion Topics API
+ */
+import { getClient } from "./client.js";
+/**
+ * List discussion topics for a course
+ * Uses GET /api/v1/courses/:course_id/discussion_topics
+ */
+export function listDiscussionTopics(options) {
+    const client = getClient();
+    const params = {};
+    if (options.order_by) {
+        params.order_by = options.order_by;
+    }
+    if (options.per_page) {
+        params.per_page = options.per_page;
+    }
+    return client.getAll(`/courses/${options.course_id}/discussion_topics`, params);
+}

package/esm/src/api/observees.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Canvas Observees API
+ * For observer/parent accounts to list students they're observing
+ */
+import type { User } from "../types/canvas.js";
+/**
+ * List students being observed by the current user (parent/observer account)
+ * Uses GET /api/v1/users/self/observees
+ *
+ * @returns Array of User objects for each observed student
+ */
+export declare function listObservees(): Promise<User[]>;
+//# sourceMappingURL=observees.d.ts.map

package/esm/src/api/observees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observees.d.ts","sourceRoot":"","sources":["../../../src/src/api/observees.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAG/C"}

package/esm/src/api/observees.js

@@ -0,0 +1,15 @@
+/**
+ * Canvas Observees API
+ * For observer/parent accounts to list students they're observing
+ */
+import { getClient } from "./client.js";
+/**
+ * List students being observed by the current user (parent/observer account)
+ * Uses GET /api/v1/users/self/observees
+ *
+ * @returns Array of User objects for each observed student
+ */
+export function listObservees() {
+    const client = getClient();
+    return client.getAll("/users/self/observees");
+}

package/esm/src/api/people.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Canvas People API
+ * Get teachers and TAs for courses
+ */
+import type { User } from "../types/canvas.js";
+/**
+ * List users (teachers/TAs) in a course
+ * @param courseId - The course ID
+ * @param enrollmentTypes - Array of enrollment types to filter (e.g., ["teacher", "ta"])
+ * @returns Array of users with their enrollment information
+ */
+export declare function listCourseUsers(courseId: number, enrollmentTypes?: string[]): Promise<User[]>;
+//# sourceMappingURL=people.d.ts.map

package/esm/src/api/people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../../src/src/api/people.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,eAAe,GAAE,MAAM,EAAsB,GAC5C,OAAO,CAAC,IAAI,EAAE,CAAC,CASjB"}

package/esm/src/api/people.js

@@ -0,0 +1,19 @@
+/**
+ * Canvas People API
+ * Get teachers and TAs for courses
+ */
+import { getClient } from "./client.js";
+/**
+ * List users (teachers/TAs) in a course
+ * @param courseId - The course ID
+ * @param enrollmentTypes - Array of enrollment types to filter (e.g., ["teacher", "ta"])
+ * @returns Array of users with their enrollment information
+ */
+export function listCourseUsers(courseId, enrollmentTypes = ["teacher", "ta"]) {
+    const client = getClient();
+    const params = {
+        enrollment_type: enrollmentTypes,
+        include: ["email", "enrollments"],
+    };
+    return client.getAll(`/courses/${courseId}/users`, params);
+}

package/esm/src/mcp/tools/get-all-students-status.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Tool: get_all_students_status
+ *
+ * Returns comprehensive status for ALL observed students in a single call.
+ * Each student's data is clearly labeled to prevent mix-ups.
+ *
+ * CLI equivalent: `canvas status --all-students`
+ */
+import { z } from "zod";
+import { type ToolDefinition } from "../types.js";
+export declare const schema: {
+    days_upcoming: z.ZodOptional<z.ZodNumber>;
+    days_grades: z.ZodOptional<z.ZodNumber>;
+    low_grade_threshold: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getAllStudentsStatusTool: ToolDefinition<typeof schema>;
+//# sourceMappingURL=get-all-students-status.d.ts.map

package/esm/src/mcp/tools/get-all-students-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-all-students-status.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/get-all-students-status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,MAAM;;;;CAUlB,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,cAAc,CAAC,OAAO,MAAM,CAelE,CAAC"}

package/esm/src/mcp/tools/get-all-students-status.js

@@ -0,0 +1,30 @@
+/**
+ * MCP Tool: get_all_students_status
+ *
+ * Returns comprehensive status for ALL observed students in a single call.
+ * Each student's data is clearly labeled to prevent mix-ups.
+ *
+ * CLI equivalent: `canvas status --all-students`
+ */
+import { z } from "zod";
+import { getAllStudentsStatus } from "../../services/index.js";
+import { jsonResponse } from "../types.js";
+export const schema = {
+    days_upcoming: z.number().optional().describe("Days to look ahead for upcoming assignments (default: 7)"),
+    days_grades: z.number().optional().describe("Days to look back for recent grades (default: 7)"),
+    low_grade_threshold: z.number().optional().describe("Percentage threshold for flagging low grades (default: 70)"),
+};
+export const getAllStudentsStatusTool = {
+    name: "get_all_students_status",
+    description: "Get comprehensive academic status for ALL observed students in a single call. Use this tool when the user asks about ALL their students or wants a combined overview. Each student's data is clearly separated and labeled (student_name, student_id, status). NEVER mix data between students when presenting results. Returns an array of objects, each containing: student_name (string), student_id (number), and status (ComprehensiveStatus with courses, grades, missing work, upcoming assignments, recent low grades, and recent announcements).",
+    schema,
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    handler: async ({ days_upcoming, days_grades, low_grade_threshold }) => {
+        const result = await getAllStudentsStatus({
+            daysUpcoming: days_upcoming,
+            daysGrades: days_grades,
+            lowGradeThreshold: low_grade_threshold,
+        });
+        return jsonResponse(result);
+    },
+};

package/esm/src/mcp/tools/get-calendar-events.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tool: get_calendar_events
+ * Get non-assignment calendar events (office hours, review sessions, school events, field trips)
+ */
+import { z } from "zod";
+import { type ToolDefinition } from "../types.js";
+export declare const schema: {
+    student_id: z.ZodOptional<z.ZodString>;
+    days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    course_id: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getCalendarEventsTool: ToolDefinition<typeof schema>;
+//# sourceMappingURL=get-calendar-events.d.ts.map

package/esm/src/mcp/tools/get-calendar-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-calendar-events.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/get-calendar-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,MAAM;;;;CAgBlB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,OAAO,MAAM,CAiB/D,CAAC"}

package/esm/src/mcp/tools/get-calendar-events.js

@@ -0,0 +1,38 @@
+/**
+ * Tool: get_calendar_events
+ * Get non-assignment calendar events (office hours, review sessions, school events, field trips)
+ */
+import { z } from "zod";
+import { getCalendarEvents } from "../../services/index.js";
+import { getEffectiveStudentId } from "../../api/users.js";
+import { jsonResponse } from "../types.js";
+export const schema = {
+    student_id: z
+        .string()
+        .optional()
+        .describe("Student ID (uses configured CANVAS_STUDENT_ID if not provided)"),
+    days: z
+        .number()
+        .optional()
+        .default(14)
+        .describe("Number of days to look ahead for calendar events (default: 14)"),
+    course_id: z
+        .number()
+        .optional()
+        .describe("Filter to a specific course ID. Use 'get_courses' to find this ID from a course name."),
+};
+export const getCalendarEventsTool = {
+    name: "get_calendar_events",
+    description: "Get upcoming non-assignment calendar events like office hours, review sessions, school events, field trips, assemblies, and other scheduled events. This returns only calendar events, NOT assignment due dates (use get_due_this_week or get_upcoming_assignments for assignments). Events include titles, descriptions, start/end times, and location information. Useful for seeing what's happening on campus beyond coursework deadlines.",
+    schema,
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    handler: async ({ student_id, days, course_id }) => {
+        const effectiveStudentId = await getEffectiveStudentId(student_id);
+        const items = await getCalendarEvents({
+            studentId: String(effectiveStudentId),
+            days,
+            courseId: course_id,
+        });
+        return jsonResponse(items);
+    },
+};

package/esm/src/mcp/tools/get-discussions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tool: get_discussions
+ * Get discussion topics across courses with participation status
+ */
+import { z } from "zod";
+import { type ToolDefinition } from "../types.js";
+export declare const schema: {
+    student_id: z.ZodOptional<z.ZodString>;
+    days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    course_id: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getDiscussionsTool: ToolDefinition<typeof schema>;
+//# sourceMappingURL=get-discussions.d.ts.map

package/esm/src/mcp/tools/get-discussions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-discussions.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/get-discussions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,MAAM;;;;CAkBlB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,OAAO,MAAM,CAiB5D,CAAC"}

package/esm/src/mcp/tools/get-discussions.js

@@ -0,0 +1,38 @@
+/**
+ * Tool: get_discussions
+ * Get discussion topics across courses with participation status
+ */
+import { z } from "zod";
+import { getDiscussions } from "../../services/index.js";
+import { getEffectiveStudentId } from "../../api/users.js";
+import { jsonResponse } from "../types.js";
+export const schema = {
+    student_id: z
+        .string()
+        .optional()
+        .describe("Student ID (uses configured CANVAS_STUDENT_ID if not provided)"),
+    days: z
+        .number()
+        .optional()
+        .default(30)
+        .describe("Number of days to look back for discussion topics (default: 30). Filters by posted_at or last_reply_at."),
+    course_id: z
+        .number()
+        .optional()
+        .describe("Filter to a specific course ID. Use 'get_courses' to find this ID from a course name."),
+};
+export const getDiscussionsTool = {
+    name: "get_discussions",
+    description: "Get discussion topics across courses with participation information. Shows discussion title, course, type (threaded or side_comment), number of replies, unread count, whether the discussion is graded (associated with an assignment), whether it requires an initial post, and the posted date. Useful for understanding class discussion activity, identifying unanswered discussions, and tracking participation requirements. Ordered by most recent activity (last reply or post date).",
+    schema,
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    handler: async ({ student_id, days, course_id }) => {
+        const effectiveStudentId = await getEffectiveStudentId(student_id);
+        const items = await getDiscussions({
+            studentId: String(effectiveStudentId),
+            days,
+            courseId: course_id,
+        });
+        return jsonResponse(items);
+    },
+};

package/esm/src/mcp/tools/get-feedback.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Tool: get_feedback
+ *
+ * Shows teacher comments and feedback on student submissions.
+ * Critical for parents who want to see what teachers are saying about their child's work.
+ *
+ * CLI equivalent: `canvas feedback`
+ */
+import { z } from "zod";
+import { type ToolDefinition } from "../types.js";
+export declare const schema: {
+    student_id: z.ZodString;
+    course_id: z.ZodOptional<z.ZodNumber>;
+    days: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getFeedbackTool: ToolDefinition<typeof schema>;
+//# sourceMappingURL=get-feedback.d.ts.map

package/esm/src/mcp/tools/get-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-feedback.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/get-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,MAAM;;;;CAUlB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,MAAM,CAezD,CAAC"}

package/esm/src/mcp/tools/get-feedback.js

@@ -0,0 +1,30 @@
+/**
+ * MCP Tool: get_feedback
+ *
+ * Shows teacher comments and feedback on student submissions.
+ * Critical for parents who want to see what teachers are saying about their child's work.
+ *
+ * CLI equivalent: `canvas feedback`
+ */
+import { z } from "zod";
+import { getFeedback } from "../../services/index.js";
+import { jsonResponse } from "../types.js";
+export const schema = {
+    student_id: z.string().describe("Student ID (use 'self' for current user, or numeric ID from get_students tool)"),
+    course_id: z.number().optional().describe("Filter to specific course (omit to fetch from all active courses)"),
+    days: z.number().optional().describe("Look back N days for comments (default: 14)"),
+};
+export const getFeedbackTool = {
+    name: "get_feedback",
+    description: "Get teacher comments and feedback on student submissions. Shows what teachers and TAs are saying about the student's work. Returns a list of feedback items sorted by most recent comment first, each with: assignment_name, course_name, comment_text (the teacher's comment), author_name (who commented), comment_date, student_score, points_possible, grade, and assignment URL. Use this to see detailed feedback on assignments, especially when parents want to understand teacher comments or concerns about specific work.",
+    schema,
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    handler: async ({ student_id, course_id, days }) => {
+        const result = await getFeedback({
+            studentId: student_id,
+            courseId: course_id,
+            days: days,
+        });
+        return jsonResponse(result);
+    },
+};

package/esm/src/mcp/tools/get-people.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP Tool: get_people
+ *
+ * Shows teachers and teaching assistants for courses.
+ * Helps parents know who teaches each course and how to contact them.
+ *
+ * CLI equivalent: `canvas people`
+ */
+import { z } from "zod";
+import { type ToolDefinition } from "../types.js";
+export declare const schema: {
+    student_id: z.ZodOptional<z.ZodString>;
+    course_id: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getPeopleTool: ToolDefinition<typeof schema>;
+//# sourceMappingURL=get-people.d.ts.map

package/esm/src/mcp/tools/get-people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-people.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/get-people.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,MAAM;;;CAOlB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,OAAO,MAAM,CAcvD,CAAC"}

package/esm/src/mcp/tools/get-people.js

@@ -0,0 +1,28 @@
+/**
+ * MCP Tool: get_people
+ *
+ * Shows teachers and teaching assistants for courses.
+ * Helps parents know who teaches each course and how to contact them.
+ *
+ * CLI equivalent: `canvas people`
+ */
+import { z } from "zod";
+import { getPeople } from "../../services/index.js";
+import { jsonResponse } from "../types.js";
+export const schema = {
+    student_id: z.string().optional().describe("Student ID (use 'self' for current user, or numeric ID from get_students tool). For observer accounts to get courses."),
+    course_id: z.number().optional().describe("Filter to specific course (omit to fetch from all active courses)"),
+};
+export const getPeopleTool = {
+    name: "get_people",
+    description: "Get teachers and teaching assistants for courses. Returns a list of people with: name, role (Teacher or TA), email (if available), and an array of courses they teach. When fetching across all courses, people who teach multiple courses are deduplicated and listed once with all their courses. Use this to help parents know who teaches each course and how to contact them. Sorted alphabetically by name.",
+    schema,
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    handler: async ({ student_id, course_id }) => {
+        const result = await getPeople({
+            studentId: student_id,
+            courseId: course_id,
+        });
+        return jsonResponse(result);
+    },
+};

package/esm/src/mcp/tools/get-students.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tool: get_students
+ * List students being observed by the current user (parent/observer account)
+ */
+import { type ToolDefinition } from "../types.js";
+export declare const schema: {};
+export declare const getStudentsTool: ToolDefinition<typeof schema>;
+//# sourceMappingURL=get-students.d.ts.map

package/esm/src/mcp/tools/get-students.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-students.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/get-students.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,MAAM,IAAK,CAAC;AAEzB,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,OAAO,MAAM,CAUzD,CAAC"}

package/esm/src/mcp/tools/get-students.js

@@ -0,0 +1,17 @@
+/**
+ * Tool: get_students
+ * List students being observed by the current user (parent/observer account)
+ */
+import { getObservedStudents } from "../../services/index.js";
+import { jsonResponse } from "../types.js";
+export const schema = {};
+export const getStudentsTool = {
+    name: "get_students",
+    description: "List all students being observed by the current user (for parent/observer accounts). Returns the student's ID, name, short_name, and sortable_name for each observed student. CRITICAL: Call this tool FIRST when the user mentions a student by name (e.g., 'Ronin', 'Rory'). Use the returned student_id in subsequent tool calls (get_courses, get_missing_assignments, etc.). NEVER guess a student_id - always call this tool to map student names to Canvas student IDs.",
+    schema,
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    handler: async () => {
+        const students = await getObservedStudents();
+        return jsonResponse(students);
+    },
+};

package/esm/src/mcp/tools/index.d.ts

@@ -14,10 +14,16 @@ import { getComprehensiveStatusTool } from "./get-comprehensive-status.js";
 import { getAnnouncementsTool } from "./get-announcements.js";
 import { getInboxTool } from "./get-inbox.js";
 import { getTeacherCommunicationsTool } from "./get-teacher-communications.js";
+import { getStudentsTool } from "./get-students.js";
+import { getCalendarEventsTool } from "./get-calendar-events.js";
+import { getAllStudentsStatusTool } from "./get-all-students-status.js";
+import { getFeedbackTool } from "./get-feedback.js";
+import { getPeopleTool } from "./get-people.js";
+import { getDiscussionsTool } from "./get-discussions.js";
 import type { AnyToolDefinition } from "../types.js";
 /**
  * All available MCP tools
  */
 export declare const tools: AnyToolDefinition[];
-export { getAnnouncementsTool, getComprehensiveStatusTool, getCoursesTool, getDueThisWeekTool, getInboxTool, getMissingAssignmentsTool, getRecentGradesTool, getStatsTool, getTeacherCommunicationsTool, getTodoTool, getUnsubmittedPastDueTool, getUpcomingAssignmentsTool, listAssignmentsTool, };
+export { getAllStudentsStatusTool, getAnnouncementsTool, getCalendarEventsTool, getComprehensiveStatusTool, getCoursesTool, getDiscussionsTool, getDueThisWeekTool, getFeedbackTool, getInboxTool, getMissingAssignmentsTool, getPeopleTool, getRecentGradesTool, getStatsTool, getStudentsTool, getTeacherCommunicationsTool, getTodoTool, getUnsubmittedPastDueTool, getUpcomingAssignmentsTool, listAssignmentsTool, };
 //# sourceMappingURL=index.d.ts.map

package/esm/src/mcp/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,iBAAiB,EAcpC,CAAC;AAGF,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,EACZ,4BAA4B,EAC5B,WAAW,EACX,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,GACpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,iBAAiB,EAoBpC,CAAC;AAGF,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,4BAA4B,EAC5B,WAAW,EACX,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,GACpB,CAAC"}

package/esm/src/mcp/tools/index.js

@@ -14,6 +14,12 @@ import { getComprehensiveStatusTool } from "./get-comprehensive-status.js";
 import { getAnnouncementsTool } from "./get-announcements.js";
 import { getInboxTool } from "./get-inbox.js";
 import { getTeacherCommunicationsTool } from "./get-teacher-communications.js";
+import { getStudentsTool } from "./get-students.js";
+import { getCalendarEventsTool } from "./get-calendar-events.js";
+import { getAllStudentsStatusTool } from "./get-all-students-status.js";
+import { getFeedbackTool } from "./get-feedback.js";
+import { getPeopleTool } from "./get-people.js";
+import { getDiscussionsTool } from "./get-discussions.js";
 /**
  * All available MCP tools
  */
@@ -31,6 +37,12 @@ export const tools = [
     getAnnouncementsTool,
     getInboxTool,
     getTeacherCommunicationsTool,
+    getStudentsTool,
+    getCalendarEventsTool,
+    getAllStudentsStatusTool,
+    getFeedbackTool,
+    getPeopleTool,
+    getDiscussionsTool,
 ];
 // Re-export individual tools for direct access if needed
-export { getAnnouncementsTool, getComprehensiveStatusTool, getCoursesTool, getDueThisWeekTool, getInboxTool, getMissingAssignmentsTool, getRecentGradesTool, getStatsTool, getTeacherCommunicationsTool, getTodoTool, getUnsubmittedPastDueTool, getUpcomingAssignmentsTool, listAssignmentsTool, };
+export { getAllStudentsStatusTool, getAnnouncementsTool, getCalendarEventsTool, getComprehensiveStatusTool, getCoursesTool, getDiscussionsTool, getDueThisWeekTool, getFeedbackTool, getInboxTool, getMissingAssignmentsTool, getPeopleTool, getRecentGradesTool, getStatsTool, getStudentsTool, getTeacherCommunicationsTool, getTodoTool, getUnsubmittedPastDueTool, getUpcomingAssignmentsTool, listAssignmentsTool, };

package/esm/src/services/calendar.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Calendar Events Service
+ * Get non-assignment calendar events (office hours, review sessions, school events, field trips)
+ *
+ * Used by:
+ * - CLI: `canvas calendar`
+ * - MCP: `get_calendar_events`
+ */
+import type { CalendarEventItem } from "./types.js";
+export interface GetCalendarEventsOptions {
+    studentId?: string;
+    courseId?: number;
+    days?: number;
+}
+export declare function getCalendarEvents(options?: GetCalendarEventsOptions): Promise<CalendarEventItem[]>;
+//# sourceMappingURL=calendar.d.ts.map

package/esm/src/services/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/src/services/calendar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0D9B"}