@classroomio/mcp 0.0.5 → 0.0.7

package/README.md

@@ -43,6 +43,7 @@ Current tools:
 
 - `list_org_courses`
 - `get_course_structure`
+- `update_course_landing_page`
 - `create_course_draft`
 - `create_course_draft_from_course`
 - `get_course_draft`
@@ -163,6 +164,12 @@ Drafts support:
 - safer updates to existing courses
 - auditability of AI-generated structure
 
+Lesson authoring rule:
+
+- `lessonLanguages[].content` should contain only the lesson body HTML
+- do not include the lesson title or a top-level heading that repeats `lessons[].title`
+- ClassroomIO already renders the lesson title in the course UI
+
 ## After Publish
 
 Once a draft has been published, the live course becomes the safer source of truth.
@@ -215,7 +222,37 @@ Result:
 - publish returns the live `courseId` and public `courseUrl`
 - publish can optionally set a random Unsplash-derived course cover
 
-### Flow 2: Create a draft from a PDF
+### Flow 2: Update a landing page with AI-generated copy and media
+
+User says:
+
+```text
+Rewrite this course landing page to feel more premium, generate a new cover image, and add three believable reviews.
+```
+
+Expected tool sequence:
+
+1. Agent calls `list_org_courses` if it needs to resolve the course ID by name first.
+2. Agent calls `update_course_landing_page`.
+
+What the landing-page tool can update:
+
+- title
+- short description
+- overview
+- requirements
+- goals
+- pricing fields
+- instructor section
+- reviews
+- landing page image
+
+The tool can either:
+
+- use an explicit `imageUrl`
+- or generate a random Unsplash-based image with `generateImage` and `imageQuery`
+
+### Flow 3: Create a draft from a PDF
 
 User says:
 
@@ -238,7 +275,7 @@ Important:
 - the PDF does not need to be uploaded to MCP
 - the MCP package only receives structured JSON
 
-### Flow 3: Tag a draft before publish
+### Flow 4: Tag a draft before publish
 
 User says:
 
@@ -258,7 +295,7 @@ Result:
 - publish ensures the tags exist in ClassroomIO
 - publish assigns those tags to the live course
 
-### Flow 4: Update an existing course safely
+### Flow 5: Update an existing course safely
 
 User says:
 
@@ -286,7 +323,7 @@ What this publish does today:
 - upserts lesson language content
 - merges draft tags into the existing course
 
-### Flow 5: Add exercises to a live course
+### Flow 6: Add exercises to a live course
 
 User says:
 
@@ -351,6 +388,21 @@ Exercise tools use the live course directly:
 - `create_course_exercise_from_template`
 - `update_course_exercise`
 
+Supported `questionTypeId` values for exercise payloads:
+
+- `1` `RADIO` - Single answer
+- `2` `CHECKBOX` - Multiple answers
+- `3` `TEXTAREA` - Paragraph
+- `4` `TRUE_FALSE` - True/False
+- `5` `SHORT_ANSWER` - Short answer
+- `6` `NUMERIC` - Numeric answer
+- `7` `FILL_BLANK` - Fill in the blank
+- `8` `FILE_UPLOAD` - File upload
+- `9` `MATCHING` - Matching
+- `10` `ORDERING` - Ordering
+- `11` `HOTSPOT` - Hotspot
+- `12` `LINK` - Links
+
 ## Operational Notes
 
 - `create_course_draft_from_course` may add warnings if a live course uses legacy lesson notes instead of localized lesson content

package/dist/index.js

@@ -35,6 +35,12 @@ var ClassroomIoApiClient = class {
       method: "GET"
     });
   }
+  async updateCourseLandingPage(courseId, payload) {
+    return this.request(`/course/${courseId}/landing-page`, {
+      method: "PUT",
+      body: payload
+    });
+  }
   async getCourseDraft(draftId) {
     return this.request(`/organization/course-import/drafts/${draftId}`, {
       method: "GET"
@@ -108,13 +114,10 @@ var ClassroomIoApiClient = class {
     });
   }
   async tagCourses(payload) {
-    return this.request(
-      "/organization/tags/courses/assign",
-      {
-        method: "PUT",
-        body: payload
-      }
-    );
+    return this.request("/organization/tags/courses/assign", {
+      method: "PUT",
+      body: payload
+    });
   }
   async request(path, options) {
     const response = await fetch(new URL(path, this.config.CLASSROOMIO_API_URL), {
@@ -443,6 +446,7 @@ var ZOrganizationApiKeyScope = z10.enum([
   "course_import:draft:update",
   "course_import:draft:publish",
   "course:read",
+  "course:write",
   "course:tag:write",
   "course:exercise:read",
   "course:exercise:write",
@@ -1051,6 +1055,33 @@ var ZCourseCreate = z12.object({
   type: z12.enum(["LIVE_CLASS", "SELF_PACED"]),
   organizationId: z12.string().min(1)
 });
+var ZCourseReward = z12.object({
+  show: z12.boolean(),
+  description: z12.string()
+});
+var ZCourseInstructor = z12.object({
+  name: z12.string(),
+  role: z12.string(),
+  coursesNo: z12.number(),
+  description: z12.string(),
+  imgUrl: z12.string()
+});
+var ZCourseCertificate = z12.object({
+  templateUrl: z12.string()
+});
+var ZCourseReview = z12.object({
+  id: z12.number(),
+  hide: z12.boolean(),
+  name: z12.string(),
+  avatar_url: z12.string(),
+  rating: z12.number(),
+  created_at: z12.number(),
+  description: z12.string()
+});
+var ZCourseLessonTabsOrder = z12.array(z12.object({
+  id: z12.union([z12.literal(1), z12.literal(2), z12.literal(3), z12.literal(4)]),
+  name: z12.string()
+}));
 var ZCourseMetadata = z12.object({
   requirements: z12.string().optional(),
   description: z12.string().optional(),
@@ -1059,39 +1090,36 @@ var ZCourseMetadata = z12.object({
   showDiscount: z12.boolean().optional(),
   discount: z12.number().optional(),
   paymentLink: z12.string().optional(),
-  reward: z12.object({
-    show: z12.boolean(),
-    description: z12.string()
-  }).optional(),
-  instructor: z12.object({
-    name: z12.string(),
-    role: z12.string(),
-    coursesNo: z12.number(),
-    description: z12.string(),
-    imgUrl: z12.string()
-  }).optional(),
-  certificate: z12.object({
-    templateUrl: z12.string()
-  }).optional(),
-  reviews: z12.array(z12.object({
-    id: z12.number(),
-    hide: z12.boolean(),
-    name: z12.string(),
-    avatar_url: z12.string(),
-    rating: z12.number(),
-    created_at: z12.number(),
-    description: z12.string()
-  })).optional(),
-  lessonTabsOrder: z12.array(z12.object({
-    id: z12.union([z12.literal(1), z12.literal(2), z12.literal(3), z12.literal(4)]),
-    name: z12.string()
-  })).optional(),
+  reward: ZCourseReward.optional(),
+  instructor: ZCourseInstructor.optional(),
+  certificate: ZCourseCertificate.optional(),
+  reviews: z12.array(ZCourseReview).optional(),
+  lessonTabsOrder: ZCourseLessonTabsOrder.optional(),
   grading: z12.boolean().optional(),
   lessonDownload: z12.boolean().optional(),
   allowNewStudent: z12.boolean(),
   sectionDisplay: z12.record(z12.string(), z12.boolean()).optional(),
   isContentGroupingEnabled: z12.boolean().optional()
 });
+var ZCourseLandingPageMetadataUpdate = z12.object({
+  requirements: z12.string().optional(),
+  description: z12.string().optional(),
+  goals: z12.string().optional(),
+  videoUrl: z12.string().optional(),
+  showDiscount: z12.boolean().optional(),
+  discount: z12.number().optional(),
+  paymentLink: z12.string().optional(),
+  reward: ZCourseReward.partial().optional(),
+  instructor: ZCourseInstructor.partial().optional(),
+  certificate: ZCourseCertificate.partial().optional(),
+  reviews: z12.array(ZCourseReview).optional(),
+  lessonTabsOrder: ZCourseLessonTabsOrder.optional(),
+  grading: z12.boolean().optional(),
+  lessonDownload: z12.boolean().optional(),
+  allowNewStudent: z12.boolean().optional(),
+  sectionDisplay: z12.record(z12.string(), z12.boolean()).optional(),
+  isContentGroupingEnabled: z12.boolean().optional()
+});
 var ZCourseUpdate = z12.object({
   title: z12.string().min(1).optional(),
   description: z12.string().min(1).optional(),
@@ -1101,6 +1129,8 @@ var ZCourseUpdate = z12.object({
   isPublished: z12.boolean().optional(),
   overview: z12.string().optional(),
   metadata: ZCourseMetadata.optional(),
+  cost: z12.number().int().min(0).optional(),
+  currency: z12.enum(["NGN", "USD"]).optional(),
   isCertificateDownloadable: z12.boolean().optional(),
   certificateTheme: z12.string().optional(),
   tagIds: z12.array(z12.uuid()).max(100).optional()
@@ -1108,6 +1138,17 @@ var ZCourseUpdate = z12.object({
 var ZCourseUpdateParam = z12.object({
   courseId: z12.string().min(1)
 });
+var ZCourseLandingPageUpdate = z12.object({
+  title: z12.string().min(1).optional(),
+  description: z12.string().min(1).optional(),
+  overview: z12.string().optional(),
+  cost: z12.number().int().min(0).optional(),
+  currency: z12.enum(["NGN", "USD"]).optional(),
+  imageUrl: z12.url().optional(),
+  generateImage: z12.boolean().optional(),
+  imageQuery: z12.string().min(1).max(120).optional(),
+  metadata: ZCourseLandingPageMetadataUpdate.optional()
+});
 var ZCourseDeleteParam = z12.object({
   courseId: z12.string().min(1)
 });
@@ -1124,6 +1165,7 @@ var ZCourseUserAnalyticsParam = z12.object({
 
 // ../utils/dist/validation/course-import/course-import.js
 var ZSupportedLocale = z13.enum(["en", "hi", "fr", "pt", "de", "vi", "ru", "es", "pl", "da"]);
+var LESSON_BODY_HTML_DESCRIPTION = "Lesson body HTML only. Do not include the lesson title or a top-level heading that repeats lessons[].title because the ClassroomIO UI already renders the lesson title separately.";
 var ZCourseImportWarning = z13.object({
   code: z13.string().min(1),
   message: z13.string().min(1),
@@ -1158,7 +1200,7 @@ var ZCourseImportDraftLesson = z13.object({
 var ZCourseImportDraftLessonLanguage = z13.object({
   lessonExternalId: z13.string().min(1),
   locale: ZSupportedLocale,
-  content: z13.string().min(1)
+  content: z13.string().min(1).describe(LESSON_BODY_HTML_DESCRIPTION)
 });
 var ZCourseImportDraftPayload = z13.object({
   course: ZCourseImportDraftCourse,
@@ -1259,6 +1301,66 @@ var ZCourseImportDraftPublishToCourse = ZCourseImportDraftPublish.extend({
   courseId: z13.string().min(1)
 });
 
+// ../utils/dist/validation/course/section.js
+import * as z14 from "zod";
+var ZCourseSectionCreate = z14.object({
+  title: z14.string().min(1),
+  courseId: z14.string().min(1),
+  order: z14.number().int().min(0).optional()
+});
+var ZCourseSectionUpdate = z14.object({
+  title: z14.string().min(1).optional(),
+  order: z14.number().int().min(0).optional()
+});
+var ZCourseSectionPromoteUngrouped = z14.object({
+  title: z14.string().min(1)
+});
+var ZCourseSectionGetParam = z14.object({
+  sectionId: z14.string().min(1)
+});
+var ZCourseSectionReorder = z14.object({
+  sections: z14.array(z14.object({
+    id: z14.string().min(1),
+    order: z14.number().int().min(0)
+  })).min(1)
+});
+
+// ../utils/dist/validation/course/invite.js
+import * as z15 from "zod";
+var ZCourseInviteParam = z15.object({
+  courseId: z15.string().min(1)
+});
+var ZCourseInviteRevokeParam = z15.object({
+  courseId: z15.string().min(1),
+  inviteId: z15.string().uuid()
+});
+var ZCourseInviteAuditParam = z15.object({
+  courseId: z15.string().min(1),
+  inviteId: z15.string().uuid()
+});
+var ZCourseInviteTokenParam = z15.object({
+  token: z15.string().min(1)
+});
+var ZCreatePublicCourseInviteLink = z15.object({
+  courseId: z15.uuid()
+});
+var ZCourseInvitePreset = z15.enum(["ONE_TIME_24H", "MULTI_USE_7D", "MULTI_USE_30D", "CUSTOM"]);
+var ZCreateCourseInvite = z15.object({
+  preset: ZCourseInvitePreset.default("MULTI_USE_30D"),
+  expiresAt: z15.string().min(1).optional(),
+  maxUses: z15.number().int().min(1).max(1e3).optional(),
+  allowedEmails: z15.array(z15.string().email()).max(100).optional(),
+  allowedDomains: z15.array(z15.string().min(1)).max(100).optional(),
+  recipientEmails: z15.array(z15.string().email()).max(500).optional(),
+  recipientCsv: z15.string().max(25e3).optional(),
+  sendEmail: z15.boolean().default(false),
+  metadata: z15.record(z15.string(), z15.unknown()).optional()
+}).refine((data) => {
+  const hasEmails = (data.recipientEmails?.length ?? 0) > 0;
+  const hasCsv = typeof data.recipientCsv === "string" && data.recipientCsv.trim().length > 0;
+  return hasEmails || hasCsv;
+}, { message: "recipientEmails or recipientCsv is required", path: ["recipientEmails"] });
+
 // src/tools/course-drafts.ts
 var ZUpdateCourseDraftToolInput = ZCourseImportDraftUpdate.extend({
   draftId: ZCourseImportDraftGetParam.shape.draftId
@@ -1284,6 +1386,9 @@ var ZUpdateCourseExerciseToolInput = ZExerciseUpdate.extend({
   courseId: ZCourseImportCourseParam.shape.courseId,
   exerciseId: ZExerciseGetParam.shape.exerciseId
 });
+var ZUpdateCourseLandingPageToolInput = ZCourseLandingPageUpdate.extend({
+  courseId: ZCourseImportCourseParam.shape.courseId
+});
 var ZPublishCourseDraftToolInput = ZCourseImportDraftPublish.extend({
   draftId: ZCourseImportDraftGetParam.shape.draftId
 });
@@ -1302,9 +1407,12 @@ var getCourseExerciseShape = ZGetCourseExerciseToolInput.shape;
 var createCourseExerciseShape = ZCreateCourseExerciseToolInput.shape;
 var createCourseExerciseFromTemplateShape = ZCreateCourseExerciseFromTemplateToolInput.shape;
 var updateCourseExerciseShape = ZUpdateCourseExerciseToolInput.shape;
+var updateCourseLandingPageShape = ZUpdateCourseLandingPageToolInput.shape;
 var publishCourseDraftShape = ZPublishCourseDraftToolInput.shape;
 var publishCourseDraftToExistingCourseShape = ZPublishCourseDraftToExistingCourseToolInput.shape;
 var tagCoursesShape = ZAutomationCourseTagAssignment.shape;
+var SUPPORTED_QUESTION_TYPES_GUIDE = "Supported questionTypeId values: RADIO=1 (Single answer), CHECKBOX=2 (Multiple answers), TEXTAREA=3 (Paragraph), TRUE_FALSE=4 (True/False), SHORT_ANSWER=5 (Short answer), NUMERIC=6 (Numeric answer), FILL_BLANK=7 (Fill in the blank), FILE_UPLOAD=8 (File upload), MATCHING=9 (Matching), ORDERING=10 (Ordering), HOTSPOT=11 (Hotspot), LINK=12 (Links). Use the numeric ids in exercise payloads.";
+var LESSON_HTML_GUIDE = "For draft lesson HTML, put only the lesson body in lessonLanguages[].content. Do not include the lesson title or a top-level heading that repeats lessons[].title because the ClassroomIO UI already renders the lesson title.";
 function registerCourseDraftTools(server, apiClient) {
   server.tool(
     "list_org_courses",
@@ -1326,9 +1434,19 @@ function registerCourseDraftTools(server, apiClient) {
       return jsonContent(result);
     }
   );
+  server.tool(
+    "update_course_landing_page",
+    "Update landing-page-facing course fields on a live course, including headline copy, overview, requirements, goals, pricing, reviews, instructor information, and the course image. Use imageUrl to set an explicit cover image, or set generateImage/imageQuery to fetch a random Unsplash-based image.",
+    updateCourseLandingPageShape,
+    async (args) => {
+      const { courseId, ...payload } = ZUpdateCourseLandingPageToolInput.parse(args);
+      const result = await apiClient.updateCourseLandingPage(courseId, payload);
+      return jsonContent(result);
+    }
+  );
   server.tool(
     "create_course_draft",
-    "Create a new unpublished course draft from structured course JSON. Use this before the first publish.",
+    `Create a new unpublished course draft from structured course JSON. Use this before the first publish. ${LESSON_HTML_GUIDE}`,
     createCourseDraftShape,
     async (args) => {
       const payload = ZCourseImportDraftCreate.parse(args);
@@ -1378,7 +1496,7 @@ function registerCourseDraftTools(server, apiClient) {
   );
   server.tool(
     "create_course_exercise",
-    "Create a new exercise directly on a live course. Use this for adding exercises after a course has already been published.",
+    `Create a new exercise directly on a live course. Use this for adding exercises after a course has already been published. ${SUPPORTED_QUESTION_TYPES_GUIDE}`,
     createCourseExerciseShape,
     async (args) => {
       const { courseId, ...payload } = ZCreateCourseExerciseToolInput.parse(args);
@@ -1398,7 +1516,7 @@ function registerCourseDraftTools(server, apiClient) {
   );
   server.tool(
     "update_course_exercise",
-    "Update an existing exercise on a live course, including questions and options.",
+    `Update an existing exercise on a live course, including questions and options. ${SUPPORTED_QUESTION_TYPES_GUIDE}`,
     updateCourseExerciseShape,
     async (args) => {
       const { courseId, exerciseId, ...payload } = ZUpdateCourseExerciseToolInput.parse(args);
@@ -1408,7 +1526,7 @@ function registerCourseDraftTools(server, apiClient) {
   );
   server.tool(
     "update_course_draft",
-    "Update an unpublished draft. If the draft is already published, do not keep editing it blindly; create a fresh draft from the live course first.",
+    `Update an unpublished draft. If the draft is already published, do not keep editing it blindly; create a fresh draft from the live course first. ${LESSON_HTML_GUIDE}`,
     updateCourseDraftShape,
     async (args) => {
       const { draftId, ...payload } = ZUpdateCourseDraftToolInput.parse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classroomio/mcp",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -42,6 +42,7 @@
   "scripts": {
     "build": "tsc --noEmit && rm -rf dist tsconfig.tsbuildinfo && node ./scripts/build.mjs",
     "dev": "tsx src/index.ts",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "format": "prettier --write \"src/**/*.ts\""
   }
 }