Escape hatch: call any Moodle Web Services function with arbitrary parameters. Returns { data } on success, structured meta.code + isError: true on failure. Prefer high-level facades when they cover your use case.

Publish a LessonPlan markdown file as a Moodle section with component modules. Idempotent: republishing the same lesson updates in place, never duplicates. Default mode is hidden. Use publish_preview + confirm_preview for the preview workflow.

Publish a LessonPlan in hidden preview mode. Returns the same shape as publish_class_lesson plus preview_url the teacher can open to review. Students will not see anything until confirm_preview is called.

Make a previewed section visible to students. Propagates visibility to all modules inside the section. Idempotent.

Generate a short Italian-language video with Google Veo 3.1 and embed it in a new mod_page in Moodle. Requires GEMINI_API_KEY env. Returns { cmid, video_url, page_url }. Takes ~1 minute end-to-end for a lite 8s clip.

Delete a Moodle course module by idnumber. By default only deletes MCP-managed idnumbers (mcp: prefix). Use force=true to delete any idnumber. Returns noop if the module does not exist.

Create a new section in a course with a given name, summary, position and initial visibility. Idempotent by name: reusing an existing section name returns that section instead of creating a duplicate.

Update a course section (name/summary/visible) identified by section_id. At least one field is required. Visibility propagates to all modules inside the section.

Hide a course section (and its modules) from students. Visibility propagates to all modules inside the section.

Make a course section visible to students (reverse of hide_section).

Reorder sections in a course. Accepts an array of {section_id, position} and applies the full deterministic layout in one batched call.

Duplicate all modules from a source section into a new section in the same course. New section is named per the name param. Idempotent: returns "exists" if a section with that name already exists.

Returns a compact radiograph of a Moodle course: metadata, sections with module counts, recent MCP-published lessons, and enrolment counts (teachers vs students). Call this before publishing a lesson so the agent knows where it fits.

Create a new Moodle course with a stable idnumber. Throws MOODLE_WS_COURSE_EXISTS if the idnumber is already in use. Default: hidden (visible=false), topics format, 10 sections.

Update one or more fields of a course (fullname / shortname / summary / visible / lang / categoryid). At least one field is required.

Clone a course into a new one (backup+restore under the hood). Defaults copy activities/blocks/filters, NOT users/enrolments/grades. New course is hidden by default.

Archive (visible=0) or un-archive (visible=1) a course. Non-destructive: data, enrolments and teacher access stay intact. Use it for end-of-year cleanup or hiding a course in preparation.

List courses where a user is enrolled. Accepts userid (e.g. obtain from get_site_info for the bot, or pass a student_id-mapped Moodle userid).

Create or update a quiz shell (no questions). Idempotent by slug. Default: hidden, unlimited attempts, grade=10, method=highest. The plugin resolves section_num (section number) to section ID internally. Combine with import_gift to populate questions, or use publish_exam_lesson for both in one call.

Import GIFT-formatted questions into a quiz. Creates the questions in a bank category and appends them to the quiz slots by default. Idempotent (plugin dedupes by question name within the category).

Edit an existing question (typo fix, reformulation, feedback tweak). Writes directly to DB, bypass Moodle 5.0.2 qbank form bug. Input: course_id, question_id, optional name / question_text / answers[]. Coverage: name, text, answers (answer/feedback/fraction).

Create or update a quiz and populate it with GIFT questions in one call. Runs plugin repair+promote steps after import so the quiz is immediately attemptable. Idempotent by (course_id, slug).

List all questions attached to a quiz (identified by its slug). Read-only. Returns question id, name, type, and slot number for each question.

List enrolled users in a course. Filter by role shortname (default: student). Returns id, fullname, email, lastaccess, roles and groups per user.

Batch-enrol users in a course from a CSV (email,firstname,lastname[,role]). Creates missing users by default with a random temp password. Returns per-row status.

Unenrol one or more users from a course. Non-destructive: user data is preserved, only the course enrolment link is removed.

Create a group inside a course. Use assign_to_group to populate it after.

Add one or more users to a group by group_id.

Assign a course-level role to a user (student / teacher / editingteacher / manager). Does NOT unassign previous roles — Moodle supports multiple roles per user per context.

Reset a user's password. If new_password is omitted, generates a random strong one and returns it (you MUST forward to the user out-of-band).

Get gradebook entries for a user in a course (or for every enrolled user if user_id is omitted). Returns raw/max grade, item name, module type, feedback.

Activity completion status for a user in a course: per cmid, the state (incomplete / complete / complete_pass / complete_fail) plus completion timestamp.

Quiz attempts for a user on a given quiz. Default: only finished attempts. Set include_review=true to also fetch per-question details (heavier).

Submissions for an assignment (default: only submitted state). Optionally fetch per-user grading status.

Manually grade an assignment submission (mod_assign_save_grade). Feedback text is HTML-safe. Supports team grading and marking workflow state.

Send a private Moodle message to one or more user ids. Max 50 recipients per call. Uses core_message_send_instant_messages.

Post a new discussion in a course forum. If forum_id is omitted, uses the course Announcements (type=news) forum.

Create or update a forum (discussion, announcement, Q&A, etc.) in a course section. Idempotent by slug. Default: hidden forum of type "general". Requires the plugin companion.

Approximate activity log for a course: per-user firstaccess/lastaccess derived from core_enrol_get_enrolled_users. Flags users active within the last N hours (default 24). Moodle core does not expose a generic activity-log WS.

Get site + user + token info (core_webservice_get_site_info). Use include_functions=true at bootstrap to verify which plugin WS functions are exposed to the token.

Create a calendar event. Default eventtype=course. Set repeat_count>0 to create weekly recurrences. Returns the created event id and metadata.

List calendar events by courses/groups/categories, optionally filtered by a timestart/timeend range.

Reschedule a calendar event to a new timestart. To change name/description/location, delete + re-create (Moodle WS does not expose full event update).

Delete one or more calendar events. Set delete_repeats=true to remove repeat instances as well.

List badges earned by a user. Optionally filtered by course_id. Read-only — awarding badges is deferred to v0.6.