> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to the Mini Course Generator MCP server

The Mini Course Generator MCP connector routes your AI agent's tool calls to Mini Course Generator's own MCP server through Scalekit. Each user signs in to Mini Course Generator once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 73 tools.

**Authentication:** OAuth2.1/DCR
**Categories:** Marketing
**Tools:** 73: 15 read, 45 write, 13 destructive
**Users sign in with:** OAuth
**OAuth app:** Scalekit's or your own
**Built by:** Vendor MCP
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=MINICOURSEGENERATORMCP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Mini Course Generator MCP connection

   In **AgentKit > Connections**, create a Mini Course Generator MCP connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

   Scalekit credentials are available for Mini Course Generator MCP server, so you don't need to register an OAuth app.

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'minicoursegeneratormcp'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Mini Course Generator MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'minicoursegeneratormcp_whoami',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "minicoursegeneratormcp"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Mini Course Generator MCP:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="minicoursegeneratormcp_whoami",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'minicoursegeneratormcp_course_analytics',
  toolInput: {
    courseId: 1,
  },
  connector: 'minicoursegeneratormcp',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="minicoursegeneratormcp_course_analytics",
    tool_input={
        "courseId": 1,
    },
    connection_name="minicoursegeneratormcp",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `minicoursegeneratormcp_course_analytics`

CourseAnalytics · Read-only

Aggregate learner analytics for a Course: how many are assigned, how many engaged, how many completed it, certificates and badges issued, and the mean quiz score. No personal data — counts only. Pass moduleId to narrow the same report to one Module. Start here before reaching for the per-learner lists — and for a public Course this is the ONLY reach figure, because a public Course enrols nobody and so has no learner list at all.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_course_finishers`

CourseFinishers · Read-only

The learners who completed a whole Course, with their mean score, when they finished, and their certificate URL where one was issued. Use `from` to ask only about recent completions. Rows carry the learner's real name and email — the connected shop's own learners. Treat them as personal data: use them to answer what was asked, and do not republish a roster elsewhere.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.
- `from` (`string`, optional): Only learners who finished on or after this ISO 8601 date.
- `page` (`integer`, optional): Zero-based page. Default 0.
- `pageSize` (`integer`, optional): Rows per page. Default 20, max 100.

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_course_learners`

CourseLearners · Read-only

The learners on a Course — one row each with name and email, how far they got, their score, whether they earned the certificate and when they were last active. Paginated (20 per page, max 100). A public Course enrols nobody, so this returns no rows and a `note` saying so — report that note, not "no learners", and use course_analytics for its reach. Rows carry the learner's real name and email — the connected shop's own learners. Treat them as personal data: use them to answer what was asked, and do not republish a roster elsewhere.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `courseId` (`string`, required): Course id from course_list.
- `page` (`integer`, optional): Zero-based page. Default 0.
- `pageSize` (`integer`, optional): Rows per page. Default 20, max 100.

Example input: `{"courseId":"<courseId>"}`

### `minicoursegeneratormcp_course_list`

CourseList · Read-only

List the courses in the connected account (a Course is the top-level program). Paginated — 20 per page by default, 100 max. An account can hold far more courses than one page, so check `hasNextPage` and keep paging before you conclude anything about the whole account; `totalCount` tells you how many there are in total.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.

Example input: `{"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_get_content_format`

GetContentFormat · Read-only

The MCG Course Authoring Guide — how to plan, structure, and write a course, the lesson content format, and landing-page copy. Read it before creating anything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `minicoursegeneratormcp_learner_get`

LearnerGet · Read-only

One learner's full record: every Course they can reach, how far they got in each, their score, when they finished, and whether a certificate was issued — plus per-module detail inside each course. This answers "which courses has this person completed" in one call. Rows carry the learner's real name and email — the connected shop's own learners. Treat them as personal data: use them to answer what was asked, and do not republish a roster elsewhere.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `learner` (`string`, required): The learner's email, username, or the session id from learner_list.
- `startedOnly` (`boolean`, optional): Skip Courses they were given but never opened. Default false.

Example input: `{"learner":"<learner>"}`

### `minicoursegeneratormcp_learner_list`

LearnerList · Read-only

The account's learners across EVERY Course, one row each with how many courses they were given, started and completed. Use this — not a course_learners call per course — to answer questions about people rather than about one course ("who has finished anything", "which of our learners are stalled", "find this person"). `search` matches name, email or username. Paginated (20 per page, max 100). Rows carry the learner's real name and email — the connected shop's own learners. Treat them as personal data: use them to answer what was asked, and do not republish a roster elsewhere.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `completedOnly` (`boolean`, optional): Only learners who completed at least one Course. Default false.
- `page` (`integer`, optional): Zero-based page. Default 0.
- `pageSize` (`integer`, optional): Rows per page. Default 20, max 100.
- `registeredOnly` (`boolean`, optional): Skip anonymous public-link learners, who have no name or email to report. Default false.
- `search` (`string`, optional): Match on name, email or username. Omit for everyone.

Example input: `{}`

### `minicoursegeneratormcp_lesson_get`

LessonGet · Read-only

Get a Lesson (title, type, and the rendered HTML body).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lessonId` (`integer`, required): The integer ID of the lesson to retrieve.

Example input: `{"lessonId":1}`

### `minicoursegeneratormcp_lesson_selections`

LessonSelections · Read-only

Get a quiz/survey Lesson's selections — the authored options (id, text, and whether each is flagged correct). No learner/response data.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lessonId` (`integer`, required): The integer ID of the quiz or survey lesson whose answer options to retrieve.

Example input: `{"lessonId":1}`

### `minicoursegeneratormcp_module_analytics`

ModuleAnalytics · Read-only

Aggregate learner analytics for one Module: assigned, engaged, completed, badges earned and the mean quiz score. No personal data — counts only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `moduleId` (`integer`, required): Module id from module_list.

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_module_answers`

ModuleAnswers · Read-only

One learner's answer to every question in a Module: the question, the options they picked (or the text they typed), which options were correct, and whether they got it right. This is the only tool that returns per-question answers — the analytics and finisher tools carry scores only.

Covers BOTH quiz Lessons and the questions inside activity blocks (crossword, wordle, word search, riddle, jumble, pixel quest, SCORM). Each row says which in `source`, and activity rows carry `blockType`. So this is the whole picture for a module — there is no second tool to call for games.

Two shapes not to misread: `isCorrect: null` means the question is ungraded OR they never reached it — NOT that they got it wrong; and a SCORM row has an `answer` but no question text (it comes back empty), because a SCORM package reports its outcome without telling us what was asked. That is a real answer, not missing data. Rows carry the learner's real name and email — the connected shop's own learners. Treat them as personal data: use them to answer what was asked, and do not republish a roster elsewhere.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `learner` (`string`, required): The learner's email, username, or — for someone who took a public course by link — the session id from learner_list.
- `moduleId` (`integer`, required): Module id from module_list.

Example input: `{"learner":"<learner>","moduleId":1}`

### `minicoursegeneratormcp_module_finishers`

ModuleFinishers · Read-only

The learners who completed one Module, with completion percentage, quiz score, and start/finish times. Use this to see where a specific module is landing. Rows carry the learner's real name and email — the connected shop's own learners. Treat them as personal data: use them to answer what was asked, and do not republish a roster elsewhere.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `moduleId` (`integer`, required): Module id from module_list.
- `from` (`string`, optional): Only learners who finished on or after this ISO 8601 date.
- `page` (`integer`, optional): Zero-based page. Default 0.
- `pageSize` (`integer`, optional): Rows per page. Default 20, max 100.

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_module_get`

ModuleGet · Read-only

Get a Module with its Sections and Lessons (and their ids — needed to edit them). Also reports publish state: the module's `status` (draft | published | published_with_changes), `pendingLessonCount`, and a `status` per lesson. Check this before telling someone a module is live.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `moduleId` (`integer`, required): The numeric id of the module to retrieve. Retrieve it from module_list.

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_module_list`

ModuleList · Read-only

List the Modules inside a Course (each with id, name, and section/lesson counts). courseId is the Course (collection) id from course_list / course_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `courseId` (`string`, required): The id of the course whose modules to list.

Example input: `{"courseId":"<courseId>"}`

### `minicoursegeneratormcp_whoami`

Whoami · Read-only

Returns the MCG account this connection is authenticated as (user id, email, shop id). Use it to confirm you connected the correct account.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `minicoursegeneratormcp_audio_upload`

AudioUpload · Write

Host an audio file on MCG for a lesson `audio` block (narration, a podcast clip, a pronunciation sample). Stage the file with `media_upload_url` (get an upload URL, PUT the file to it), then call this with the returned **`downloadUrl`** as `url`. Returns { documentId, url } — put the **`url`** in the `audio` block. Do NOT put a `media_upload_url` downloadUrl in a lesson: it expires in ~2h, this one is durable. mp3/wav/ogg/flac/aac/m4a/wma.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): Publicly-reachable URL of the audio file — use the `downloadUrl` from media_upload_url.
- `fileName` (`string`, optional): File name (its extension picks the MIME type; defaults to the URL's base name).
- `replaceId` (`string`, optional): Optional documentId to replace, keeping the same hosted url.

Example input: `{"url":"<url>"}`

### `minicoursegeneratormcp_course_add_certificate`

CourseAddCertificate · Write

Add a completion certificate to a Course — learners who finish the whole Course earn it. Creates the default certificate (its copy and pass threshold can be tuned later in the MCG admin UI). Certificates live at the Course level, not per Module.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`string`, required): The id of the course to add a certificate to. Retrieve it from course_list or course_create.

Example input: `{"courseId":"<courseId>"}`

### `minicoursegeneratormcp_course_answers`

Course Answers · Write

Retrieve one learner's per-question responses in a Course (integer courseId), including quiz pages 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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.
- `learner` (`string`, required): The learner's email, username, or — for someone who took a public learning path by link — the session id from learner_list.

Example input: `{"courseId":1,"learner":"<learner>"}`

### `minicoursegeneratormcp_course_create`

CourseCreate · Write

Create a Course — the top-level program. A Course holds several Modules (add them with module_push, one per topic); use module_push directly only for a single standalone topic. Pass `landingPage` (marketing copy) to create the course's landing page with it. See get_content_format.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learningPathId` (`string`, required): Parent Learning path id (a GUID) from learning_path_list.
- `name` (`string`, required): Course name
- `description` (`string`, optional): Optional course description, saved after creation.
- `language` (`string`, optional): ISO language code (default en)

Example input: `{"learningPathId":"<learningPathId>","name":"<name>"}`

### `minicoursegeneratormcp_course_get`

Course Get · Write

Retrieve a Course (integer courseId) in the connected account with its Sections and Pages: sectionIds are GUIDs, pageIds are integers. Returns course and per-page publish status (draft, published, or published_with_changes), pendingPageCount, its parent learningPathId, and authored content. Use to inspect structure or pending changes before editing or publishing.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_course_learner_add`

CourseLearnerAdd · Write

Give someone access to a Course, creating their learner account if this account has never seen them. Pass `email` (and optionally `name`); `username` defaults to the email. Adding someone who is already on the Course is a no-op and comes back with alreadyMember: true. Check `errors` on the result — a non-empty list means they were NOT added. This does not email them; send the course link yourself.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`string`, required): Course id from course_list.
- `email` (`string`, optional): The learner's email address.
- `name` (`string`, optional): The learner's display name — what a certificate is made out to.
- `sendInvite` (`boolean`, optional): Also email them the course's invite with their sign-in link. Default false. Emails a real person — confirm with the user first.
- `username` (`string`, optional): Optional username. Defaults to the email.

Example input: `{"courseId":"<courseId>"}`

### `minicoursegeneratormcp_course_learner_invite`

Course Learner Invite · Write

Email a Course's invite to learners already on it in the connected account, using the course's saved invite subject and body; each learner gets their own sign-in (magic) link. This emails real people — confirm the recipients with the user before calling. Pass up to 20 emails or usernames. Learners not on the course are skipped (add them with course_learner_add first), as are learners without an email address and anyone invited in the last 10 minutes. onlyNotYetInvited (default true) also skips anyone ever sent this invite; set it false to resend. Returns sent and skipped (with a reason for each). Does not change course access.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`string`, required): Course id from course_list.
- `learners` (`array`, required): Emails or usernames of learners already on the Course. At most 20.
- `onlyNotYetInvited` (`boolean`, optional): Skip anyone who was ever sent this course's invite. Default true; false resends.

Example input: `{"courseId":"<courseId>","learners":[]}`

### `minicoursegeneratormcp_course_move`

Course Move · Write

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

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) to move.
- `learningPathId` (`string`, required): Learning path id (a GUID) the course belongs to.
- `order` (`integer`, required): New zero-based position within the learning path (lower comes first)

Example input: `{"courseId":1,"learningPathId":"<learningPathId>","order":1}`

### `minicoursegeneratormcp_course_publish`

Course Publish · Write

Publish a Course (integer courseId) and every Page inside it, including all pending page 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 learning path's access rules, including anyone with the link for public learning paths. Returns publish state and published page count. Repeating the call refreshes the publication timestamp. Use for a request to make the entire course live.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_course_push`

Course Push · Write

Create a new draft Course with its Sections and Pages from a kind: Course YAML spec (apiVersion: mcg.io/v4). Optional spec.landingPage supplies landing-page content; learningPathId (a GUID) overrides the spec's spec.learningPathId as the parent Learning path. Image prompts and landing-page covers can trigger external image generation; page images and generated covers consume MCG AI credits (with insufficient credits the landing page is saved without a cover). Third-party image urls (image blocks, quiz images, landing covers) are copied into MCG storage first, without credits. The course requires course_publish for learner access. dryRun validates and renders page content locally without creating resources or generating images. Normal calls create another course on every retry and may leave partial content if a later step fails. Returns the new courseId (an integer). Optional description is saved separately; failures appear as descriptionWarning. See get_content_format for the spec.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `spec` (`string`, required): The full Course spec as YAML (apiVersion: mcg.io/v4, kind: Course, spec.sections[].pages[]).
- `description` (`string`, optional): Optional course description, saved after creation; ignored for dryRun.
- `dryRun` (`boolean`, optional): Default false. When true, validate the spec and render page content locally without API writes or image generation; returns a plan, not a saved course.
- `learningPathId` (`string`, optional): Optional parent Learning path id (a GUID) to attach the course to (overrides spec.learningPathId).

Example input: `{"spec":"<spec>"}`

### `minicoursegeneratormcp_course_theme`

Course Theme · Write

Replace supplied Course theme settings (integer courseId): layout, typography, colors, and optional background image URL. Omitted settings remain unchanged. Theme changes apply immediately to a published course; learner browsers load the supplied background image URL. Use get_content_format for styling individual page content blocks instead.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.
- `backgroundColor` (`string`, optional): Page background colour as CSS hex
- `bodyBackgroundImage` (`string`, optional): Background image URL loaded by learner browsers; can reference an external host.
- `buttonColor` (`string`, optional): Button colour as CSS hex
- `cardAlignment` (`string`, optional): Vertical alignment of page content: top, center or bottom. One of: `top`, `center`, `bottom`.
- `cardBackgroundColor` (`string`, optional): Content card background colour as CSS hex
- `font` (`string`, optional): Font family, e.g. "Open Sans"
- `fontColor` (`string`, optional): Text colour as CSS hex, e.g. "#1e293b"
- `fontSize` (`string`, optional): S, M or L. One of: `S`, `M`, `L`.
- `layout` (`integer`, optional): 0 default, 1 left/right, 2 native, 3 bottom. One of: `0`, `1`, `2`, `3`.
- `lineHeight` (`string`, optional): S, M or L. One of: `S`, `M`, `L`.

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_course_unpublish`

Course Unpublish · Write

Unpublish a Course (integer courseId) and revoke learner access to it immediately. The learner preview link stops working. Content and progress are retained so the course can be published again. Use for a request to take the whole course offline.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_course_update`

CourseUpdate · Write

Rename a Course or change its description. courseId is the id from course_list / course_create. Only the fields you pass change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.
- `coverImageUrl` (`string`, optional): Use an existing image as the cover/thumbnail: an image_upload url, or any public image url (a third-party image is copied into MCG storage first). No generation, no credits.
- `description` (`string`, optional): New course description
- `language` (`string`, optional): New learner-interface language (ISO code, e.g. en, tr, de)
- `name` (`string`, optional): New course name

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_image_upload`

Image Upload · Write

Download an image from the supplied public URL and host it on MCG storage, adding it to the Media Library. Accepts a staged downloadUrl from media_upload_url. Returns imageId and a durable url to use as a lesson image block's url (instead of prompt): the image is placed as-is, with no AI generation and no AI credits. Each call creates a new image. Supported formats: png, jpg, gif, webp, svg (sanitized: scripts and external references are removed), tiff, and ico. Tools that take an image url copy third-party urls into MCG storage on their own; use this for local files or to get the url first.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): Publicly-reachable URL of the image — any hosted image, or the `downloadUrl` from media_upload_url for a local file.
- `fileName` (`string`, optional): File name to record (defaults to the URL's base name). The format is detected from the image itself; the extension is only a fallback.

Example input: `{"url":"<url>"}`

### `minicoursegeneratormcp_learning_path_add_certificate`

Learning Path Add Certificate · Write

Add the default completion-certificate configuration to a Learning path (learningPathId GUID) in the connected account, or return its existing configuration. New certificates use the default 85% success threshold, adjustable in the MCG admin interface. This configures learning-path-level certificate eligibility; it does not issue or email a certificate to a learner during this call.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.

Example input: `{"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_learning_path_analytics`

Learning Path Analytics · Write

Retrieve aggregate analytics for a Learning path (learningPathId, a GUID) in the connected account: assigned, engaged and completed learners, certificates, badges, and mean quiz score. Optional courseId (an integer) narrows the report to one Course. Returns counts and aggregate scores without learner identities or individual answers. Public learning paths have no enrollment roster; use these engagement figures for their reach.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.
- `courseId` (`integer`, optional): Optional: narrow the report to this Course (an integer id from course_list).

Example input: `{"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_learning_path_create`

Learning Path Create · Write

Create a new Learning path (the top-level program that groups Courses) in the connected MCG account with a default landing page and public-link access. The learning path landing page can be viewed by anyone with its link; Courses are created inside it separately as drafts (course_push or course_create). Optional landingPage YAML supplies custom copy and triggers background cover-image generation through MCG's image provider, unless coverImageUrl or the YAML's cover_image.url names an existing image, which is used as-is with no generation or credits (a third-party image url is first copied into MCG storage). A generated cover consumes MCG AI credits at the page-image rate; if credits are insufficient the landing page is saved without a cover. Returns id (the new learningPathId, a GUID) and previewUrl. Each call creates another learning path, and a later landing-page failure can leave the learning path created. See get_content_format for the YAML format.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Learning path name
- `coverImageUrl` (`string`, optional): Use an existing image as the cover/thumbnail: an image_upload url, or any public image url (a third-party image is copied into MCG storage first). No generation, no credits.
- `description` (`string`, optional): Optional learning path description
- `landingPage` (`string`, optional): Optional landing-page YAML: introduction, audience, learning_outcomes, program_details, keywords, and cover_image: {style, model} to generate a cover or {url} to use an existing image as-is (third-party urls are copied into MCG storage). Saves custom copy and starts cover-image generation unless a url is given; a generated cover consumes AI credits, and without enough credits the page is saved without a cover.

Example input: `{"name":"<name>"}`

### `minicoursegeneratormcp_learning_path_finishers`

Learning Path Finishers · Write

List learners who completed a whole Learning path (learningPathId, a GUID) in the connected account, with identity, mean score, completion time, and certificate URL when issued. Optional from filters by completion date. Paginated: default 20 rows, maximum 100. Contains learner personal data.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.
- `from` (`string`, optional): Only learners who finished on or after this ISO 8601 date.
- `page` (`integer`, optional): Zero-based page. Default 0.
- `pageSize` (`integer`, optional): Rows per page. Default 20, max 100.

Example input: `{"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_learning_path_learner_add`

Learning Path Learner Add · Write

Add a learner to a Learning path's default team (learningPathId, a GUID) in the connected account, creating a learner account if needed. Supply email and/or username; username defaults to email. This grants team-based access to the learning path and its courses without changing its access rule. By default no email is sent. sendInvite: true also emails the learner the learning path's invite (its saved invite subject and body, with their personal sign-in link) — this emails a real person, so confirm with the user before setting it. Returns accountCreated, alreadyMember, and errors; a non-empty errors list means enrollment failed. With sendInvite, inviteSent and inviteError report the email; a learner invited in the last 10 minutes is not emailed again. Existing membership is not duplicated.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.
- `email` (`string`, optional): The learner's email address.
- `name` (`string`, optional): The learner's display name — what a certificate is made out to.
- `sendInvite` (`boolean`, optional): Also email them the learning path's invite with their sign-in link. Default false. Emails a real person — confirm with the user first.
- `username` (`string`, optional): Optional username. Defaults to the email.

Example input: `{"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_learning_path_learner_invite`

Learning Path Learner Invite · Write

Email a Learning path's invite (learningPathId, a GUID) to learners already on it in the connected account, using its saved invite subject and body; each learner gets their own sign-in (magic) link. This emails real people — confirm the recipients with the user before calling. Pass up to 20 emails or usernames. Learners not on the learning path are skipped (add them with learning_path_learner_add first), as are learners without an email address and anyone invited in the last 10 minutes. onlyNotYetInvited (default true) also skips anyone ever sent this invite; set it false to resend. Returns sent and skipped (with a reason for each). Does not change access.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learners` (`array`, required): Emails or usernames of learners already on the Learning path. At most 20.
- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.
- `onlyNotYetInvited` (`boolean`, optional): Skip anyone who was ever sent this learning path's invite. Default true; false resends.

Example input: `{"learners":[],"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_learning_path_learners`

Learning Path Learners · Write

List a Learning path's enrolled learners (learningPathId, a GUID) with identity, progress, score, certificate state, and last activity. Paginated: default 20 rows, maximum 100. Public learning paths have no enrollment roster and return no rows with an explanatory note; this does not mean nobody viewed them. Use learning_path_analytics for engagement. Contains personal data from the connected account.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.
- `page` (`integer`, optional): Zero-based page. Default 0.
- `pageSize` (`integer`, optional): Rows per page. Default 20, max 100.

Example input: `{"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_learning_path_list`

Learning Path List · Write

List the Learning paths in the connected MCG account. Hierarchy: Learning path → Course → Section → Page; a Learning path is the top-level program that groups Courses. Each item's id is a learningPathId (a GUID) for course_list, course_create, and the learning_path_* tools. 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 learning paths.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `page` (`integer`, optional): Zero-based page. Default 0.
- `pageSize` (`integer`, optional): Learning paths per page. Default 20, max 100.

Example input: `{}`

### `minicoursegeneratormcp_learning_path_update`

Learning Path Update · Write

Replace an existing Learning path's name, description, and/or cover image in the connected account. learningPathId is a GUID. Only supplied non-empty fields change; at least one is required. coverImageUrl takes an image_upload url or any public image url (a third-party image is copied into MCG storage first); it replaces the cover, landing-page header image, and thumbnail without generating one. Changes can appear immediately on its public landing page. Does not edit landing-page body copy. To edit a Course (integer courseId) use course_update.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.
- `coverImageUrl` (`string`, optional): Use an existing image as the cover/thumbnail: an image_upload url, or any public image url (a third-party image is copied into MCG storage first). No generation, no credits.
- `description` (`string`, optional): New learning path description
- `name` (`string`, optional): New learning path name

Example input: `{"learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_lesson_create`

LessonCreate · Write

Add a Lesson to an existing Section. For a content lesson, pass `content` in the MCG content-authoring format (a `content:` document) — call get_content_format first. The CLI compiles it to HTML.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `moduleId` (`integer`, required): The integer ID of the module that owns this section.
- `sectionId` (`string`, required): The unique identifier of the section to add the lesson to.
- `title` (`string`, required): The title of the new lesson.
- `content` (`string`, optional): For an info lesson: the body as a content-authoring `content:` YAML document. For a quiz lesson: a YAML with `question:` and `choices:`.
- `type` (`string`, optional): Lesson type — `info` for a content lesson or `quiz` for an interactive quiz lesson. One of: `info`, `quiz`.

Example input: `{"moduleId":1,"sectionId":"<sectionId>","title":"<title>"}`

### `minicoursegeneratormcp_lesson_move`

LessonMove · Write

Reorder a Lesson within its Module by setting its order (lower comes first). Optionally move it into another Section of the same module by passing sectionId. moduleId is the lesson's module.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lessonId` (`integer`, required): The integer ID of the lesson to reorder or move.
- `moduleId` (`integer`, required): The integer ID of the module that owns this lesson.
- `order` (`integer`, required): The new 1-based position of the lesson within its section. Lower numbers appear first.
- `sectionId` (`string`, optional): The section to move the lesson into. Must be a section within the same module. Omit to keep the lesson in its current section.

Example input: `{"lessonId":1,"moduleId":1,"order":1}`

### `minicoursegeneratormcp_lesson_publish`

LessonPublish · Write

Publish one Lesson — a draft lesson goes live, or the pending edits on a live lesson replace what learners are reading. Use this to ship part of a module while leaving unfinished lessons as drafts. Only meaningful inside a published module: publishing a lesson in a draft module shows it to nobody, because the module itself is not on the air (use module_publish first).

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lessonId` (`integer`, required): Lesson id

Example input: `{"lessonId":1}`

### `minicoursegeneratormcp_media_upload_url`

MediaUploadUrl · Write

Stage a media file (a video, a SCORM zip) for upload. Returns a temporary **`uploadUrl`** (presigned PUT) and **`downloadUrl`** (presigned GET, ~2h). Flow: (1) call this with the `fileName` (and `contentType`); (2) **PUT the file's bytes to `uploadUrl`** from your shell — e.g. `curl -T <file> -H "Content-Type: <contentType>" "<uploadUrl>"` — so the bytes go straight to storage and never pass through this conversation; (3) pass `downloadUrl` as the `url` to `video_upload` / `scorm_upload`. Use this for video and SCORM (don't base64 big files).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fileName` (`string`, required): File name to stage, e.g. "welcome.mp4" or "quiz.zip".
- `contentType` (`string`, optional): MIME type to sign the PUT with, e.g. "video/mp4" or "application/zip" (default application/octet-stream).

Example input: `{"fileName":"welcome.mp4"}`

### `minicoursegeneratormcp_module_create`

ModuleCreate · Write

Create an empty Module inside a Course. A Module groups Sections; Sections hold Lessons. courseId is the id from course_list / course_create. Pass a short `description` — modules should always have one. To create a module WITH content in one step, prefer module_push. The module is created as a DRAFT: nobody can reach it until module_publish runs.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`string`, required): The id of the course to add this module to.
- `name` (`string`, required): Module name.
- `description` (`string`, optional): Short module description (1-2 sentences). Always set one.
- `language` (`string`, optional): ISO language code for the learner interface (default en).

Example input: `{"courseId":"<courseId>","name":"<name>"}`

### `minicoursegeneratormcp_module_move`

ModuleMove · Write

Reorder a Module within its Course by setting its zero-based position (lower comes first). The other modules keep their relative order and shift around it, so to place one module you only pass that module — not the whole ordering. Use module_list to see the current order.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `courseId` (`string`, required): Course (collection) id the module belongs to
- `moduleId` (`integer`, required): Module id to move
- `order` (`integer`, required): New zero-based position within the course (lower comes first)

Example input: `{"courseId":"<courseId>","moduleId":1,"order":1}`

### `minicoursegeneratormcp_module_publish`

ModulePublish · Write

Publish a Module: it and every Lesson in it become visible to learners, and its previewUrl starts working. Modules are created as DRAFTS, so a module you just created or pushed is not reachable by anyone until this runs — if you hand someone the link first, it will not work. Publishing is public: only call it when the person has said they want the module live.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `moduleId` (`integer`, required): Module id

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_module_push`

ModulePush · Write

Create one complete Module (sections + lessons) from a `kind: Module` YAML spec — a Module is one focused unit; a full course is several Modules in a Course (see course_create). Include a top-level `landingPage` in the spec. Follow get_content_format for the content format; use dryRun:true to validate. Pass a short `description` — the spec has no description field, so this is how a created module gets one (every module should have a description). The module is created as a DRAFT — the previewUrl it returns will not work for anyone else until module_publish runs. Say so rather than handing over a link that looks broken, and publish only once the person has said they want it live.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `spec` (`string`, required): A `kind: Module` YAML spec defining sections and lessons. See get_content_format for the required structure.
- `courseId` (`string`, optional): The id of the parent course. Retrieve it from course_list or course_create.
- `description` (`string`, optional): Short module description (1-2 sentences).
- `dryRun` (`boolean`, optional): If true, validate the spec without creating anything.

Example input: `{"spec":"<spec>"}`

### `minicoursegeneratormcp_module_theme`

ModuleTheme · Write

Set how the learner sees a Module: page layout, typography and colours. Use it to match an author's brand — they often supply a palette or a style sheet. A merge patch: only the fields you pass change. Colours are CSS hex. Note this themes the whole module; to tint one box inside a lesson use the `background`/`text_color` box fields instead (see get_content_format).

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `moduleId` (`integer`, required): Module id
- `backgroundColor` (`string`, optional): Page background colour as CSS hex
- `bodyBackgroundImage` (`string`, optional): Page background image url
- `buttonColor` (`string`, optional): Button colour as CSS hex
- `cardAlignment` (`string`, optional): top, center or bottom. One of: `top`, `center`, `bottom`.
- `cardBackgroundColor` (`string`, optional): Card background colour as CSS hex
- `font` (`string`, optional): Font family, e.g. "Open Sans"
- `fontColor` (`string`, optional): Text colour as CSS hex, e.g. "#1e293b"
- `fontSize` (`string`, optional): S, M or L. One of: `S`, `M`, `L`.
- `layout` (`integer`, optional): 0 default, 1 left/right, 2 native, 3 bottom. One of: `0`, `1`, `2`, `3`.
- `lineHeight` (`string`, optional): S, M or L. One of: `S`, `M`, `L`.

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_module_update`

ModuleUpdate · Write

Rename a Module, change its description, or change its learner-interface language. Only the fields you pass change. `language` switches the interface chrome (buttons/labels) the learner sees to that language's defaults — it does NOT translate the authored lesson content.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `moduleId` (`integer`, required): Module id
- `coverImageUrl` (`string`, optional): Use an existing image as the cover/thumbnail: an image_upload url, or any public image url (a third-party image is copied into MCG storage first). No generation, no credits.
- `description` (`string`, optional): New module description
- `language` (`string`, optional): New learner-interface language (ISO code, e.g. en, tr, de)
- `name` (`string`, optional): New module name

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_page_create`

Page Create · Write

Create a new draft info or quiz Page in an existing Course (integer courseId) and Section (sectionId GUID from course_get). Info content uses a content: YAML document; quiz content requires question and choices. See get_content_format. Image prompts trigger background generation through MCG's image provider and consume MCG AI credits; third-party `url:` images are copied into MCG storage without credits. Returns the new pageId (an integer). Learner access requires publishing; each call creates another page.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.
- `sectionId` (`string`, required): Section id (a GUID) from course_get.
- `title` (`string`, required): Page title
- `content` (`string`, optional): For an info page: the body as a content-authoring `content:` YAML document. For a quiz page: a YAML with `question:` and `choices:` (each a `text:`, with `correct: true` on the right one). Choices render in the supplied order. A quiz may also carry an optional `image:` (`prompt:`, `alt:`, `model:`, or `url:` for an existing image) above the question. Image prompts trigger generation and consume MCG AI credits; a `url:` image does not.
- `type` (`string`, optional): info (content) or quiz. Default info. One of: `info`, `quiz`.

Example input: `{"courseId":1,"sectionId":"<sectionId>","title":"<title>"}`

### `minicoursegeneratormcp_page_discard_changes`

Page Discard Changes · Write

Discard a Page's unpublished edits (integer pageId) 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 page with published_with_changes status; does not unpublish its live version.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `pageId` (`integer`, required): Page id (an integer) from course_get.

Example input: `{"pageId":1}`

### `minicoursegeneratormcp_page_get`

Page Get · Write

Retrieve a Page (integer pageId) in the connected account, including its title, type, sectionId, and rendered HTML body in text. Does not return the original authoring YAML. Use course_get for publish status and page_selections for authored quiz options.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `pageId` (`integer`, required): Page id (an integer) from course_get.

Example input: `{"pageId":1}`

### `minicoursegeneratormcp_page_move`

Page Move · Write

Replace a Page's saved order within its Course and optionally its Section assignment within the same course. pageId and courseId are integers; sectionId is a GUID. Lower order values come first. These structural changes apply immediately to a published course; they do not wait for page_publish.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) the page belongs to.
- `order` (`integer`, required): New position within the course (lower comes first)
- `pageId` (`integer`, required): Page id (an integer) to move.
- `sectionId` (`string`, optional): Optional: move the page into this Section (a GUID) of the same course.

Example input: `{"courseId":1,"order":1,"pageId":1}`

### `minicoursegeneratormcp_page_publish`

Page Publish · Write

Publish one Page (integer pageId) 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 Course is also published, under the learning path's access rules (public learning paths allow anyone with the link). Use for a request to make this page or its edits live.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `pageId` (`integer`, required): Page id (an integer) from course_get.

Example input: `{"pageId":1}`

### `minicoursegeneratormcp_page_selections`

Page Selections · Write

Retrieve a quiz or survey Page's authored options (integer pageId), including each option's ID, text, and correct-answer flag. Does not return learner responses; use course_answers for one learner's answers.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `pageId` (`integer`, required): Page id (an integer) from course_get.

Example input: `{"pageId":1}`

### `minicoursegeneratormcp_page_unpublish`

Page Unpublish · Write

Unpublish one Page (integer pageId) and revoke learner access to it immediately, while leaving the rest of its Course unchanged. Retains its content, pending edits, ID, and progress records so it can be published again.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `pageId` (`integer`, required): Page id (an integer) from course_get.

Example input: `{"pageId":1}`

### `minicoursegeneratormcp_page_update`

Page Update · Write

Edit a Page's title, its entire body, or a quiz's question and choices (pageId is an integer). At least one non-empty field is required. For an info page, content is an MCG content: YAML document that replaces the whole body. For a quiz page, content is the same YAML page_create accepts (question: and/or choices:, each choice a text: with correct: true on the right one); omit question: or choices: to keep it. choices: is the complete new list, matched to the existing options by position: option ids (and learners' past answers) are preserved, extra choices are added and surplus options removed; returns each option with its status. A content: body sent to a quiz, or content that compiles to an empty body, is rejected rather than overwriting the question. On published pages, text, question and answer-key edits remain pending until page_publish. 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. Third-party `url:` images are copied into MCG storage (no credits). **Keep existing images:** read the page with page_get first and write each image you are keeping as `url: <its img src>` instead of `prompt:` — a `url:` image is placed as-is, never regenerated. Use `prompt:` only for an image that is new or that the user asked to replace. See get_content_format for the content format.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `pageId` (`integer`, required): Page id (an integer) from course_get.
- `content` (`string`, optional): For an info page: the complete replacement body as a content: YAML document. For a quiz page: a YAML with `question:` and/or `choices:` (each a `text:`, with `correct: true` on the right one), the same shape page_create takes; an omitted key keeps the current value. Choices are matched to the existing options by position, keeping their ids. Image prompts generate images and consume AI credits.
- `title` (`string`, optional): New page title

Example input: `{"pageId":1}`

### `minicoursegeneratormcp_scorm_upload`

ScormUpload · Write

Host an interactive SCORM package (an AI-authored, self-contained scored activity) on MCG for a lesson `scorm` block. You generate a SCORM 1.2 zip yourself (a self-contained HTML interactive that reports cmi.core.score/lesson_status via the SCORM API, plus a minimal imsmanifest.xml — read get_content_format's SCORM reporting rules first: report each interaction and commit as it happens, not once at the end, or partial attempts record nothing). Stage the zip with `media_upload_url` (get an upload URL, PUT the file to it), then call this with the returned **`downloadUrl`** as `url`. Returns { packageId, entryPointUrl, title, version, fileName } — put the **`packageId`** (and the returned entryPointUrl/title/version/fileName) in the `scorm` block.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): Publicly-reachable URL of the SCORM .zip — use the `downloadUrl` from media_upload_url.
- `fileName` (`string`, optional): Optional display name for the SCORM package.

Example input: `{"url":"<url>"}`

### `minicoursegeneratormcp_section_create`

SectionCreate · Write

Add a Section to an existing Module.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.
- `title` (`string`, required): Section title

Example input: `{"courseId":1,"title":"<title>"}`

### `minicoursegeneratormcp_section_update`

SectionUpdate · Write

Rename a Section.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sectionId` (`string`, required): The unique identifier of the section to rename.
- `title` (`string`, required): The new title for the section.

Example input: `{"sectionId":"<sectionId>","title":"<title>"}`

### `minicoursegeneratormcp_video_upload`

VideoUpload · Write

Host a video on Vimeo through MCG (server-side — no third-party account needed) for a lesson `video` block. **Any MP4 works** — pass any publicly-reachable video `url` directly, or stage a local file with `media_upload_url` (get an upload URL, PUT the file to it) and pass the returned **`downloadUrl`** as `url`. Returns { shopClipId, clipId, playerUrl } — put the **`shopClipId`** in the `video` block's `shopClipId`. MCG renders its own native player and bakes the playback URL in server-side once Vimeo finishes transcoding.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): Publicly-reachable URL of the video file — any hosted MP4, or the `downloadUrl` from media_upload_url.
- `fileName` (`string`, optional): Optional display name for the video on Vimeo.

Example input: `{"url":"<url>"}`

### `minicoursegeneratormcp_course_delete`

Course Delete · Destructive

Delete a Course (integer courseId) in the connected account together with its Sections and Pages. Removes it from learner access if published. Content cannot be restored through this tool.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `courseId` (`integer`, required): Course id (an integer) from course_list or course_get.

Example input: `{"courseId":1}`

### `minicoursegeneratormcp_course_learner_remove`

CourseLearnerRemove · Destructive

Take someone off a Course. This revokes access only — their account, their progress and any certificate they earned are kept, so adding them back restores where they were. Removing someone who is not on the Course is a no-op and comes back with removed: false.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `courseId` (`string`, required): Course id from course_list.
- `learner` (`string`, required): The learner's email address or username.

Example input: `{"courseId":"<courseId>","learner":"<learner>"}`

### `minicoursegeneratormcp_learning_path_learner_remove`

Learning Path Learner Remove · Destructive

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

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `learner` (`string`, required): The learner's email address or username.
- `learningPathId` (`string`, required): Learning path id (a GUID) from learning_path_list.

Example input: `{"learner":"<learner>","learningPathId":"<learningPathId>"}`

### `minicoursegeneratormcp_lesson_delete`

LessonDelete · Destructive

Delete a Lesson. This is destructive.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `lessonId` (`integer`, required): The integer ID of the lesson to permanently delete.

Example input: `{"lessonId":1}`

### `minicoursegeneratormcp_lesson_discard_changes`

LessonDiscardChanges · Destructive

Throw away a Lesson's unpublished edits and restore the content learners currently see. Irreversible — the working copy is gone, not archived. Only affects a lesson whose status is published_with_changes.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `lessonId` (`integer`, required): Lesson id

Example input: `{"lessonId":1}`

### `minicoursegeneratormcp_lesson_unpublish`

LessonUnpublish · Destructive

Pull one Lesson out of the live module, back to draft. It keeps its content and its id, so learner progress and analytics still line up, but learners no longer see it.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `lessonId` (`integer`, required): Lesson id

Example input: `{"lessonId":1}`

### `minicoursegeneratormcp_lesson_update`

LessonUpdate · Destructive

Edit a Lesson. Pass `title` to rename, and/or `content` (the MCG content-authoring format) to replace the body — the CLI recompiles it to HTML and replaces the whole body. Authoring is always in content-format, never raw HTML; call get_content_format for the spec.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `lessonId` (`integer`, required): The integer ID of the lesson to edit.
- `content` (`string`, optional): Replacement body in the MCG content-authoring format. The CLI compiles it to HTML and replaces the entire existing body. Call get_content_format for the authoring spec. Omit to leave the body unchanged.
- `title` (`string`, optional): New title for the lesson. Omit to leave the title unchanged.

Example input: `{"lessonId":1}`

### `minicoursegeneratormcp_module_delete`

ModuleDelete · Destructive

Delete a Module and all its Sections and Lessons. This is destructive.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `moduleId` (`integer`, required): The numeric id of the module to delete.

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_module_unpublish`

ModuleUnpublish · Destructive

Move a Module back to draft. Learners lose access immediately and the previewUrl stops working. Content and learner progress are kept, so it can be published again.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `moduleId` (`integer`, required): Module id

Example input: `{"moduleId":1}`

### `minicoursegeneratormcp_page_delete`

Page Delete · Destructive

Delete a Page (integer pageId) from the connected account. Removes the page from learner access if published. Its content cannot be restored through this tool.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `pageId` (`integer`, required): Page id (an integer) from course_get.

Example input: `{"pageId":1}`

### `minicoursegeneratormcp_scorm_delete`

ScormDelete · Destructive

Delete a hosted SCORM package. This is destructive: any lesson `scorm` block still referencing this packageId will break, so remove or repoint those lessons first. To swap in a corrected activity, prefer `scorm_replace` — it keeps the packageId and the lessons intact.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `packageId` (`string`, required): SCORM packageId to delete (GUID).

Example input: `{"packageId":"<packageId>"}`

### `minicoursegeneratormcp_scorm_replace`

ScormReplace · Destructive

Correct or update an already-hosted SCORM activity **in place**, keeping the same `packageId`. Every lesson whose `scorm` block references that packageId picks up the new activity with no content edit — so use this instead of deleting and re-adding. Generate the corrected SCORM 1.2 zip, stage it with `media_upload_url`, then call this with the returned `downloadUrl` as `url` and the existing `packageId`.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `packageId` (`string`, required): The existing SCORM packageId to replace (GUID).
- `url` (`string`, required): Publicly-reachable URL of the new SCORM .zip — use the `downloadUrl` from media_upload_url.
- `fileName` (`string`, optional): Optional file name to record (defaults to the URL's base name).

Example input: `{"packageId":"<packageId>","url":"<url>"}`

### `minicoursegeneratormcp_section_delete`

SectionDelete · Destructive

Delete a Section and its Lessons. This is destructive.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `sectionId` (`string`, required): The unique identifier of the section to delete. All lessons inside it will also be permanently deleted.

Example input: `{"sectionId":"<sectionId>"}`

## Related

Other Marketing connectors ([all 98](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
