canvas-design-mcp 0.9.5 → 1.0.0

package/README.md

@@ -6,14 +6,19 @@ Works in Claude Code, VS Code, ChatGPT Codex, and any MCP-compatible host. Zero
 
 ---
 
+![Canvas Design Studio — workflow and capabilities overview](docs/Canvas-Design-Studio-Capabilities.png)
+
+---
+
 ## What It Does
 
 | Tool | What it does |
 |---|---|
+| `get_started` | Get a tailored orientation based on your current config — what tools are active, what setup unlocks, quick-start prompts, and a Context7 hint. Call this at the start of any session. |
 | `generate_canvas_page` | Turns a raw assignment brief into polished, Canvas-safe HTML with a hero banner, two-column layout, and brand colors |
 | `validate_canvas_html` | Checks HTML against Canvas RCE sanitizer rules and WCAG 2.1 AA accessibility checks |
 | `update_canvas_kb` | Fetches the current Canvas HTML allowlist directly from Canvas LMS source and reports any changes |
-| `setup_institution` | Re-runs the setup wizard to update brand colors, Canvas URL, API token, Panopto config, and philosophy KB |
+| `setup_institution` | Runs the setup wizard to save brand colors, Canvas URL, API token, brand standards URL, and Panopto config — returns a formatted setup summary when done |
 | `list_canvas_courses` | Lists your Canvas courses with semester filtering, student counts, and favorite pinning to help choose the right one |
 | `publish_to_canvas` | Validates and publishes generated HTML directly to a Canvas course page — with FERPA preflight and title collision protection |
 | `critique_canvas_page` | Scores visual design quality (0–100) with 8 structural checks, strengths, and prioritized findings |
@@ -28,6 +33,11 @@ Works in Claude Code, VS Code, ChatGPT Codex, and any MCP-compatible host. Zero
 | `generate_student_personas` | Generate 1–20 student personas using real probability distributions for race, disability, and 21 other dimensions |
 | `load_canvas_page` | Read the most recently generated HTML page from `output/` back into context (or load a named file) |
 | `save_canvas_page` | Write improved HTML back to `output/` — automatically backs up the previous version before overwriting |
+| `setup_course` | Run once per course: choose page types from a checklist, set weeks, get a complete folder scaffold pre-filled with content prompts |
+| `generate_page` | Generate or regenerate a single Canvas page from its `.md` source file |
+| `generate_week` | Generate all pages for one week at once |
+| `generate_course` | Batch generate the entire course in one command |
+| `import_course` | Seed a course folder from a Canvas backup archive — extracts pages, assignments, quizzes, and discussions with `[NEEDS REVIEW]` placeholders for content that can't be auto-extracted |
 
 ---
 
@@ -36,7 +46,7 @@ Works in Claude Code, VS Code, ChatGPT Codex, and any MCP-compatible host. Zero
 ### Option A — npm global install
 
 ```bash
-npm install -g github:Ryfter/canvas-design-studio
+npm install -g canvas-design-mcp
 ```
 
 Then add to your MCP client config:
@@ -57,11 +67,40 @@ Then add to your MCP client config:
 
 ### Option B — Docker (no Node.js required)
 
+Docker has two steps:
+
+1. **Download the image** so it exists on your computer.
+2. **Tell your AI app how to start it** by adding the JSON config below to that app's MCP settings.
+
+The JSON is not a PowerShell command. It is a configuration snippet for Claude Desktop, Cursor, LM Studio, and other MCP clients.
+
 ```bash
 # Pull the image
 docker pull ghcr.io/ryfter/canvas-design-studio:latest
 ```
 
+Run the setup wizard once so Canvas Design Studio can save your school colors, Canvas URL, and optional API token.
+
+Windows PowerShell:
+
+```powershell
+docker run -it --rm -v "$HOME\.canvas-design-mcp:/root/.canvas-design-mcp" ghcr.io/ryfter/canvas-design-studio:latest
+```
+
+macOS Terminal:
+
+```bash
+docker run -it --rm -v "$HOME/.canvas-design-mcp:/root/.canvas-design-mcp" ghcr.io/ryfter/canvas-design-studio:latest
+```
+
+Linux terminal:
+
+```bash
+docker run -it --rm -v "$HOME/.canvas-design-mcp:/root/.canvas-design-mcp" ghcr.io/ryfter/canvas-design-studio:latest
+```
+
+After the wizard finishes, add this to your MCP client config:
+
 ```json
 {
   "mcpServers": {
@@ -77,28 +116,48 @@ docker pull ghcr.io/ryfter/canvas-design-studio:latest
 }
 ```
 
-The `-v` mount gives the container access to your institution config. Run the setup wizard once on the host before using Docker (see Step 2 below).
+That `-v` line is the important part: it lets the temporary Docker container read the saved config from your computer. Without that mount, the container starts fresh every time and will not remember your institution settings.
+
+If your AI app does not expand `${HOME}` correctly, replace it with your full home folder path:
 
-### 2. First run
+- Windows: `C:/Users/YOUR-USERNAME/.canvas-design-mcp:/root/.canvas-design-mcp`
+- macOS: `/Users/YOUR-USERNAME/.canvas-design-mcp:/root/.canvas-design-mcp`
 
-On first use, a setup wizard runs in your terminal:
+Common config locations:
+
+- **Claude Desktop on Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **Claude Desktop on macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Cursor:** `~/.cursor/mcp.json`
+- **LM Studio:** `~/.lmstudio/mcp.json`
+- **Codex CLI:** uses TOML instead of this JSON; see [docs/installation.md](docs/installation.md)
+
+After saving the config, fully restart the AI app. The app will run Docker for you whenever it needs the Canvas Design Studio tools.
+
+### What the Setup Wizard Asks
+
+Whether you use npm or Docker, the first setup run asks:
 
 ```
 ╔═══════════════════════════════════════════════════════════╗
 ║          Canvas Design Studio — First Run Setup           ║
 ╚═══════════════════════════════════════════════════════════╝
 
-Institution name: (Boise State University)
+Institution name (your college or university): (Boise State University)
+Brand standards URL (optional — your AI fetches this to suggest your colors):
 Primary brand color (#hex): (#0033A0)
 Secondary / accent color (#hex): (#D64309)
-Canvas base URL: (https://boisestate.instructure.com)
-Canvas API token (optional — leave blank to generate HTML and paste it manually):
+Canvas base URL (no trailing slash): (https://boisestate.instructure.com)
+Canvas API token — Account → Settings → Approved Integrations (optional):
 Professor email for FERPA scan allowlist (optional):
 Favorite Canvas course IDs, comma-separated (optional):
 ```
 
+When the wizard finishes it prints a formatted setup summary showing your settings and what you can do right now. Ask your AI to save it as `my-canvas-setup.md` for reference.
+
 Config saves to `~/.canvas-design-mcp/institution.json` — survives `npx` reinstalls.
 
+**New to Canvas Design Studio?** See `docs/start_here.md` for a full orientation, or run `get_started` at the beginning of any session for a tailored overview of what's active.
+
 ---
 
 ## Generating a Page
@@ -242,6 +301,10 @@ Config file: `~/.canvas-design-mcp/institution.json`
 - **v0.7** — Professor philosophy KB (steering context for every page Claude generates) ✓
 - **v0.8** — Student persona review (statistically grounded audience feedback before publishing) ✓
 - **v0.9** — Assignment improvement loop (load page from output/, apply critique, save back with backup) ✓
+- **v0.9.6** — Course design foundation: `setup_course` wizard, `generate_page/week/course`, 15 page type templates ✓
+- **v0.9.7** — Canvas backup import: `import_course` seeds a full course folder from a previous semester's archive ✓
+- **v0.9.8** — Assignment type customization: `proj-assignment` and `tech-assignment` page types with `team` and `timeline` flags ✓
+- **v1.0.0** — First-professor polish: `get_started` orientation tool, setup summary, brand URL extraction, wizard inline explanations, rich error messages with ChatGPT help links, and three orientation docs (`start_here`, `troubleshooting`, `setup-worksheet`) ✓
 
 ---
 

package/dist/course-types.d.ts

@@ -0,0 +1,79 @@
+export declare const PAGE_TYPES: readonly ["front-page", "overview", "resources", "slides", "videos", "assignment", "engage-assignment", "proj-assignment", "tech-assignment", "reading", "reading-quiz", "weekly-quiz", "lab", "discussion-board", "extra-credit", "custom"];
+export type PageType = typeof PAGE_TYPES[number];
+export declare const PAGE_TYPE_LABELS: Record<PageType, string>;
+export declare const DEFAULT_PAGE_TYPES: PageType[];
+export interface CourseColors {
+    primary: string;
+    primaryDark: string;
+    primaryLight: string;
+    secondary: string;
+}
+export interface WeekEntry {
+    week: number;
+    weekStr: string;
+    title: string;
+    topic: string;
+}
+export interface CourseConfig {
+    institution: string;
+    courseName: string;
+    courseNumber: string;
+    professor: string;
+    semester: string;
+    weeks: number;
+    pageTypes: PageType[];
+    layoutFixed: boolean;
+    colors: CourseColors;
+    heroImages: Partial<Record<PageType, string>>;
+    weekOutline: WeekEntry[];
+}
+export interface PageFrontMatter {
+    week?: number;
+    title?: string;
+    heroImage?: string;
+    assignmentNumber?: string;
+    due?: string;
+    points?: number;
+    team?: boolean;
+    timeline?: boolean;
+    [key: string]: string | number | boolean | undefined;
+}
+export interface PageContent {
+    pageType: PageType;
+    frontMatter: PageFrontMatter;
+    sections: Record<string, string>;
+}
+export interface GeneratePageInput {
+    mdPath: string;
+    courseDir?: string;
+    outputDir?: string;
+}
+export interface GeneratePageResult {
+    html: string;
+    filename: string;
+    weekNumber: number;
+    pageType: PageType;
+    savedTo: string;
+}
+export interface GenerateWeekInput {
+    weekNumber: number;
+    courseDir?: string;
+    outputDir?: string;
+}
+export interface GenerateWeekResult {
+    weekNumber: number;
+    pages: GeneratePageResult[];
+    outputDir: string;
+    warnings: string[];
+}
+export interface GenerateCourseInput {
+    courseDir?: string;
+    outputDir?: string;
+}
+export interface GenerateCourseResult {
+    totalPages: number;
+    outputDir: string;
+    weekResults: GenerateWeekResult[];
+    warnings: string[];
+}
+//# sourceMappingURL=course-types.d.ts.map

package/dist/course-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-types.d.ts","sourceRoot":"","sources":["../src/course-types.ts"],"names":[],"mappings":"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"}

package/dist/course-types.js

@@ -0,0 +1,45 @@
+export const PAGE_TYPES = [
+    'front-page',
+    'overview',
+    'resources',
+    'slides',
+    'videos',
+    'assignment',
+    'engage-assignment',
+    'proj-assignment',
+    'tech-assignment',
+    'reading',
+    'reading-quiz',
+    'weekly-quiz',
+    'lab',
+    'discussion-board',
+    'extra-credit',
+    'custom',
+];
+export const PAGE_TYPE_LABELS = {
+    'front-page': 'Front Page (course home)',
+    'overview': 'Overview (learning objectives, intro, activities)',
+    'resources': 'Resources (slides, videos, readings combined)',
+    'slides': 'Slides (dedicated slide deck page)',
+    'videos': 'Videos (dedicated Panopto video page)',
+    'assignment': 'Assignment',
+    'engage-assignment': 'Engage Assignment (short in-class activity)',
+    'proj-assignment': 'Project Assignment (multi-week deliverable)',
+    'tech-assignment': 'Technical Assignment (hands-on, tool-based)',
+    'reading': 'Reading',
+    'reading-quiz': 'Reading Quiz',
+    'weekly-quiz': 'Weekly Quiz',
+    'lab': 'Lab',
+    'discussion-board': 'Discussion Board',
+    'extra-credit': 'Extra Credit',
+    'custom': 'Custom (professor-defined sections)',
+};
+export const DEFAULT_PAGE_TYPES = [
+    'front-page',
+    'overview',
+    'resources',
+    'assignment',
+    'discussion-board',
+    'weekly-quiz',
+];
+//# sourceMappingURL=course-types.js.map

package/dist/course-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-types.js","sourceRoot":"","sources":["../src/course-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,YAAY;IACZ,UAAU;IACV,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,SAAS;IACT,cAAc;IACd,aAAa;IACb,KAAK;IACL,kBAAkB;IAClB,cAAc;IACd,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,YAAY,EAAS,0BAA0B;IAC/C,UAAU,EAAW,mDAAmD;IACxE,WAAW,EAAU,+CAA+C;IACpE,QAAQ,EAAa,oCAAoC;IACzD,QAAQ,EAAa,uCAAuC;IAC5D,YAAY,EAAS,YAAY;IACjC,mBAAmB,EAAE,6CAA6C;IAClE,iBAAiB,EAAI,6CAA6C;IAClE,iBAAiB,EAAI,6CAA6C;IAClE,SAAS,EAAY,SAAS;IAC9B,cAAc,EAAO,cAAc;IACnC,aAAa,EAAQ,aAAa;IAClC,KAAK,EAAgB,KAAK;IAC1B,kBAAkB,EAAG,kBAAkB;IACvC,cAAc,EAAO,cAAc;IACnC,QAAQ,EAAa,qCAAqC;CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,YAAY;IACZ,UAAU;IACV,WAAW;IACX,YAAY;IACZ,kBAAkB;IAClB,aAAa;CACd,CAAC"}

package/dist/index.js

@@ -4,7 +4,9 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { CanvasApiClient } from './canvas-api.js';
 import { configExists, loadConfig, saveConfig } from './config.js';
-import { runWizard } from './wizard.js';
+import { runWizard, formatSetupSummary } from './wizard.js';
+import { formatError } from './utils/errors.js';
+import { getStarted } from './tools/get-started.js';
 import { validateCanvasHtml } from './tools/validate.js';
 import { generateCanvasPage } from './tools/generate.js';
 import { updateCanvasKb } from './tools/update-kb.js';
@@ -18,6 +20,11 @@ import { ingestAssignmentFolder } from './tools/ingest.js';
 import { getPhilosophyKb, updatePhilosophyKb } from './tools/philosophy.js';
 import { generateStudentPersonas, getStudentPersonas } from './tools/personas.js';
 import { loadCanvasPage, saveCanvasPage } from './tools/page-io.js';
+import { generatePage } from './tools/generate-page.js';
+import { generateWeek } from './tools/generate-week.js';
+import { generateCourse } from './tools/generate-course.js';
+import { runCourseWizard } from './tools/setup-course.js';
+import { importCourse } from './tools/import-course.js';
 async function main() {
     if (!configExists()) {
         if (!process.stdin.isTTY) {
@@ -35,6 +42,11 @@ async function main() {
     const server = new Server({ name: 'canvas-design-studio', version: '0.1.0' }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: [
+            {
+                name: 'get_started',
+                description: 'Get a tailored orientation based on your current config — what tools are active, what setup unlocks, quick-start prompts, and a Context7 hint for the latest docs. Call this at the start of any session.',
+                inputSchema: { type: 'object', properties: {} },
+            },
             {
                 name: 'setup_institution',
                 description: 'Re-run the setup wizard to update institution config (brand colors, Canvas URL, API token). Run this to change institutions or rotate credentials.',
@@ -290,15 +302,91 @@ async function main() {
                     },
                 },
             },
+            {
+                name: 'setup_course',
+                description: 'Run the course setup wizard to create a full course folder scaffold — course-config.md, all week folders, and pre-filled template .md files for each active page type. Run once per course. Supports color overrides and a checkbox page-type selector with recommendations.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        courseDir: { type: 'string', description: 'Directory to create the course scaffold in. Defaults to "course/" in the current project.' },
+                    },
+                },
+            },
+            {
+                name: 'generate_page',
+                description: 'Generate one Canvas HTML page from a single .md content file. Finds course-config.md automatically by walking up from the file. Saves to output/week-NN/filename.html. Use for one-off pages and per-page tweaks.',
+                inputSchema: {
+                    type: 'object',
+                    required: ['mdPath'],
+                    properties: {
+                        mdPath: { type: 'string', description: 'Path to the .md content file (e.g. "course/week-03/assignment.md" or "course/front-page.md").' },
+                        courseDir: { type: 'string', description: 'Directory containing course-config.md. Inferred from mdPath if omitted.' },
+                        outputDir: { type: 'string', description: 'Output directory. Defaults to "output/" inside the course directory.' },
+                    },
+                },
+            },
+            {
+                name: 'generate_week',
+                description: 'Generate all Canvas HTML pages for one week. Reads course-config.md for active page types and colors, then generates HTML for each .md file found in the week folder. Skips missing files with a warning.',
+                inputSchema: {
+                    type: 'object',
+                    required: ['weekNumber'],
+                    properties: {
+                        weekNumber: { type: 'number', description: 'Week number to generate (e.g. 3 for week-03).' },
+                        courseDir: { type: 'string', description: 'Directory containing course-config.md. Defaults to "course/".' },
+                        outputDir: { type: 'string', description: 'Output directory. Defaults to "output/" inside the course directory.' },
+                    },
+                },
+            },
+            {
+                name: 'generate_course',
+                description: 'Batch generate all Canvas HTML pages for the entire course — front page plus all weeks. Reads course-config.md for the week count and active page types. Reports total pages generated and any warnings about missing .md files.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        courseDir: { type: 'string', description: 'Directory containing course-config.md. Defaults to "course/".' },
+                        outputDir: { type: 'string', description: 'Output directory. Defaults to "output/" inside the course directory.' },
+                    },
+                },
+            },
+            {
+                name: 'import_course',
+                description: 'Import a previous semester\'s course from a canvas-backup archive folder. Reads modules, pages, assignments, quizzes, and discussions and scaffolds a pre-filled course/ folder ready to update and regenerate. Works at three granularities: full course (omit weekNumber and assignmentName), one week (provide weekNumber), or one assignment (provide assignmentName). Content that cannot be cleanly extracted — quiz questions, LTI links, external tools — is written as [NEEDS REVIEW] placeholders.',
+                inputSchema: {
+                    type: 'object',
+                    required: ['archivePath'],
+                    properties: {
+                        archivePath: {
+                            type: 'string',
+                            description: 'Path to the canvas-backup archive folder for the course (e.g. "D:/CanvasArchive/2026/Spring/ITM370").',
+                        },
+                        outputDir: {
+                            type: 'string',
+                            description: 'Directory to write the imported course folder into. Defaults to "course/" in the current project.',
+                        },
+                        weekNumber: {
+                            type: 'number',
+                            description: 'Import only this week (1-based). Omit to import all weeks.',
+                        },
+                        assignmentName: {
+                            type: 'string',
+                            description: 'Import only this specific assignment by name. Omit to import all content.',
+                        },
+                    },
+                },
+            },
         ],
     }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
         try {
+            if (name === 'get_started') {
+                return { content: [{ type: 'text', text: getStarted() }] };
+            }
             if (name === 'setup_institution') {
-                await runWizard();
+                const config = await runWizard();
                 return {
-                    content: [{ type: 'text', text: 'Institution config updated. Canvas Design Studio is ready.' }],
+                    content: [{ type: 'text', text: formatSetupSummary(config) }],
                 };
             }
             if (name === 'validate_canvas_html') {
@@ -319,6 +407,24 @@ async function main() {
                 };
             }
             if (name === 'generate_canvas_page') {
+                if (!configExists()) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: formatError({
+                                    title: 'Setup Required',
+                                    message: 'Canvas Design Studio needs institution config before generating pages.',
+                                    cause: 'No institution.json found at ~/.canvas-design-mcp/institution.json.',
+                                    fix: [
+                                        'Run setup_institution to save your institution colors, Canvas URL, and optional API token',
+                                        'The wizard takes about 2 minutes and only needs to run once',
+                                    ],
+                                    context: 'generate_canvas_page called with no institution config',
+                                }),
+                            }],
+                        isError: true,
+                    };
+                }
                 const config = loadConfig();
                 const result = generateCanvasPage(args, config);
                 const response = [
@@ -422,7 +528,21 @@ async function main() {
                 const config = loadConfig();
                 if (!config.panopto) {
                     return {
-                        content: [{ type: 'text', text: 'Panopto is not configured. Run setup_institution to add Panopto settings.' }],
+                        content: [{
+                                type: 'text',
+                                text: formatError({
+                                    title: 'Panopto — Not Configured',
+                                    message: 'Panopto video tools require a Panopto domain and API credentials.',
+                                    cause: 'No Panopto configuration is saved in your institution config.',
+                                    fix: [
+                                        'Run setup_institution',
+                                        'When prompted for Panopto domain, enter your institution\'s Panopto domain (e.g. bsu.hosted.panopto.com)',
+                                        'For video search and caption download, also provide a Panopto client ID and secret',
+                                        'embed_panopto_video works without API credentials — you only need the video ID',
+                                    ],
+                                    context: 'Panopto not configured',
+                                }),
+                            }],
                         isError: true,
                     };
                 }
@@ -435,7 +555,21 @@ async function main() {
                 const config = loadConfig();
                 if (!config.panopto) {
                     return {
-                        content: [{ type: 'text', text: 'Panopto is not configured. Run setup_institution to add Panopto settings.' }],
+                        content: [{
+                                type: 'text',
+                                text: formatError({
+                                    title: 'Panopto — Not Configured',
+                                    message: 'Panopto video tools require a Panopto domain and API credentials.',
+                                    cause: 'No Panopto configuration is saved in your institution config.',
+                                    fix: [
+                                        'Run setup_institution',
+                                        'When prompted for Panopto domain, enter your institution\'s Panopto domain (e.g. bsu.hosted.panopto.com)',
+                                        'For video search and caption download, also provide a Panopto client ID and secret',
+                                        'embed_panopto_video works without API credentials — you only need the video ID',
+                                    ],
+                                    context: 'Panopto not configured',
+                                }),
+                            }],
                         isError: true,
                     };
                 }
@@ -452,7 +586,21 @@ async function main() {
                 const config = loadConfig();
                 if (!config.panopto) {
                     return {
-                        content: [{ type: 'text', text: 'Panopto is not configured. Run setup_institution to add Panopto settings.' }],
+                        content: [{
+                                type: 'text',
+                                text: formatError({
+                                    title: 'Panopto — Not Configured',
+                                    message: 'Panopto video tools require a Panopto domain and API credentials.',
+                                    cause: 'No Panopto configuration is saved in your institution config.',
+                                    fix: [
+                                        'Run setup_institution',
+                                        'When prompted for Panopto domain, enter your institution\'s Panopto domain (e.g. bsu.hosted.panopto.com)',
+                                        'For video search and caption download, also provide a Panopto client ID and secret',
+                                        'embed_panopto_video works without API credentials — you only need the video ID',
+                                    ],
+                                    context: 'Panopto not configured',
+                                }),
+                            }],
                         isError: true,
                     };
                 }
@@ -462,6 +610,24 @@ async function main() {
                 return { content: [{ type: 'text', text: result }], ...(isApiError ? { isError: true } : {}) };
             }
             if (name === 'ingest_assignment_folder') {
+                if (!configExists()) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: formatError({
+                                    title: 'Setup Required',
+                                    message: 'Canvas Design Studio needs institution config before generating pages.',
+                                    cause: 'No institution.json found at ~/.canvas-design-mcp/institution.json.',
+                                    fix: [
+                                        'Run setup_institution to save your institution colors, Canvas URL, and optional API token',
+                                        'The wizard takes about 2 minutes and only needs to run once',
+                                    ],
+                                    context: 'ingest_assignment_folder called with no institution config',
+                                }),
+                            }],
+                        isError: true,
+                    };
+                }
                 const config = loadConfig();
                 const { folderPath } = (args ?? {});
                 const result = ingestAssignmentFolder({ folderPath }, config);
@@ -550,6 +716,64 @@ async function main() {
                     lines.push(`  Backup created: ${result.backup}`);
                 return { content: [{ type: 'text', text: lines.join('\n') }] };
             }
+            if (name === 'setup_course') {
+                const { courseDir } = (args ?? {});
+                const created = await runCourseWizard(courseDir);
+                return {
+                    content: [{ type: 'text', text: `✓ Course scaffold created.\n${created.length} files written:\n${created.map(f => `  • ${f}`).join('\n')}` }],
+                };
+            }
+            if (name === 'generate_page') {
+                const input = args;
+                const result = generatePage(input);
+                return {
+                    content: [{ type: 'text', text: `✓ Generated ${result.pageType} page\n  Week: ${result.weekNumber || 'N/A'}\n  Saved: ${result.savedTo}` }],
+                };
+            }
+            if (name === 'generate_week') {
+                const input = args;
+                const result = generateWeek(input);
+                const lines = [`✓ Week ${result.weekNumber}: ${result.pages.length} page(s) generated`];
+                for (const p of result.pages)
+                    lines.push(`  • ${p.pageType} → ${p.savedTo}`);
+                if (result.warnings.length > 0)
+                    lines.push(`\n⚠ Warnings:\n${result.warnings.map(w => `  • ${w}`).join('\n')}`);
+                return { content: [{ type: 'text', text: lines.join('\n') }] };
+            }
+            if (name === 'generate_course') {
+                const input = (args ?? {});
+                const result = generateCourse(input);
+                const lines = [
+                    `✓ Course generated: ${result.totalPages} page(s) across ${result.weekResults.length} week(s)`,
+                    `  Output: ${result.outputDir}`,
+                ];
+                if (result.warnings.length > 0)
+                    lines.push(`\n⚠ Warnings (${result.warnings.length}):\n${result.warnings.map(w => `  • ${w}`).join('\n')}`);
+                return { content: [{ type: 'text', text: lines.join('\n') }] };
+            }
+            if (name === 'import_course') {
+                const { archivePath, outputDir, weekNumber, assignmentName } = (args ?? {});
+                const result = importCourse({
+                    archivePath,
+                    outputDir: outputDir ?? 'course',
+                    weekNumber,
+                    assignmentName,
+                });
+                const lines = [
+                    `✓ Import complete`,
+                    `  Weeks imported: ${result.weeksImported}`,
+                    `  Files created: ${result.filesCreated}`,
+                ];
+                if (result.warnings.length > 0) {
+                    lines.push(`\n⚠ Warnings (${result.warnings.length}):`);
+                    lines.push(...result.warnings.map(w => `  • ${w}`));
+                }
+                lines.push('\nNext steps:');
+                lines.push('  1. Open course-config.md — update semester, professor name, and week topics');
+                lines.push('  2. Search for [NEEDS REVIEW] in .md files and fill in missing content');
+                lines.push('  3. Tell Claude: "Generate the course from the course/ folder"');
+                return { content: [{ type: 'text', text: lines.join('\n') }] };
+            }
             return {
                 content: [{ type: 'text', text: `Unknown tool: ${name}` }],
                 isError: true,