Once you connect a compatible AI assistant, such as ChatGPT or Claude, to your LearnWorlds school, you can use natural language to retrieve school information and complete supported administrative tasks.
Instead of searching through different areas of your school, ask your assistant questions about courses and learners or request specific actions.
In this article, you'll explore practical examples of using an AI assistant with LearnWorlds through Model Context Protocol (MCP).
Create and organize course content
Use your AI assistant to retrieve course information and help organize your learning content.
For example, you can ask:
- "Show me the sections and activities in my Employee Onboarding course."
- "Create a course structure for new employee onboarding."
- "Help me organize my onboarding course content into sections."
Your assistant can retrieve available course information and perform supported course-authoring actions when changes are allowed.
Manage learners and enrollments
Use your assistant to find learners, review their enrollments, and request supported enrollment actions.
For example, you can ask:
- "Find the learner with the email address example@email.com."
- "Which courses is this learner enrolled in?"
- "Enroll this learner in the Employee Onboarding course."
Your assistant uses the available MCP tools to retrieve learner information or complete supported enrollment actions.
Review learner activity and progress
Ask your assistant about available learner progress and course completion information.
For example, you can ask:
- "Show me the progress information available for this learner."
- "Summarize the available completion information for my Employee Onboarding course."
- "Help me identify learners who may need follow-up based on their progress."
The information your assistant can retrieve depends on the learning progress and reporting tools supported through MCP.
Handle everyday administrative tasks
Your AI assistant can help with administrative workflows that involve retrieving information and performing supported actions.
For example, you could ask:
"Find my Employee Onboarding course and show me its current structure."
After reviewing the information, you could continue the conversation with:
"Help me reorganize the course sections."
Your assistant can use the available LearnWorlds tools to respond to each request, subject to your school's permissions and safety settings.
What your assistant can do in each area
The assistant always works as the school administrator who connected it. It can only see and change what that administrator can, within what was approved at sign-in. Every action runs in one of four ways:
- Read: the assistant looks things up. Nothing changes.
- Create and change: the change runs straight away. New automations are always created turned off.
- Preview first: the assistant shows you exactly what will happen. Nothing changes until it carries out that exact preview.
- Irreversible, off by default: hidden from the assistant until you turn on Allow Irreversible Actions and approve Perform irreversible actions when you connect. These always need a preview too.
| Area | Read | Create and change | Preview first | Irreversible (off by default) |
|---|---|---|---|---|
| Courses and content | Courses, sections, learning units and their content, ebooks, quizzes, question banks, courses licensed through Course Hub | Create courses, sections and units; create ebook units to fill in the course editor; create quizzes or surveys; rename units; update a course's title, description, price, access, categories and cover | Change who can open a section; reorder sections; move units; edit an embed's code | Delete a course unit |
| Learning programs | Programs, their courses, cohorts and pricing tiers | Create or copy programs; add a subscription tier | Rename, publish or unpublish a program; add or remove courses; edit or reorder tiers; change a package's price or sale window | Delete a learning program; archive a pricing tier |
| Learners | Users, profiles, course access, progress, tags, saved segments, custom profile fields | Create users; update a user's email or username; create tags and custom fields; enroll one user; let a suspended user sign in again | Suspend a user; unenroll one user; enroll through a specific package or tier; add or remove tags, for one user or up to 1,000 | Delete a user or tag; merge tags; reset a learner's course progress |
| User groups and seats | Groups, seat offerings, members, progress of background jobs | Create user groups and seat offerings | Change a group; add or remove up to 25 named users; bulk enroll or unenroll | Delete a user group |
| Grading and certificates | Submissions waiting for grading, answers, gradebooks, issued certificates, certificate designs | Give first grades and feedback, one at a time or up to 50 per request | Change a grade that already exists; issue or reissue certificates in bulk | |
| Sales and offers | Payments, invoices, subscriptions, offers, promotions, coupon usage, affiliates and commissions | Create discount offers and coupon codes; stop a coupon from being redeemed | Change a coupon's expiry date or redemption limit; cancel a subscription | |
| Website and funnels | Pages (by search), funnels and funnel templates | Create funnels from templates; upload images for covers | ||
| Community | Spaces, collections, posts and comments | Create spaces | Change a space's settings; add or remove up to 50 members; publish a post as you | Delete a community space; hide community posts |
| Automations | Automations, templates, building blocks, runs and run statistics | Create automations, start from a template, duplicate them | Edit an automation (it turns off unless you choose to keep it on); turn an automation on or off | Delete an automation; replay an automation run |
| Emails and surveys | Mass email campaigns, sent and scheduled | Create standalone surveys | Send a single test email | |
| Live sessions | Scheduled sessions, join links and attendance | |||
| Reports and insights | School health, key numbers, engagement per course, where learners stall, learner progress, built-in AI Insight reports | |||
| School setup and integrations | School settings, roles and what each can do, webhooks | Change your school's name, description, contact details, time zone, country, language, currency or social links; add, update or remove a webhook |
What your assistant can't do through this connection
Some actions aren't available through the School MCP. You can still do all of them in the LearnWorlds admin.
Coming in later releases
- Add content to an ebook or edit an existing one, including games, simulations and flashcards. Your assistant can create an empty ebook unit; add the content in the course editor.
- Create or edit website pages, page sections, SEO details or site templates. Use the site builder.
- Edit the questions of an existing quiz. Your assistant can create new quizzes and surveys.
- Change checkout pages or checkout settings, such as payment methods, taxes or order bumps.
- Add buy buttons.
- Set drip timing for a section.
Kept in the admin to protect your school
- Delete a course or a page.
- Send mass emails to learners. Your assistant can list your campaigns and send you a single test email.
- Change the School MCP settings. You change these yourself in Settings → MCP connections.
Full list of tools
Every tool your assistant can use, by area. The last column shows how each one runs.
| Area | Tool | What it does | How it runs |
|---|---|---|---|
| Getting started | get_school_info | Shows your school's name, web address and currency. | Read |
| Getting started | search_school | Finds courses, learning programs, pages, offers and ebooks by title. | Read |
| Getting started | search_learnworlds_docs | Looks up which tool does a job and how to use it. Helps the assistant pick the right step. | Read |
| Getting started | search | Search entry point used by ChatGPT Deep Research. | Read |
| Getting started | fetch | Opens a result found by search, for ChatGPT Deep Research. | Read |
| Courses and content | list_courses | Lists your courses with access settings and price. | Read |
| Courses and content | list_products | Lists courses and learning programs together. | Read |
| Courses and content | get_course | Shows a course, its pricing and its full outline of sections and units. | Read |
| Courses and content | create_course | Creates a new course. Its landing page is created automatically. | Runs straight away |
| Courses and content | update_course | Changes a course's title, description, access, price, categories, label or cover. | Runs straight away |
| Courses and content | create_course_section | Adds a section (chapter) to a course. | Runs straight away |
| Courses and content | update_course_section | Changes who can open a section: free preview, enrolled learners, coming soon or hidden. | Preview first |
| Courses and content | reorder_course_sections | Puts a course's sections in a new order. | Preview first |
| Courses and content | create_course_unit | Adds a learning unit to a section, such as a video, embed, link or an empty unit to finish in the editor. | Runs straight away |
| Courses and content | update_course_unit | Renames a learning unit. | Runs straight away |
| Courses and content | move_course_unit | Moves a unit within its section or to another section of the same course. Learner progress is kept. | Preview first |
| Courses and content | get_unit_content | Shows what a unit contains, as the learner sees it, including quiz questions and settings. | Read |
| Courses and content | update_unit_content | Changes the code of an embed unit. | Preview first |
| Courses and content | create_ebook | Creates an ebook unit, ready for you to add content in the course editor. | Runs straight away |
| Courses and content | get_interactive_object | Shows an interactive exercise in an ebook, including its code. | Read |
| Courses and content | create_quiz | Creates a graded quiz or an ungraded survey in a course, with its questions and settings. | Runs straight away |
| Courses and content | list_question_banks | Lists your question banks. Reading only. | Read |
| Courses and content | get_question_bank | Shows the questions and choices in a question bank. | Read |
| Courses and content | list_course_hub_licenses | Lists the courses you have licensed from other schools through Course Hub. | Read |
| Courses and content | delete_course_unit | Permanently deletes a learning unit and the learner progress tied to it. | Irreversible · off by default |
| Learning programs | list_learning_programs | Lists your learning programs. | Read |
| Learning programs | get_learning_program | Shows a learning program and its courses in order. | Read |
| Learning programs | create_learning_program | Creates a learning program from courses you already have. | Runs straight away |
| Learning programs | clone_learning_program | Copies a learning program into a new, unpublished draft. | Runs straight away |
| Learning programs | update_learning_program | Renames, publishes or unpublishes a program, or changes its URL or image. | Preview first |
| Learning programs | add_course_to_learning_program | Adds a published course to the end of a program. | Preview first |
| Learning programs | remove_course_from_learning_program | Takes a course out of a program. The course and learner progress are kept. | Preview first |
| Learning programs | list_cohorts | Lists the cohorts of a course or program, with what learners can buy. | Read |
| Learning programs | get_cohort | Shows a cohort in full: packages, prices, tiers and enrolled learners. | Read |
| Learning programs | update_cohort | Changes a program package's price, whether it is on sale, or its sale window. | Preview first |
| Learning programs | list_program_tiers | Lists a program's subscription tiers with price, interval and trial. | Read |
| Learning programs | create_program_tier | Adds a subscription pricing tier to a program. | Runs straight away |
| Learning programs | update_program_tier | Changes a tier's name, price, interval, trial, visibility or included courses. | Preview first |
| Learning programs | reorder_program_tiers | Puts a program's tiers in a new order on its pricing table. | Preview first |
| Learning programs | archive_program_tier | Archives a pricing tier. | Irreversible · off by default |
| Learning programs | delete_learning_program | Deletes or archives a learning program and its payment prices. | Irreversible · off by default |
| Learners | list_users | Lists your learners and admins, with filters. | Read |
| Learners | get_user | Shows a user's profile and the courses they can access. | Read |
| Learners | create_user | Registers a new user in your school. | Runs straight away |
| Learners | update_user | Changes a user's email address or username. | Runs straight away |
| Learners | suspend_user | Suspends a user: they can't sign in, and they leave their user groups. | Preview first |
| Learners | unsuspend_user | Lets a suspended user sign in again. It doesn't restore their role or groups. | Runs straight away |
| Learners | list_course_users | Lists the learners enrolled in a course, with their progress. | Read |
| Learners | get_user_progress | Shows one learner's progress in every course they can access. | Read |
| Learners | get_learner_progress | Shows whether a learner completed a course, their time on it and last activity. | Read |
| Learners | enroll_user | Gives a user access to a course or learning program. | Runs straight away |
| Learners | enroll_user_in_cohort | Gives a user access through a specific package or tier. | Preview first |
| Learners | unenroll_user | Removes a user's access to a course or program. Their account and progress are kept. | Preview first |
| Learners | unenroll_user_from_cohort | Removes a user's access the same way the admin does. No refund is issued. | Preview first |
| Learners | list_tags | Lists your user tags. | Read |
| Learners | create_tag | Creates one or more user tags. | Runs straight away |
| Learners | update_user_tags | Adds tags to or removes tags from one user. The preview shows which automations would start. | Preview first |
| Learners | bulk_update_user_tags | Adds or removes tags for up to 1,000 users at once. | Preview first |
| Learners | list_custom_fields | Lists the extra profile fields your school collects. | Read |
| Learners | create_custom_field | Adds a custom profile field. | Runs straight away |
| Learners | list_user_segments | Lists the audience filters saved in the admin. | Read |
| Learners | list_users_by_segment | Lists the learners who match a saved segment. | Read |
| Learners | delete_user | Permanently deletes a user account. | Irreversible · off by default |
| Learners | delete_tag | Deletes a user tag. | Irreversible · off by default |
| Learners | merge_tags | Merges tags into one, everywhere they are used. | Irreversible · off by default |
| Learners | reset_course_progress | Permanently wipes one learner's progress in one course. | Irreversible · off by default |
| User groups and seats | list_user_groups | Lists your user groups and seat offerings. | Read |
| User groups and seats | get_user_group | Shows one user group or seat offering. | Read |
| User groups and seats | list_user_group_users | Lists the members of a user group or seat offering. | Read |
| User groups and seats | create_user_group | Creates a user group or a seat offering. | Runs straight away |
| User groups and seats | update_user_group | Changes a group's name, courses, tags, seats or member limit. | Preview first |
| User groups and seats | add_users_to_group | Adds up to 25 named users to a group or seat offering. | Preview first |
| User groups and seats | remove_users_from_group | Removes up to 25 named users from a group or seat offering. | Preview first |
| User groups and seats | bulk_enroll_users | Adds many users to a group in one go and enrolls them in its courses. Runs in the background. | Preview first |
| User groups and seats | bulk_unenroll_users | Removes many group members' access to the group's courses. Runs in the background. | Preview first |
| User groups and seats | list_jobs | Lists recent background jobs, such as bulk enrollments. | Read |
| User groups and seats | get_job_status | Shows whether a background job has finished. | Read |
| User groups and seats | delete_user_group | Permanently deletes a user group or seat offering. | Irreversible · off by default |
| Grading and certificates | list_pending_grading | Lists submissions waiting for a teacher's grade. | Read |
| Grading and certificates | list_assessment_submissions | Lists learner submissions to a quiz, assessment or assignment. | Read |
| Grading and certificates | get_submission_detail | Shows one submission with every question and the learner's answers. | Read |
| Grading and certificates | get_course_gradebook | Lists recent graded results for a course. | Read |
| Grading and certificates | grade_submission | Gives a grade and feedback on one answer. Changing an existing grade is irreversible. | Runs straight away |
| Grading and certificates | bulk_grade_submissions | Grades up to 50 answers at once. | Runs straight away |
| Grading and certificates | list_certificates | Lists issued certificates. | Read |
| Grading and certificates | list_certificate_templates | Lists your certificate designs and the courses they belong to. | Read |
| Grading and certificates | bulk_issue_certificates | Issues certificates to up to 50 learners who earned them. | Irreversible · off by default |
| Grading and certificates | reissue_certificate | Retries issuing a digital credential through Accredible or Credly. | Irreversible · off by default |
| Sales and offers | list_payments | Lists payments, by user, product or date. | Read |
| Sales and offers | list_invoices | Lists invoices. | Read |
| Sales and offers | list_subscriptions | Lists recurring subscriptions. | Read |
| Sales and offers | get_subscription | Shows one subscription. | Read |
| Sales and offers | cancel_subscription | Cancels a subscription. | Preview first |
| Sales and offers | list_offers | Lists your offers: discounts, bundles and cart offers. | Read |
| Sales and offers | create_offer | Creates a discount offer, applied automatically. | Runs straight away |
| Sales and offers | list_promotions | Lists your promotions and coupons. | Read |
| Sales and offers | get_promotion | Shows one promotion in full. | Read |
| Sales and offers | create_coupon | Adds a coupon code to a promotion. | Runs straight away |
| Sales and offers | update_coupon | Changes a coupon's expiry date or redemption limit. | Preview first |
| Sales and offers | deactivate_coupon | Stops a coupon code from working, straight away. | Runs straight away |
| Sales and offers | get_coupon_usage | Shows how a coupon code has been used. | Read |
| Sales and offers | list_affiliates | Lists your affiliates. | Read |
| Sales and offers | list_commissions | Lists affiliate commissions. | Read |
| Website and funnels | list_funnels | Lists your funnels and their steps. | Read |
| Website and funnels | get_funnel | Shows one funnel and its pages. | Read |
| Website and funnels | list_funnel_templates | Lists the funnel templates you can start from. | Read |
| Website and funnels | create_funnel | Creates a funnel from a template. You connect its payment step in the site builder. | Runs straight away |
| Website and funnels | create_image_upload | Uploads an image for a course or program cover. | Runs straight away |
| Community | list_community_collections | Lists the folders that group your community spaces. | Read |
| Community | list_community_spaces | Lists your community spaces. | Read |
| Community | create_community_space | Creates a community space. | Runs straight away |
| Community | update_community_space | Changes a space's name, description, access or member permissions. | Preview first |
| Community | add_users_to_community_space | Adds up to 50 users to a space. | Preview first |
| Community | remove_users_from_community_space | Removes up to 50 members from a space. | Preview first |
| Community | list_community_posts | Lists community posts. | Read |
| Community | get_community_post | Shows one post in full with its comments. | Read |
| Community | create_community_post | Publishes a post as you, optionally pinned. Members see it straight away. | Preview first |
| Community | delete_community_space | Deletes a community space. | Irreversible · off by default |
| Community | moderate_community_post | Hides a community post. | Irreversible · off by default |
| Automations | list_automations | Lists your automations and whether each is on. | Read |
| Automations | get_automation | Shows an automation in full and anything that stops it from turning on. | Read |
| Automations | list_automation_capabilities | Lists the triggers, actions and conditions automations can use. | Read |
| Automations | list_automation_templates | Lists ready-made automation templates. | Read |
| Automations | apply_automation_template | Creates an automation from a template. It is always created turned off. | Runs straight away |
| Automations | create_automation | Creates an automation. It is always created turned off. | Runs straight away |
| Automations | duplicate_automation | Copies an automation. | Runs straight away |
| Automations | update_automation | Edits an automation. An edited automation turns off unless you say to keep it on. | Preview first |
| Automations | set_automation_status | Turns an automation on or off. | Preview first |
| Automations | list_automation_runs | Lists the times an automation ran, and for whom. | Read |
| Automations | get_automation_run | Shows one run in full, including any failed steps. | Read |
| Automations | get_automation_stats | Shows run totals for an automation. | Read |
| Automations | delete_automation | Permanently deletes an automation. | Irreversible · off by default |
| Automations | replay_automation_run | Runs an automation again for one learner. | Irreversible · off by default |
| Emails and surveys | list_mass_emails | Lists your sent and scheduled mass email campaigns. | Read |
| Emails and surveys | send_test_email | Sends one real test email of a campaign. | Preview first |
| Emails and surveys | create_survey | Creates a standalone survey or form you can place on a page. | Runs straight away |
| Live sessions | list_live_sessions | Lists scheduled live sessions (Zoom, Google Meet, Webex, Teams). | Read |
| Live sessions | get_live_session | Shows one live session and its join link. | Read |
| Live sessions | get_live_session_attendance | Shows who attended a live session. | Read |
| Reports and insights | get_business_summary | Revenue, refunds, sales and new users for a period. | Read |
| Reports and insights | get_school_dashboard_stats | A quick snapshot of your school's key numbers. | Read |
| Reports and insights | get_school_health_summary | One answer to "how is my school doing". | Read |
| Reports and insights | get_course_engagement_report | Engagement for one course: active learners, time spent, starts and completions. | Read |
| Reports and insights | get_course_unit_funnel | Shows where learners stall, unit by unit. | Read |
| Reports and insights | list_ai_insight_reports | Lists the built-in AI Insight reports you can run. | Read |
| Reports and insights | get_ai_insight_report | Runs one AI Insight report. | Read |
| School setup and integrations | get_school_settings | Shows your school's settings: identity, contact, language, currency and social links. | Read |
| School setup and integrations | update_school_settings | Changes your school's name, description, contact emails, time zone, country, language, currency or social links. | Preview first |
| School setup and integrations | list_roles | Lists the roles in your school. | Read |
| School setup and integrations | get_permission_matrix | Explains what each role can do. | Read |
| School setup and integrations | list_webhook_endpoints | Lists the webhooks you have set up. | Read |
| School setup and integrations | list_webhook_event_types | Lists the events a webhook can send. | Read |
| School setup and integrations | set_webhook_endpoint | Adds or changes the webhook for one event, sending that data to your URL. | Preview first |
| School setup and integrations | delete_webhook_endpoint | Removes the webhook for one event. | Preview first |
FAQs
- Can I use my AI assistant to perform every LearnWorlds action?
No. MCP supports a defined set of tools and actions.
- What happens if I request an unsupported action?
Your assistant may explain that it cannot complete the request with the available tools.
- Can I ask questions without allowing changes?
Yes. An administrator can turn off Allow Connectors to Make Changes under Settings → MCP connections.
- Can I ask my assistant to perform irreversible actions?
Only when the operation is supported, Allow Irreversible Actions is enabled, and you approved Perform irreversible actions when connecting the assistant. Applicable previews and safeguards still apply.
- Why doesn't my assistant see every tool in the list above?
What the assistant sees depends on how you connected it. A read-only or single-area connection shows fewer tools, and irreversible tools stay hidden until you turn them on. Ask your assistant: "What can you do in my school with this connection?" If something you expected is missing, reconnect with the full connection address.