Mini Course Generator

Add a new Section to an existing Module in the connected account. Sections group Lessons. Section structure is not held as a draft, so it can change the outline of a published module immediately. Each call creates another section.

section_create

Delete a hosted SCORM package and its files. Any lesson referencing the packageId, including a live lesson, will no longer be able to load the activity. This tool provides no restore operation. Use scorm_replace when the request is to update an existing package instead.

scorm_delete

Delete a Lesson from the connected account. Removes the lesson from learner access if published. Its content cannot be restored through this tool.

lesson_delete

Delete a Module in the connected account together with its Sections and Lessons. Removes it from learner access if published. Content cannot be restored through this tool.

module_delete

Delete a Section and its Lessons from a Module in the connected account. Removes that content from learner access if published. The deleted content cannot be restored through this tool.

section_delete

Discard a Lesson's unpublished edits and restore its published version as the working copy. Removes draft content, newly added draft options, and pending option/setting changes without an undo operation. Intended for a lesson with published_with_changes status; does not unpublish its live version.

lesson_discard_changes

Retrieve a Lesson in the connected account, including its title, type, sectionId, and rendered HTML body in text. Does not return the original authoring YAML. Use module_get for publish status and lesson_selections for authored quiz options.

lesson_get

Retrieve a Module in the connected account with its Sections, Lessons, and their IDs. Returns module and per-lesson publish status (draft, published, or published_with_changes), pendingLessonCount, and authored content. Use to inspect structure or pending changes before editing or publishing.

module_get

Retrieve a quiz or survey Lesson's authored options, including each option's ID, text, and correct-answer flag. Does not return learner responses; use module_answers for one learner's answers.

lesson_selections

Download an existing SCORM 1.2 ZIP package from the supplied public URL and host it on MCG. Accepts a staged downloadUrl from media_upload_url. Does not author the activity or ZIP. Returns packageId, entryPointUrl, title, version, and fileName for a lesson scorm block. Each call creates a new hosted package; it does not publish a lesson. See get_content_format for package requirements.

scorm_upload

Download an audio file from the supplied public URL and host it on MCG storage. Accepts a staged downloadUrl from media_upload_url. Returns documentId and a durable url for a lesson audio block. Optional replaceId overwrites an existing audio document at the same hosted URL, affecting every lesson that uses it, including live lessons. Without replaceId each call creates a new document. Supported extensions include mp3, wav, ogg, flac, aac, m4a, mp4, and wma.

audio_upload

Import a video from a publicly reachable file URL into MCG's Vimeo hosting account. Vimeo fetches the supplied URL and transcodes the video asynchronously. Accepts a staged downloadUrl from media_upload_url after the file has been uploaded. Returns shopClipId, clipId, and playerUrl; use shopClipId in a lesson video block. Playback may not be ready when the call returns. Each call creates a new hosted video; it does not publish a lesson.

video_upload

Retrieve one learner's per-question responses in a Module, including quiz lessons and supported activity blocks (crossword, wordle, word search, riddle, jumble, pixel quest, and SCORM). Returns selected options or text answers and grading where available; source and blockType identify the activity. isCorrect: null means ungraded or unanswered, not an incorrect answer. SCORM responses can lack question text. Contains learner personal data from the connected account.

module_answers

Retrieve one learner's course and per-module progress in the connected account, including scores, completion times, and certificate state. startedOnly excludes assigned courses the learner has not opened. Accepts email, username, or an anonymous session identifier returned by learner_list. Contains learner personal data.

learner_get

List courses in the connected MCG account. A Course is a top-level program containing Modules. Returns a page of items with totalCount and hasNextPage; default page size is 20, maximum 100. Retrieve further pages when the requested result requires all courses.

course_list

List learners across courses in the connected account with identity and counts of courses enrolled, started, and completed. search matches name, email, or username; completedOnly and registeredOnly narrow the results. Paginated: default 20 rows, maximum 100. Anonymous public-link learners have a session identifier and no name or email. Contains learner personal data.

learner_list

List the Modules in an existing Course in the connected account, including IDs, names, section/lesson counts, and module publish status. Use module_get for the Sections, Lessons, and pending edits within one module.

module_list

Retrieve aggregate analytics for one Module in the connected account: assigned, engaged and completed learners, badges, and mean quiz score. Returns counts and aggregate scores without learner identities or individual answers.

module_analytics

List learners who completed a Module in the connected account, with identity, progress, quiz score, and start/finish times. Optional from filters by completion date. Paginated: default 20 rows, maximum 100. Contains learner personal data.

module_finishers

Replace a Lesson's saved order within its Module and optionally its Section assignment within the same module. Lower order values come first. These structural changes apply immediately to a published module; they do not wait for lesson_publish.

lesson_move

Publish one Lesson or apply its pending edits to the live version. Overwrites previous live content and can remove quiz options without retaining the prior version. Learners can see it only if its Module is also published, under the course's access rules (public courses allow anyone with the link). Use for a request to make this lesson or its edits live.

lesson_publish

Publish a Module and every Lesson inside it, including all pending lesson edits. Pending edits overwrite the previous live content and can remove quiz options; this tool does not retain the previous version. Learners gain access under the course's access rules, including anyone with the link for public courses. Returns publish state and published lesson count. Repeating the call refreshes the publication timestamp. Use for a request to make the entire module live.

module_publish

Remove a learner from every team granting access to a Course in the connected account. Revokes team-based access and can also remove access to other courses shared by those teams. Does not block public-link access to public courses. Retains the learner account, progress, and certificates; re-adding to this course does not restore all prior team memberships. Returns removed: false when no matching membership exists. Does not send email.

course_learner_remove

Replace a Section's title in the connected account. Section titles are not held as drafts; the new title can appear immediately in a published module.

section_update

Change a Module's zero-based position within its Course. Other modules retain their relative order and shift around it. This replaces the saved ordering and can immediately change the sequence shown to learners. Use module_list to inspect the current order.

module_move

Download a replacement SCORM 1.2 ZIP from the supplied public URL and overwrite an existing hosted package, retaining its packageId. Every lesson referencing that package, including live lessons, uses the replacement without a separate lesson edit or publish step. Existing package files are replaced; this tool provides no rollback. Repeating the call downloads and processes the source again, which may have changed.

scorm_replace

Replace supplied Module theme settings: layout, typography, colors, and optional background image URL. Omitted settings remain unchanged. Theme changes apply immediately to a published module; learner browsers load the supplied background image URL. Use get_content_format for styling individual lesson content blocks instead.

module_theme

Issue temporary signed upload and download URLs for a new file location on MCG storage (about two hours). Grants a temporary upload capability but does not upload file bytes or host a finished media asset. A client capable of HTTP PUT must upload the bytes to uploadUrl using the matching contentType before passing downloadUrl to video_upload, audio_upload, or scorm_upload. Returns key, contentType, and expiresAt as well as the URLs. Each call issues URLs for a new location.

media_upload_url

Unpublish one Lesson and revoke learner access to it immediately, while leaving the rest of its Module unchanged. Retains its content, pending edits, ID, and progress records so it can be published again.

lesson_unpublish

Unpublish a Module and revoke learner access to it immediately. The learner preview link stops working. Content and progress are retained so the module can be published again. Use for a request to take the whole module offline.

module_unpublish

Replace an existing Course's name and/or description in the connected account. Only supplied non-empty fields change; at least one is required. Changes can appear immediately on its public landing page. Does not edit landing-page body copy.

course_update

Replace a Lesson's title and/or entire body. At least one non-empty field is required. content must be an MCG content: YAML document, not raw HTML or quiz question/choices YAML; this tool does not update quiz selections. On published lessons, ordinary text edits remain pending until publishing. Image prompts also trigger external image generation, consume MCG AI credits, and can modify the stored live image body. Repeating image-bearing updates can generate and charge again. See get_content_format for the content format.

lesson_update

Replace a Module's name, description, and/or learner-interface language. At least one non-empty field is required; omitted fields remain unchanged. Language resets interface labels to that language's defaults, including previously customized labels, and does not translate lesson text. These settings can change immediately for learners of a published module.

module_update

Return the authenticated Mini Course Generator account's user ID, email, workspace ID, and granted scopes. Use to check which account is connected; no account settings are changed.

whoami