canvas-lms-mcp 2.2.0 → 2.3.0

package/README.md

@@ -11,7 +11,7 @@
 
 MCP server for [Canvas LMS](https://www.instructure.com/canvas). Read courses, assignments, submissions, rubrics, quizzes; grade, comment, manage course content, and handle Canvas admin workflows from any AI agent.
 
-172 tools across Canvas courses, assignments, submissions, gradebook history, rubrics, quizzes, New Quizzes (LTI), files, users, groups, enrollments, discussions, modules, pages, calendar, conversations, peer reviews, accounts, analytics, outcomes, grading standards, grade projection, link audit, accessibility audit, content exports, content migrations, quiz accommodations, appointment groups, student workflows, student search, dashboard, instructor attention workflows, and health checks. Three deployment modes: stdio, HTTP, and library import.
+174 tools across Canvas courses, assignments, submissions, gradebook history, rubrics, quizzes, New Quizzes (LTI), files, users, groups, enrollments, discussions, modules, pages, calendar, conversations, peer reviews, accounts, analytics, outcomes, grading standards, grade projection, link audit, accessibility audit, content exports, content migrations, quiz accommodations, appointment groups, student workflows, student search, dashboard, instructor attention workflows, and health checks. Three deployment modes: stdio, HTTP, and library import.
 
 ## One-click install (Claude Desktop)
 
@@ -45,7 +45,7 @@ Installs the MCP server (via `npx canvas-lms-mcp`) and all 16 [Agent Skills](#ag
 | | canvas-lms-mcp | [vishalsachdev/canvas-mcp](https://github.com/vishalsachdev/canvas-mcp) | [DMontgomery40/mcp-canvas-lms](https://github.com/DMontgomery40/mcp-canvas-lms) |
 |---|---|---|---|
 | Language | TypeScript | Python | TypeScript |
-| Tools | 172 | 80+ | 54 |
+| Tools | 174 | 80+ | 54 |
 | License | [![License: MIT](https://img.shields.io/github/license/bruchris/canvas-lms-mcp)](https://github.com/bruchris/canvas-lms-mcp/blob/main/LICENSE) | [![License](https://img.shields.io/github/license/vishalsachdev/canvas-mcp)](https://github.com/vishalsachdev/canvas-mcp/blob/main/LICENSE) | [![License](https://img.shields.io/github/license/DMontgomery40/mcp-canvas-lms)](https://github.com/DMontgomery40/mcp-canvas-lms/blob/main/LICENSE) |
 | Last commit | [![Last commit](https://img.shields.io/github/last-commit/bruchris/canvas-lms-mcp)](https://github.com/bruchris/canvas-lms-mcp) | [![Last commit](https://img.shields.io/github/last-commit/vishalsachdev/canvas-mcp)](https://github.com/vishalsachdev/canvas-mcp) | [![Last commit](https://img.shields.io/github/last-commit/DMontgomery40/mcp-canvas-lms)](https://github.com/DMontgomery40/mcp-canvas-lms) |
 
@@ -152,7 +152,7 @@ Once configured, try these prompts with your AI client:
 | Attention | `list_submission_comments_needing_attention`, `list_students_needing_attention` |
 | FERPA (conditional) | `resolve_pseudonym` — stdio only, registered when `CANVAS_PSEUDONYMIZE_STUDENTS=true` and `CANVAS_PSEUDONYMIZE_REVERSE_LOOKUP=true` |
 
-120 tools are read-only and 52 tools perform Canvas write operations. When FERPA mode is enabled **on the stdio transport**, `resolve_pseudonym` is registered as the 173rd tool overall (121st read tool). The HTTP transport never registers it — see [FERPA mode](#ferpa-mode-student-pseudonymization).
+122 tools are read-only and 52 tools perform Canvas write operations. When FERPA mode is enabled **on the stdio transport**, `resolve_pseudonym` is registered as the 175th tool overall (123rd read tool). The HTTP transport never registers it — see [FERPA mode](#ferpa-mode-student-pseudonymization).
 
 All write tools require appropriate Canvas permissions. Canvas enforces its own permission model -- the MCP server does not bypass it.
 
@@ -545,10 +545,10 @@ Three roles, plus the default of "unset = every tool":
 
 | `CANVAS_ROLE` | Tools exposed | Typical use |
 |---------------|---------------|-------------|
-| _(unset)_ | all (~172) | default; backwards-compatible |
-| `student` | ~61 | a student's own courses, grades, submissions, and read-only course content |
-| `teacher` | ~149 | grading, roster, content authoring, analytics |
-| `admin` | ~161 | everything `teacher` sees plus account-level tools (`enroll_user`, `list_account_users`, …) |
+| _(unset)_ | all (~174) | default; backwards-compatible |
+| `student` | ~63 | a student's own courses, grades, submissions, and read-only course content |
+| `teacher` | ~151 | grading, roster, content authoring, analytics |
+| `admin` | ~163 | everything `teacher` sees plus account-level tools (`enroll_user`, `list_account_users`, …) |
 
 Notes:
 

package/dist/canvas/discussions.d.ts

@@ -7,6 +7,8 @@ export declare class DiscussionsModule {
     list(courseId: CanvasId): Promise<CanvasDiscussionTopic[]>;
     get(courseId: CanvasId, topicId: CanvasId): Promise<CanvasDiscussionTopic>;
     listAnnouncements(courseId: CanvasId): Promise<CanvasAnnouncement[]>;
+    listForGroup(groupId: CanvasId): Promise<CanvasDiscussionTopic[]>;
+    getForGroup(groupId: CanvasId, topicId: CanvasId): Promise<CanvasDiscussionTopic>;
     postEntry(courseId: CanvasId, topicId: CanvasId, message: string): Promise<CanvasDiscussionEntry>;
     create(courseId: CanvasId, params: CreateDiscussionParams): Promise<CanvasDiscussionTopic>;
     update(courseId: CanvasId, topicId: CanvasId, params: UpdateDiscussionParams): Promise<CanvasDiscussionTopic>;

package/dist/canvas/discussions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discussions.d.ts","sourceRoot":"","sources":["../../src/canvas/discussions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAEpC,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAEtC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAM1D,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM1E,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOpE,SAAS,CACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAU3B,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAU1F,MAAM,CACV,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,qBAAqB,CAAC;IAU3B,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnE"}
+{"version":3,"file":"discussions.d.ts","sourceRoot":"","sources":["../../src/canvas/discussions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAEpC,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAEtC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAM1D,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM1E,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOpE,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAMjE,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAMjF,SAAS,CACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAU3B,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAU1F,MAAM,CACV,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,qBAAqB,CAAC;IAU3B,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnE"}

package/dist/canvas/index.cjs

@@ -6,13 +6,13 @@
 
 
 
-var _chunkEMIO4XD4cjs = require('../chunk-EMIO4XD4.cjs');
+var _chunkV25MGZFNcjs = require('../chunk-V25MGZFN.cjs');
 
 
 
 
 
-var _chunkC2C3TYWDcjs = require('../chunk-C2C3TYWD.cjs');
+var _chunkSVXYCCZ4cjs = require('../chunk-SVXYCCZ4.cjs');
 
 
 
@@ -25,5 +25,5 @@ var _chunkC2C3TYWDcjs = require('../chunk-C2C3TYWD.cjs');
 
 
 
-exports.CANVAS_MAX_ID = _chunkEMIO4XD4cjs.CANVAS_MAX_ID; exports.CanvasApiError = _chunkC2C3TYWDcjs.CanvasApiError; exports.CanvasClient = _chunkEMIO4XD4cjs.CanvasClient; exports.CanvasHttpClient = _chunkC2C3TYWDcjs.CanvasHttpClient; exports.MAX_SAFE_CANVAS_NUMBER_ID = _chunkEMIO4XD4cjs.MAX_SAFE_CANVAS_NUMBER_ID; exports.appendCanvasQuery = _chunkC2C3TYWDcjs.appendCanvasQuery; exports.canvasIdInput = _chunkEMIO4XD4cjs.canvasIdInput; exports.canvasIdList = _chunkEMIO4XD4cjs.canvasIdList; exports.compareCanvasIds = _chunkEMIO4XD4cjs.compareCanvasIds; exports.normalizeCanvasIdInput = _chunkEMIO4XD4cjs.normalizeCanvasIdInput; exports.toCanvasQuery = _chunkC2C3TYWDcjs.toCanvasQuery;
+exports.CANVAS_MAX_ID = _chunkV25MGZFNcjs.CANVAS_MAX_ID; exports.CanvasApiError = _chunkSVXYCCZ4cjs.CanvasApiError; exports.CanvasClient = _chunkV25MGZFNcjs.CanvasClient; exports.CanvasHttpClient = _chunkSVXYCCZ4cjs.CanvasHttpClient; exports.MAX_SAFE_CANVAS_NUMBER_ID = _chunkV25MGZFNcjs.MAX_SAFE_CANVAS_NUMBER_ID; exports.appendCanvasQuery = _chunkSVXYCCZ4cjs.appendCanvasQuery; exports.canvasIdInput = _chunkV25MGZFNcjs.canvasIdInput; exports.canvasIdList = _chunkV25MGZFNcjs.canvasIdList; exports.compareCanvasIds = _chunkV25MGZFNcjs.compareCanvasIds; exports.normalizeCanvasIdInput = _chunkV25MGZFNcjs.normalizeCanvasIdInput; exports.toCanvasQuery = _chunkSVXYCCZ4cjs.toCanvasQuery;
 //# sourceMappingURL=index.cjs.map

package/dist/canvas/index.js

@@ -6,13 +6,13 @@ import {
   canvasIdList,
   compareCanvasIds,
   normalizeCanvasIdInput
-} from "../chunk-FP4A34TD.js";
+} from "../chunk-I4EZ5NSC.js";
 import {
   CanvasApiError,
   CanvasHttpClient,
   appendCanvasQuery,
   toCanvasQuery
-} from "../chunk-W5DF5YBG.js";
+} from "../chunk-TEYUOD55.js";
 export {
   CANVAS_MAX_ID,
   CanvasApiError,

package/dist/{chunk-FKTJGYLG.js → chunk-24IEEOBF.js}

@@ -25,11 +25,11 @@ import {
   compareCanvasIds,
   mapWithConcurrency,
   normalizeCanvasIdInput
-} from "./chunk-FP4A34TD.js";
+} from "./chunk-I4EZ5NSC.js";
 import {
   CanvasApiError,
   version
-} from "./chunk-W5DF5YBG.js";
+} from "./chunk-TEYUOD55.js";
 
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -804,6 +804,8 @@ var UNTRUSTED_FIELDS = {
   // `post_discussion_entry` / `update_discussion` publish as the operator.
   get_discussion: { message: "discussion message" },
   list_discussions: { message: "discussion message" },
+  get_group_discussion: { message: "discussion message" },
+  list_group_discussions: { message: "discussion message" },
   // Rank 3 — arbitrary sender; `send_conversation` sends as the operator.
   // `last_message` is Canvas's preview string on the conversation itself;
   // `body` is the full text of each message in the thread.
@@ -2863,6 +2865,9 @@ function anonymityDescription(topic) {
 function anonymousTopicMessage(courseId, topicId, description) {
   return `Discussion topic ${topicId} exists in course ${courseId} \u2014 list_discussions returns it \u2014 but Canvas blocks the topic-scoped detail REST endpoint for anonymous discussion topics and answers it with HTTP 404. This topic is ${description}. The topic ID is correct; no other ID will work. Read the topic's listed attributes from list_discussions, or open the topic in the Canvas web UI. Replying with post_discussion_entry is unaffected.`;
 }
+function anonymousGroupTopicMessage(groupId, topicId, description) {
+  return `Discussion topic ${topicId} exists in group ${groupId} \u2014 list_group_discussions returns it \u2014 but Canvas blocks the topic-scoped detail REST endpoint for anonymous discussion topics and answers it with HTTP 404. This topic is ${description}. The topic ID is correct; no other ID will work. Read the topic's listed attributes from list_group_discussions, or open the topic in the Canvas web UI.`;
+}
 async function describeAnonymityFromList(canvas, courseId, topicId) {
   let topics;
   try {
@@ -2873,6 +2878,16 @@ async function describeAnonymityFromList(canvas, courseId, topicId) {
   const listed = topics.find((topic) => topic.id === topicId);
   return listed ? anonymityDescription(listed) : void 0;
 }
+async function describeGroupAnonymityFromList(canvas, groupId, topicId) {
+  let topics;
+  try {
+    topics = await canvas.discussions.listForGroup(groupId);
+  } catch {
+    return void 0;
+  }
+  const listed = topics.find((topic) => topic.id === topicId);
+  return listed ? anonymityDescription(listed) : void 0;
+}
 function assertAnnouncementHonored(topic, action) {
   if (topic.is_announcement) return;
   throw new Error(
@@ -2927,6 +2942,52 @@ function discussionTools(canvas) {
         }
       }
     },
+    {
+      name: "list_group_discussions",
+      title: "List Group Discussions",
+      description: "List all discussion topics in a group.",
+      inputSchema: {
+        group_id: canvasIdInput().describe("The Canvas group ID")
+      },
+      annotations: {
+        readOnlyHint: true,
+        openWorldHint: true
+      },
+      handler: async (params) => {
+        const group_id = params.group_id;
+        return canvas.discussions.listForGroup(group_id);
+      }
+    },
+    {
+      name: "get_group_discussion",
+      title: "Get Group Discussion",
+      // As with get_discussion, the anonymous-topic case is reported by the handler's
+      // error below rather than advertised here — `docs/generated/tool-manifest.json`
+      // embeds this string, so any edit also requires `pnpm generate:manifests`.
+      description: "Get details for a single discussion topic in a group by ID.",
+      inputSchema: {
+        group_id: canvasIdInput().describe("The Canvas group ID"),
+        topic_id: canvasIdInput().describe("The Canvas discussion topic ID")
+      },
+      annotations: {
+        readOnlyHint: true,
+        openWorldHint: true
+      },
+      handler: async (params) => {
+        const group_id = params.group_id;
+        const topic_id = params.topic_id;
+        try {
+          return await canvas.discussions.getForGroup(group_id, topic_id);
+        } catch (error) {
+          if (!(error instanceof CanvasApiError) || error.status !== 404) throw error;
+          const description = await describeGroupAnonymityFromList(canvas, group_id, topic_id);
+          if (description === void 0) throw error;
+          throw new Error(anonymousGroupTopicMessage(group_id, topic_id, description), {
+            cause: error
+          });
+        }
+      }
+    },
     {
       name: "list_announcements",
       title: "List Announcements",
@@ -10021,4 +10082,4 @@ export {
   createSharedPseudonymizer,
   createCanvasMCPServer
 };
-//# sourceMappingURL=chunk-FKTJGYLG.js.map
+//# sourceMappingURL=chunk-24IEEOBF.js.map