canvas-lms-mcp 1.18.0 → 1.19.0

package/README.md

@@ -13,6 +13,16 @@ MCP server for [Canvas LMS](https://www.instructure.com/canvas). Read courses, a
 
 116 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, student workflows, dashboard, and health checks. Three deployment modes: stdio, HTTP, and library import.
 
+## One-click install (Claude Desktop)
+
+1. **[Download `canvas-lms-mcp.mcpb`](https://github.com/bruchris/canvas-lms-mcp/releases/latest/download/canvas-lms-mcp.mcpb)** from the latest release.
+2. Double-click the file (or drag it into Claude Desktop's Extensions settings).
+3. When prompted, paste your Canvas API token and Canvas API base URL (e.g. `https://school.instructure.com/api/v1`).
+
+No terminal, no Node.js install, no config-file editing — Claude Desktop bundles the runtime and handles config for you. The same `.mcpb` works in Claude Code and MCP for Windows.
+
+Prefer the terminal? Use the [Quick Start](#quick-start) below.
+
 ## Comparison
 
 | | canvas-lms-mcp | [vishalsachdev/canvas-mcp](https://github.com/vishalsachdev/canvas-mcp) | [DMontgomery40/mcp-canvas-lms](https://github.com/DMontgomery40/mcp-canvas-lms) |

package/dist/canvas/index.cjs

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkTKK4IOCLcjs = require('../chunk-TKK4IOCL.cjs');
+var _chunkLTBTS6YAcjs = require('../chunk-LTBTS6YA.cjs');
 
 
 
 
 
-var _chunkXPJXO3NJcjs = require('../chunk-XPJXO3NJ.cjs');
+var _chunkEXAIZYJYcjs = require('../chunk-EXAIZYJY.cjs');
 
 
 
 
 
 
-exports.CanvasApiError = _chunkXPJXO3NJcjs.CanvasApiError; exports.CanvasClient = _chunkTKK4IOCLcjs.CanvasClient; exports.CanvasHttpClient = _chunkXPJXO3NJcjs.CanvasHttpClient; exports.appendCanvasQuery = _chunkXPJXO3NJcjs.appendCanvasQuery; exports.toCanvasQuery = _chunkXPJXO3NJcjs.toCanvasQuery;
+exports.CanvasApiError = _chunkEXAIZYJYcjs.CanvasApiError; exports.CanvasClient = _chunkLTBTS6YAcjs.CanvasClient; exports.CanvasHttpClient = _chunkEXAIZYJYcjs.CanvasHttpClient; exports.appendCanvasQuery = _chunkEXAIZYJYcjs.appendCanvasQuery; exports.toCanvasQuery = _chunkEXAIZYJYcjs.toCanvasQuery;
 //# sourceMappingURL=index.cjs.map

package/dist/canvas/index.js

@@ -1,12 +1,12 @@
 import {
   CanvasClient
-} from "../chunk-5WXEIIJS.js";
+} from "../chunk-5P4FUG7Q.js";
 import {
   CanvasApiError,
   CanvasHttpClient,
   appendCanvasQuery,
   toCanvasQuery
-} from "../chunk-TYV6ENOV.js";
+} from "../chunk-Z5EZRC5F.js";
 export {
   CanvasApiError,
   CanvasClient,

package/dist/{chunk-5WXEIIJS.js → chunk-5P4FUG7Q.js}

@@ -1,6 +1,6 @@
 import {
   CanvasHttpClient
-} from "./chunk-TYV6ENOV.js";
+} from "./chunk-Z5EZRC5F.js";
 
 // src/canvas/courses.ts
 var DEFAULT_LIST_INCLUDE = ["term"];
@@ -1395,4 +1395,4 @@ export {
   OUTCOME_EXCLUDE_OPTIONS,
   CanvasClient
 };
-//# sourceMappingURL=chunk-5WXEIIJS.js.map
+//# sourceMappingURL=chunk-5P4FUG7Q.js.map

package/dist/{chunk-PMDK4WZA.cjs → chunk-CDWLOZQ2.cjs}

@@ -7,11 +7,11 @@
 
 
 
-var _chunkTKK4IOCLcjs = require('./chunk-TKK4IOCL.cjs');
+var _chunkLTBTS6YAcjs = require('./chunk-LTBTS6YA.cjs');
 
 
 
-var _chunkXPJXO3NJcjs = require('./chunk-XPJXO3NJ.cjs');
+var _chunkEXAIZYJYcjs = require('./chunk-EXAIZYJY.cjs');
 
 // src/server.ts
 var _mcpjs = require('@modelcontextprotocol/sdk/server/mcp.js');
@@ -547,7 +547,7 @@ function accountTools(canvas, pseudonymizer) {
 
 // src/tools/errors.ts
 function formatError(error) {
-  if (error instanceof _chunkXPJXO3NJcjs.CanvasApiError) {
+  if (error instanceof _chunkEXAIZYJYcjs.CanvasApiError) {
     const status = error.status;
     const message = error.message;
     const ltiMarkers = ["Tool not configured", "tool is not configured"];
@@ -599,7 +599,7 @@ function analyticsTools(canvas) {
       inputSchema: {
         course_id: _zod.z.number().describe("The Canvas course ID"),
         search_term: _zod.z.string().describe("The keyword or phrase to search for"),
-        content_types: _zod.z.array(_zod.z.enum(_chunkTKK4IOCLcjs.SEARCH_CONTENT_TYPES)).optional().describe(
+        content_types: _zod.z.array(_zod.z.enum(_chunkLTBTS6YAcjs.SEARCH_CONTENT_TYPES)).optional().describe(
           "Content types to search. Defaults to all types: pages, discussions, assignments, announcements."
         )
       },
@@ -611,7 +611,7 @@ function analyticsTools(canvas) {
         const courseId = params.course_id;
         const searchTerm = params.search_term;
         const types = _nullishCoalesce(params.content_types, () => ( [
-          ..._chunkTKK4IOCLcjs.SEARCH_CONTENT_TYPES
+          ..._chunkLTBTS6YAcjs.SEARCH_CONTENT_TYPES
         ]));
         if (types.length === 0) return { results: [] };
         const settled = await Promise.allSettled(
@@ -1983,7 +1983,7 @@ function outcomeTools(canvas, pseudonymizer) {
       name: "get_root_outcome_group",
       description: "Get the root outcome group for an account or course context.",
       inputSchema: {
-        context_type: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_CONTEXT_TYPES).describe("Whether to read outcomes from an account or course context."),
+        context_type: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_CONTEXT_TYPES).describe("Whether to read outcomes from an account or course context."),
         context_id: _zod.z.number().describe("The Canvas account ID or course ID for the context.")
       },
       annotations: { readOnlyHint: true, openWorldHint: true },
@@ -1996,7 +1996,7 @@ function outcomeTools(canvas, pseudonymizer) {
       name: "list_outcome_groups",
       description: "List all outcome groups for an account or course context.",
       inputSchema: {
-        context_type: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_CONTEXT_TYPES).describe("Whether to read outcome groups from an account or course context."),
+        context_type: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_CONTEXT_TYPES).describe("Whether to read outcome groups from an account or course context."),
         context_id: _zod.z.number().describe("The Canvas account ID or course ID for the context.")
       },
       annotations: { readOnlyHint: true, openWorldHint: true },
@@ -2009,10 +2009,10 @@ function outcomeTools(canvas, pseudonymizer) {
       name: "list_outcome_group_links",
       description: "List all outcome links in an account or course context.",
       inputSchema: {
-        context_type: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_CONTEXT_TYPES).describe("Whether to read outcome links from an account or course context."),
+        context_type: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_CONTEXT_TYPES).describe("Whether to read outcome links from an account or course context."),
         context_id: _zod.z.number().describe("The Canvas account ID or course ID for the context."),
-        outcome_style: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_DETAIL_LEVELS).optional().describe('Outcome detail level. Use "full" to include expanded outcome fields.'),
-        outcome_group_style: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_DETAIL_LEVELS).optional().describe(
+        outcome_style: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_DETAIL_LEVELS).optional().describe('Outcome detail level. Use "full" to include expanded outcome fields.'),
+        outcome_group_style: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_DETAIL_LEVELS).optional().describe(
           'Outcome group detail level. Use "full" to include expanded outcome group fields.'
         )
       },
@@ -2030,7 +2030,7 @@ function outcomeTools(canvas, pseudonymizer) {
       name: "get_outcome_group",
       description: "Get details for a specific outcome group in an account or course context.",
       inputSchema: {
-        context_type: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_CONTEXT_TYPES).describe("The outcome group context type."),
+        context_type: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_CONTEXT_TYPES).describe("The outcome group context type."),
         context_id: _zod.z.number().describe("The Canvas account ID or course ID for the context."),
         outcome_group_id: _zod.z.number().describe("The Canvas outcome group ID.")
       },
@@ -2045,10 +2045,10 @@ function outcomeTools(canvas, pseudonymizer) {
       name: "list_outcome_group_outcomes",
       description: "List the linked outcomes directly under a specific outcome group.",
       inputSchema: {
-        context_type: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_CONTEXT_TYPES).describe("The outcome group context type."),
+        context_type: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_CONTEXT_TYPES).describe("The outcome group context type."),
         context_id: _zod.z.number().describe("The Canvas account ID or course ID for the context."),
         outcome_group_id: _zod.z.number().describe("The Canvas outcome group ID."),
-        outcome_style: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_DETAIL_LEVELS).optional().describe('Outcome detail level. Use "full" to include expanded outcome fields.')
+        outcome_style: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_DETAIL_LEVELS).optional().describe('Outcome detail level. Use "full" to include expanded outcome fields.')
       },
       annotations: { readOnlyHint: true, openWorldHint: true },
       handler: async (params) => canvas.outcomes.listGroupOutcomes(
@@ -2064,7 +2064,7 @@ function outcomeTools(canvas, pseudonymizer) {
       name: "list_outcome_group_subgroups",
       description: "List the immediate child outcome groups under a specific outcome group.",
       inputSchema: {
-        context_type: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_CONTEXT_TYPES).describe("The outcome group context type."),
+        context_type: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_CONTEXT_TYPES).describe("The outcome group context type."),
         context_id: _zod.z.number().describe("The Canvas account ID or course ID for the context."),
         outcome_group_id: _zod.z.number().describe("The Canvas outcome group ID.")
       },
@@ -2130,14 +2130,14 @@ function outcomeTools(canvas, pseudonymizer) {
       inputSchema: {
         course_id: _zod.z.number().describe("The Canvas course ID."),
         aggregate: _zod.z.enum(["course"]).optional().describe("Aggregate all student rollups into a single course-level rollup."),
-        aggregate_stat: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_ROLLUP_AGGREGATE_STATS).optional().describe('Statistic to use when aggregate="course".'),
+        aggregate_stat: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_ROLLUP_AGGREGATE_STATS).optional().describe('Statistic to use when aggregate="course".'),
         user_ids: _zod.z.array(_zod.z.union([_zod.z.number(), _zod.z.string()])).optional().describe('Optional Canvas user IDs or SIS user IDs prefixed with "sis_user_id:".'),
         outcome_ids: _zod.z.array(_zod.z.number()).optional().describe("Optional outcome IDs to restrict the rollups."),
         include_courses: _zod.z.boolean().optional().describe("Include linked course details in the response payload."),
-        exclude: _zod.z.array(_zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_EXCLUDE_OPTIONS)).optional().describe("Optional rollup exclusions for missing users or missing outcome results."),
-        sort_by: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_ROLLUP_SORT_BY).optional().describe("Sort rollups by student name or by a specific outcome score."),
+        exclude: _zod.z.array(_zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_EXCLUDE_OPTIONS)).optional().describe("Optional rollup exclusions for missing users or missing outcome results."),
+        sort_by: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_ROLLUP_SORT_BY).optional().describe("Sort rollups by student name or by a specific outcome score."),
         sort_outcome_id: _zod.z.number().optional().describe('Outcome ID to sort by when sort_by="outcome".'),
-        sort_order: _zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_SORT_ORDER).optional().describe("Sort order to apply when sorting rollups."),
+        sort_order: _zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_SORT_ORDER).optional().describe("Sort order to apply when sorting rollups."),
         add_defaults: _zod.z.boolean().optional().describe("Include default mastery colors and levels when Canvas supports it.")
       },
       annotations: { readOnlyHint: true, openWorldHint: true },
@@ -2185,7 +2185,7 @@ function outcomeTools(canvas, pseudonymizer) {
       description: "Get mastery distribution analytics for outcomes in a course, optionally filtered by students or outcomes.",
       inputSchema: {
         course_id: _zod.z.number().describe("The Canvas course ID."),
-        exclude: _zod.z.array(_zod.z.enum(_chunkTKK4IOCLcjs.OUTCOME_EXCLUDE_OPTIONS)).optional().describe("Optional exclusions for missing users or missing outcome results."),
+        exclude: _zod.z.array(_zod.z.enum(_chunkLTBTS6YAcjs.OUTCOME_EXCLUDE_OPTIONS)).optional().describe("Optional exclusions for missing users or missing outcome results."),
         outcome_ids: _zod.z.array(_zod.z.number()).optional().describe("Optional outcome IDs to restrict the distribution results."),
         student_ids: _zod.z.array(_zod.z.union([_zod.z.number(), _zod.z.string()])).optional().describe('Optional Canvas student IDs or SIS user IDs prefixed with "sis_user_id:".'),
         include_alignment_distributions: _zod.z.boolean().optional().describe("Include contributing score distributions for alignments."),
@@ -3395,7 +3395,7 @@ function registerAllTools(server, canvas, pseudonymizer) {
         }
         return response;
       } catch (error) {
-        if (error instanceof _chunkXPJXO3NJcjs.CanvasApiError) {
+        if (error instanceof _chunkEXAIZYJYcjs.CanvasApiError) {
         } else {
           console.error(`Unexpected error in tool "${tool.name}":`, error);
         }
@@ -3443,7 +3443,7 @@ function registerSyllabusResource(server, canvas) {
           ]
         };
       } catch (error) {
-        if (!(error instanceof _chunkXPJXO3NJcjs.CanvasApiError)) {
+        if (!(error instanceof _chunkEXAIZYJYcjs.CanvasApiError)) {
           console.error("Unexpected error in syllabus resource:", error);
         }
         return {
@@ -3492,7 +3492,7 @@ function registerAssignmentDescriptionResource(server, canvas) {
           ]
         };
       } catch (error) {
-        if (!(error instanceof _chunkXPJXO3NJcjs.CanvasApiError)) {
+        if (!(error instanceof _chunkEXAIZYJYcjs.CanvasApiError)) {
           console.error("Unexpected error in assignment-description resource:", error);
         }
         return {
@@ -3511,14 +3511,14 @@ function registerAllResources(server, canvas) {
 
 // src/server.ts
 function createCanvasMCPServer(config) {
-  const canvas = new (0, _chunkTKK4IOCLcjs.CanvasClient)({
+  const canvas = new (0, _chunkLTBTS6YAcjs.CanvasClient)({
     token: config.token,
     baseUrl: config.baseUrl
   });
   const pseudonymizer = _nullishCoalesce(config.pseudonymizer, () => ( new Pseudonymizer({ baseUrl: config.baseUrl })));
   const server = new (0, _mcpjs.McpServer)({
     name: "canvas-lms-mcp",
-    version: _chunkXPJXO3NJcjs.version
+    version: _chunkEXAIZYJYcjs.version
   });
   registerAllTools(server, canvas, pseudonymizer);
   registerAllResources(server, canvas);
@@ -3529,4 +3529,4 @@ function createCanvasMCPServer(config) {
 
 
 exports.Pseudonymizer = Pseudonymizer; exports.createCanvasMCPServer = createCanvasMCPServer;
-//# sourceMappingURL=chunk-PMDK4WZA.cjs.map
+//# sourceMappingURL=chunk-CDWLOZQ2.cjs.map