LearnWorlds MCP server Let your AI agent run the admin work in LearnWorlds.

ToolWhat it doesAccess

• list_users Users of the school with email, tags and sign-up date, from Users > All users. read

  Returns users the way Users > All users shows them, newest sign-up first. Search by name or email and filter by tag. user_id goes into get_user, enroll_users, unenroll_users, update_tags, send_message and suspend_user. Suspended users are not in this list; they sit on their own Suspended users list and appear only when you pass suspended true.

  MCP calllearnworlds_read → list_users

  REST endpointGET https://cotlet.dev/api/v1/learnworlds/users

  Parameters

  Parameters: list_users

  Name	Type	Description
  query string	string	Part of a name or email.
  tag string	string	Tag name as shown in Users > Tags.
  suspended boolean	boolean	true lists the Suspended users instead. Default: false.
  limit integer	integer	Rows to return.

  Example response

  {
    "users": [
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e601",
        "name": "Lena Fischer",
        "email": "lena.fischer@example.com",
        "tags": [
          "newsletter"
        ],
        "signed_up": "2026-11-03"
      },
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e602",
        "name": "Marco Bianchi",
        "email": "marco.bianchi@example.com",
        "tags": [
          "cohort-autumn"
        ],
        "signed_up": "2026-11-02"
      }
    ]
  }

• get_user One user card: details, tags and the products the user is enrolled in with progress. read

  Opens the user card and returns the profile, the tags and each product the user is enrolled in, with progress and the expiration date where one is set. A course the user finished by hand shows completed_manually true, as the admin dashboard marks it "Completed (Manually)". Use it to check before enrolling or messaging.

  MCP calllearnworlds_read → get_user

  REST endpointGET https://cotlet.dev/api/v1/learnworlds/users/{user_id}

  Parameters

  Parameters: get_user

  Name	Type	Description
  user_id string required	string	user_id from list_users.

  Example input

  {
    "user_id": "user_8c41d2"
  }

  Example response

  {
    "user_id": "5f3a9c1e2b7d4a0011c8e601",
    "name": "Lena Fischer",
    "email": "lena.fischer@example.com",
    "tags": [
      "newsletter"
    ],
    "products": [
      {
        "product": "Photography Basics",
        "progress_percent": 60,
        "completed_manually": false,
        "expires": null
      }
    ]
  }

• update_tags Add or remove tags on users. write

  Adds the tags in add and removes the tags in remove on each listed user. A tag that does not exist yet is created, as when you press Enter in the tags field of the user card. It reaches no one directly and one call with the opposite lists undoes it, so it does not wait for your OK. A tag change can fire the Tag Added and Tag Removed triggers that other tools of your school listen to.

  MCP calllearnworlds_write → update_tags

  REST endpointPATCH https://cotlet.dev/api/v1/learnworlds/tags

  Parameters

  Parameters: update_tags

  Name	Type	Description
  user_ids array required	array	user_id values from list_users.
  add array	array	Tag names to add.
  remove array	array	Tag names to remove.

  Example input

  {
    "user_ids": "user ids"
  }

  Example response

  {
    "updated": [
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e602",
        "name": "Marco Bianchi",
        "tags": [
          "cohort-autumn",
          "graduate"
        ]
      }
    ]
  }

• set_user_suspended Suspend a user or lift a suspension. writeasks first

  Uses Suspend Account on the Users page. A suspended user cannot log in and cannot sign up again with the same email, and moves to the Suspended users list. Suspending does not pause or cancel the user's active payments, so cancel those where you take payments. A call with suspended false lifts it. By default you confirm each call; you can switch that off for this tool.

  MCP calllearnworlds_write → set_user_suspended

  REST endpointPUT https://cotlet.dev/api/v1/learnworlds/users/{user_id}/suspended

  Parameters

  Parameters: set_user_suspended

  Name	Type	Description
  user_id string required	string	user_id from list_users.
  suspended boolean required	boolean	true suspends, false lifts the suspension.

  Example input

  {
    "user_id": "user_8c41d2",
    "suspended": true
  }

  Example response

  {
    "user_id": "5f3a9c1e2b7d4a0011c8e603",
    "name": "Tom Walker",
    "suspended": true
  }

ToolWhat it doesAccess

• list_courses Courses of the school with their ID, status and number of enrolled users. read

  Returns the courses of the school as the Courses page shows them. course_id goes into list_course_users and enroll_users. It reads courses only; bundles and subscription plans are enrolled from the user card and are not covered here.

  MCP calllearnworlds_read → list_courses

  REST endpointGET https://cotlet.dev/api/v1/learnworlds/courses

  Parameters

  Parameters: list_courses

  Name	Type	Description
  query string	string	Part of a course title.

  Example response

  {
    "courses": [
      {
        "course_id": "photography-basics",
        "title": "Photography Basics",
        "status": "published",
        "enrolled": 128
      },
      {
        "course_id": "editing-masterclass",
        "title": "Editing Masterclass",
        "status": "published",
        "enrolled": 54
      }
    ]
  }

• list_course_users Learners of one course with completion date, units completed, certificate date and score. read

  Reads the Course Users tab of the course insights. Each row has the completion date, units completed, certificate date and score, as that tab shows them. Filter by status to get only learners who finished or only those still in progress. Rows are ordered as the tab orders them. Free courses are missing from the Users report export, so this tool reads the course page instead.

  MCP calllearnworlds_read → list_course_users

  REST endpointGET https://cotlet.dev/api/v1/learnworlds/course-users

  Parameters

  Parameters: list_course_users

  Name	Type	Description
  course_id string required	string	course_id from list_courses.
  status enum	enum	completed or in_progress. Default: both.
  limit integer	integer	Rows to return.

  Example input

  {
    "course_id": "course_8c41d2"
  }

  Example response

  {
    "course": "Photography Basics",
    "users": [
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e601",
        "name": "Lena Fischer",
        "units_completed": 9,
        "completion_date": null,
        "certificate_date": null,
        "score": null
      },
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e602",
        "name": "Marco Bianchi",
        "units_completed": 14,
        "completion_date": "2026-11-01",
        "certificate_date": "2026-11-01",
        "score": 88
      }
    ]
  }

• enroll_users Enroll users in one product, with an optional expiration date. writeasks first

  Enrolls the listed users through the Enroll to Product action of the Users page. Each enrollment can carry its own expiration date. The learner gets access to the product at once. A user who is already enrolled is returned in skipped. Subscription plans need the Stripe gateway and are enrolled one user at a time, so they are not part of this tool. By default you confirm each call; you can switch that off for this tool.

  MCP calllearnworlds_write → enroll_users

  REST endpointPOST https://cotlet.dev/api/v1/learnworlds/courses/{course_id}/users/enroll

  Parameters

  Parameters: enroll_users

  Name	Type	Description
  course_id string required	string	course_id from list_courses.
  user_ids array required	array	user_id values from list_users.
  expires string	string	Expiration date, YYYY-MM-DD. Default: no expiration.

  Example input

  {
    "course_id": "photography-basics",
    "user_ids": [
      "5f3a9c1e2b7d4a0011c8e601",
      "5f3a9c1e2b7d4a0011c8e602"
    ],
    "expires": "2027-05-01"
  }

  Example response

  {
    "product": "Photography Basics",
    "enrolled": [
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e601",
        "name": "Lena Fischer"
      },
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e602",
        "name": "Marco Bianchi"
      }
    ],
    "skipped": []
  }

• unenroll_users Remove users from one course. writeasks first

  Unenrolls the listed users from one course. The learners lose access to it. Read the enrollment with get_user first. A Zapier trigger named User Unenrolled From Product fires on the school, so connected automations can react. By default you confirm each call; you can switch that off for this tool.

  MCP calllearnworlds_write → unenroll_users

  REST endpointPOST https://cotlet.dev/api/v1/learnworlds/courses/{course_id}/users/unenroll

  Parameters

  Parameters: unenroll_users

  Name	Type	Description
  course_id string required	string	course_id from list_courses.
  user_ids array required	array	user_id values from list_users.

  Example input

  {
    "course_id": "course_8c41d2",
    "user_ids": "user ids"
  }

  Example response

  {
    "product": "Photography Basics",
    "unenrolled": [
      {
        "user_id": "5f3a9c1e2b7d4a0011c8e602",
        "name": "Marco Bianchi"
      }
    ]
  }

ToolWhat it doesAccess

• list_pending_reviews Assessments waiting for a grade in Courses > Review Center. read

  Returns the Unreviewed tab of the Review Center: the learner, the course, the assessment and when it was submitted. Open-ended questions (text, file upload, record video) wait here for a manual grade. review_id goes into grade_assessment.

  MCP calllearnworlds_read → list_pending_reviews

  REST endpointGET https://cotlet.dev/api/v1/learnworlds/pending-reviews

  Parameters

  Parameters: list_pending_reviews

  Name	Type	Description
  course_id string	string	Only reviews of this course.

  Example response

  {
    "reviews": [
      {
        "review_id": "rv_7d21a4",
        "learner": "Lena Fischer",
        "course": "Photography Basics",
        "assessment": "Final project",
        "submitted": "2026-11-04"
      }
    ]
  }

• grade_assessment Give a score and written feedback on one assessment in the Review Center. writeasks first

  Opens Review Assessment for the review, sets a numeric score and a written comment, and clicks Submit Review. That makes the grade and the feedback visible to the learner. Feedback as a file, audio or video is not part of this tool. By default you confirm each call; you can switch that off for this tool.

  MCP calllearnworlds_write → grade_assessment

  REST endpointPOST https://cotlet.dev/api/v1/learnworlds/reviews/{review_id}/assessment/grade

  Parameters

  Parameters: grade_assessment

  Name	Type	Description
  review_id string required	string	review_id from list_pending_reviews.
  score number required	number	Numeric score for the assessment.
  feedback string	string	Written feedback shown to the learner.

  Example input

  {
    "review_id": "review_8c41d2",
    "score": 1
  }

  Example response

  {
    "review_id": "rv_7d21a4",
    "learner": "Lena Fischer",
    "assessment": "Final project",
    "score": 85,
    "feedback": "Strong composition. Work on exposure in the second shot.",
    "status": "reviewed"
  }

• send_message Send a direct message to one user. writeasks first

  Uses the Send Message action in the three-dot menu of Users > All users. The user receives the message. It sends to one user per call, so the agent loops over a list. Write the subject and body plainly; the tool sends what you give it. By default you confirm each call; you can switch that off for this tool.

  MCP calllearnworlds_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/learnworlds/users/{user_id}/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  user_id string required	string	user_id from list_users.
  subject string required	string	Message subject.
  body string required	string	Message text.

  Example input

  {
    "user_id": "user_8c41d2",
    "subject": "subject",
    "body": "body"
  }

  Example response

  {
    "sent_to": {
      "user_id": "5f3a9c1e2b7d4a0011c8e601",
      "name": "Lena Fischer"
    },
    "subject": "Your project is waiting"
  }