Connection check
verified live · 26h ago
hivelearn-mcp
Read and author HiveLearn courses, events, quizzes, certificates, resources, leaderboards, tracks.
Tools
57
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http, stdio
Last checked
26h ago
Tools & capabilities
57 toolsRead from the running server on 26h ago.
hivelearn_add_track_course
track_id*course_id*sort_order*is_requiredunlock_after_course_id
Add a course to a track at a given position. sort_order sets the order within the track. Set unlock_after_course_id to a prerequisite course that must be completed first (omit/null… Add a course to a track at a given position. sort_order sets the order within the track. Set unlock_after_course_id to a prerequisite course that must be completed first (omit/null for no gate). is_required defaults to true.
hivelearn_create_certificate
user_id*course_id*expires_atfinal_scorecompletion_dateinstructor_name
Issue a certificate of completion to a user for a course. Normally the platform auto-issues on course completion — use this tool for bulk backfill or manual awards. Issue a certificate of completion to a user for a course. Normally the platform auto-issues on course completion — use this tool for bulk backfill or manual awards.
hivelearn_create_course
tagstitle*difficultyvisibilitydescriptionthumbnail_url
+4
Create an empty course (no modules/lessons). Prefer hivelearn_create_course_outline when you already know the structure — it scaffolds course + modules + lesson placeholders in one… Create an empty course (no modules/lessons). Prefer hivelearn_create_course_outline when you already know the structure — it scaffolds course + modules + lesson placeholders in one call.
hivelearn_create_course_outline
tagstitle*modules*difficultyvisibilitydescription
+5
Scaffold an entire course in one call: course + modules + lesson placeholders (title/description only, no content yet). After this, loop over the returned lesson ids with hivelearn… Scaffold an entire course in one call: course + modules + lesson placeholders (title/description only, no content yet). After this, loop over the returned lesson ids with hivelearn_update_lesson_content to fill in video/document URLs. This is the preferred first step when authoring a new course from a plan.
hivelearn_create_enrollment
user_id*course_id*
Enroll a user in a course. Both user_id and course_id must belong to the authenticated community. Duplicate enrollments are rejected. Enroll a user in a course. Both user_id and course_id must belong to the authenticated community. Duplicate enrollments are rejected.
hivelearn_create_event
tagstitle*end_date*locationtimezoneevent_type*
+7
Create a calendar event. Dates are ISO 8601 strings in UTC. For virtual events set meeting_url; for in-person set location. event_type controls which field the UI shows. Create a calendar event. Dates are ISO 8601 strings in UTC. For virtual events set meeting_url; for in-person set location. event_type controls which field the UI shows.
hivelearn_create_lesson
title*course_id*module_idis_previewsort_ordercontent_url*
+7
Add a lesson to a course. content_type must match content_url (e.g. youtube URL → content_type:youtube). Set module_id=null to leave the lesson unassigned; otherwise pass a module… Add a lesson to a course. content_type must match content_url (e.g. youtube URL → content_type:youtube). Set module_id=null to leave the lesson unassigned; otherwise pass a module uuid from list_course_modules.
hivelearn_create_module
title*course_id*sort_order
Add a module to a course. sort_order is optional — server auto-appends if omitted. Add a module to a course. sort_order is optional — server auto-appends if omitted.
hivelearn_create_post
contentcategorycontent_jsoncontent_format
Publish a new post to the community feed. Either content (markdown) or content_json (tiptap) is required. content_format must match which field you sent. category is optional — omi… Publish a new post to the community feed. Either content (markdown) or content_json (tiptap) is required. content_format must match which field you sent. category is optional — omit for default "general".
hivelearn_create_quiz
title*lesson_id*descriptionmax_attemptspassing_scoreshuffle_questions
+1
Create a quiz attached to a lesson. passing_score is 0-100 (percent). Omit time_limit_seconds or max_attempts for unlimited. Create a quiz attached to a lesson. passing_score is 0-100 (percent). Omit time_limit_seconds or max_attempts for unlimited.
hivelearn_create_quiz_question
pointsoptionsquiz_id*sort_orderexplanationquestion_text*
+2
Add a question to a quiz. For multiple_choice: pass options as an array of { text, is_correct } objects — at least one must be is_correct:true. For true_false: omit options and set… Add a question to a quiz. For multiple_choice: pass options as an array of { text, is_correct } objects — at least one must be is_correct:true. For true_false: omit options and set correct_answer (boolean).
hivelearn_create_resource
tagspricetitle*file_urlfolder_idis_premium
+6
Add a resource to the community library. Supply either resource_url (external link) or file_url (already-uploaded file) — at least one is required. price must be > 0 if set (omit f… Add a resource to the community library. Supply either resource_url (external link) or file_url (already-uploaded file) — at least one is required. price must be > 0 if set (omit for free). access_level defaults to public.
hivelearn_create_track
title*descriptionis_featuredis_publishedthumbnail_urlestimated_hours
+1
Create a learning track (curated course sequence). After this, add courses in order with hivelearn_add_track_course. is_published defaults to false — publish once the curriculum is… Create a learning track (curated course sequence). After this, add courses in order with hivelearn_add_track_course. is_published defaults to false — publish once the curriculum is set.
hivelearn_get_certificate
id*
Fetch one certificate by id. Includes verification_code and download URL. Fetch one certificate by id. Includes verification_code and download URL.
hivelearn_get_community_me
Returns the community the current API key is scoped to. Use this first whenever you need the community_id, owner, slug, or tier — the API key determines tenancy, you cannot switch… Returns the community the current API key is scoped to. Use this first whenever you need the community_id, owner, slug, or tier — the API key determines tenancy, you cannot switch community.
hivelearn_get_course
id*
Fetch one course with full metadata (description, instructor, tags, flags). For the lesson tree use hivelearn_get_course_structure instead. Fetch one course with full metadata (description, instructor, tags, flags). For the lesson tree use hivelearn_get_course_structure instead.
hivelearn_get_course_gradebook
limitoffsetuser_idcourse_id*
Quiz-score gradebook for a course: per-user quiz attempts, scores, pass/fail. Use for analytics or grading dashboards. Quiz-score gradebook for a course: per-user quiz attempts, scores, pass/fail. Use for analytics or grading dashboards.
hivelearn_get_course_progress
limitoffsetuser_idcourse_id*
Aggregate lesson-completion progress for a course across enrolled users. Returns per-user percent_complete, last_accessed_at, completed_lesson_count. Aggregate lesson-completion progress for a course across enrolled users. Returns per-user percent_complete, last_accessed_at, completed_lesson_count.
hivelearn_get_course_structure
id*
Return a compact titles-only tree of the course: course → modules → lessons. Ideal for agents to plan reorders, spot empty lessons, or summarize a course. Does NOT include lesson b… Return a compact titles-only tree of the course: course → modules → lessons. Ideal for agents to plan reorders, spot empty lessons, or summarize a course. Does NOT include lesson body content.
hivelearn_get_enrollment
id*
Fetch one enrollment with status and progress. Fetch one enrollment with status and progress.
hivelearn_get_event
id*
Fetch one event by id with full description and RSVP metadata. Fetch one event by id with full description and RSVP metadata.
hivelearn_get_leaderboard
limitoffsetperiod
Ranked member leaderboard for the community. period chooses the window: all_time (default), 30_day, or 7_day. Each entry carries rank and the points for the selected period, plus l… Ranked member leaderboard for the community. period chooses the window: all_time (default), 30_day, or 7_day. Each entry carries rank and the points for the selected period, plus level info.
hivelearn_get_member
id*
Fetch a single member by profile uuid. Returns the same fields as list_members for one row. Fetch a single member by profile uuid. Returns the same fields as list_members for one row.
hivelearn_get_member_points
user_id*
Full points breakdown for one member (by auth user id) in the community: total, per-category (posts/comments/events/courses/engagement), period totals, level. 404 if the member has… Full points breakdown for one member (by auth user id) in the community: total, per-category (posts/comments/events/courses/engagement), period totals, level. 404 if the member has no points record here.
hivelearn_get_post
id*
Fetch one post with full content. Reply thread is NOT included — this is the post itself only. Fetch one post with full content. Reply thread is NOT included — this is the post itself only.
hivelearn_get_quiz
id*
Fetch one quiz with metadata (passing_score, time_limit, max_attempts). Questions are NOT included — use hivelearn_list_quiz_questions. Fetch one quiz with metadata (passing_score, time_limit, max_attempts). Questions are NOT included — use hivelearn_list_quiz_questions.
hivelearn_get_resource
id*
Fetch one published resource by id, with joined author. 404 if unpublished or in another community. Fetch one published resource by id, with joined author. 404 if unpublished or in another community.
hivelearn_get_track
id*
Fetch one learning track by id with full metadata. For its ordered curriculum use hivelearn_list_track_courses. Fetch one learning track by id with full metadata. For its ordered curriculum use hivelearn_list_track_courses.
hivelearn_get_track_progress
limitoffsettrack_id*
Per-member progress through a learning track: enrolled_at, started_at, completed_at, total_courses, completed counts. Use for cohort/track analytics. Per-member progress through a learning track: enrolled_at, started_at, completed_at, total_courses, completed counts. Use for cohort/track analytics.
hivelearn_list_certificates
limitoffsetuser_idcourse_id
List issued certificates, optionally scoped to one user or one course. Returns id, user, course, verification_code, status, issued_at. List issued certificates, optionally scoped to one user or one course. Returns id, user, course, verification_code, status, issued_at.
hivelearn_list_course_lessons
course_id*module_id
List lessons of a course, optionally filtered to one module. Use hivelearn_get_course_structure for a nested tree. List lessons of a course, optionally filtered to one module. Use hivelearn_get_course_structure for a nested tree.
hivelearn_list_course_modules
course_id*
List modules (sections) of a course, ordered by sort_order. Modules group lessons; a course has 1..N modules. List modules (sections) of a course, ordered by sort_order. Modules group lessons; a course has 1..N modules.
hivelearn_list_courses
limitoffsetstatus
List courses in the authenticated community. status=published returns only courses visible to learners. Returns id, title, visibility, is_published, thumbnail_url, timestamps. List courses in the authenticated community. status=published returns only courses visible to learners. Returns id, title, visibility, is_published, thumbnail_url, timestamps.
hivelearn_list_enrollments
limitoffsetuser_idcourse_id
List course enrollments, optionally scoped to one course or one user. Returns enrollment_id, user_id, course_id, status, progress %, enrolled_at, completed_at. List course enrollments, optionally scoped to one course or one user. Returns enrollment_id, user_id, course_id, status, progress %, enrolled_at, completed_at.
hivelearn_list_events
limitoffsetupcoming
List community events. Use upcoming=true for future events only (recommended for calendar UI). Returns id, title, start/end dates, event_type, location/meeting_url, attendee counts… List community events. Use upcoming=true for future events only (recommended for calendar UI). Returns id, title, start/end dates, event_type, location/meeting_url, attendee counts.
hivelearn_list_members
rolelimitoffset
List members of the authenticated community. Returns id (profile uuid), role, email, display_name, avatar_url, and joined_at. Filter by role to find admins/owners. List members of the authenticated community. Returns id (profile uuid), role, email, display_name, avatar_url, and joined_at. Filter by role to find admins/owners.
hivelearn_list_posts
limitoffsetcategory
List community feed posts, newest first. Use category to filter (e.g. "announcements"). Returns id, title, content, category, author, reply counts, timestamps. List community feed posts, newest first. Use category to filter (e.g. "announcements"). Returns id, title, content, category, author, reply counts, timestamps.
hivelearn_list_quiz_questions
quiz_id*
List all questions for a quiz, ordered by sort_order. Each question carries its options and correct answer. List all questions for a quiz, ordered by sort_order. Each question carries its options and correct answer.
hivelearn_list_quizzes
limitoffsetcourse_idlesson_id
List quizzes, optionally scoped to a course or a specific lesson. Each quiz belongs to one lesson. List quizzes, optionally scoped to a course or a specific lesson. Each quiz belongs to one lesson.
hivelearn_list_resources
limitoffsetfolder_idaccess_levelresource_type
List published resources in the authenticated community, newest first. Filter by folder_id, resource_type, or access_level. Returns id, title, resource_type, resource_url/file_url,… List published resources in the authenticated community, newest first. Filter by folder_id, resource_type, or access_level. Returns id, title, resource_type, resource_url/file_url, access_level, counts (downloads, views, favorites), author. The internal storage key is never exposed.
hivelearn_list_track_courses
track_id*
Return the ordered curriculum of a track: its courses with sort_order, is_required, and unlock_after_course_id (prerequisite gating). Return the ordered curriculum of a track: its courses with sort_order, is_required, and unlock_after_course_id (prerequisite gating).
hivelearn_list_tracks
limitoffset
List published learning tracks (curated course sequences) in the community, newest first. Returns id, title, description, difficulty_level, estimated_hours, flags. List published learning tracks (curated course sequences) in the community, newest first. Returns id, title, description, difficulty_level, estimated_hours, flags.
hivelearn_publish_course
id*
Publish a course: sets is_published=true after validating that every lesson has content_url. Returns error if any lesson is still empty — run hivelearn_get_course_structure to diag… Publish a course: sets is_published=true after validating that every lesson has content_url. Returns error if any lesson is still empty — run hivelearn_get_course_structure to diagnose.
hivelearn_reorder_module_lessons
module_id*lesson_ids*
Set the full lesson order within a module in one atomic call. Pass the desired final order as lesson_ids — every lesson currently in the module must appear exactly once. Set the full lesson order within a module in one atomic call. Pass the desired final order as lesson_ids — every lesson currently in the module must appear exactly once.
hivelearn_update_certificate
id*status*
Change a certificate status. Use "revoked" to invalidate (verify endpoint will reject). Change a certificate status. Use "revoked" to invalidate (verify endpoint will reject).
hivelearn_update_course
id*tagstitleis_pinneddifficultyvisibility
+8
Edit course metadata. Use hivelearn_publish_course instead of setting is_published=true directly — publish runs validation. Edit course metadata. Use hivelearn_publish_course instead of setting is_published=true directly — publish runs validation.
hivelearn_update_event
id*tagstitleend_datelocationtimezone
+9
Edit an event. Set is_cancelled=true to cancel (preserves history). Set max_attendees=null to lift the cap. Edit an event. Set is_cancelled=true to cancel (preserves history). Set max_attendees=null to lift the cap.
hivelearn_update_lesson
id*titlemodule_idis_previewsort_ordercontent_url
+7
Edit lesson metadata or move it between modules. To edit ONLY the content body use hivelearn_update_lesson_content (narrower scope, safer). Edit lesson metadata or move it between modules. To edit ONLY the content body use hivelearn_update_lesson_content (narrower scope, safer).
hivelearn_update_lesson_content
id*content_urldescriptioncontent_jsoncontent_typethumbnail_url
+2
Replace just the content of a lesson — URL, content_type, and optional description/duration/thumbnail. Narrower than update_lesson; safe for bulk agent writes. Does NOT change titl… Replace just the content of a lesson — URL, content_type, and optional description/duration/thumbnail. Narrower than update_lesson; safe for bulk agent writes. Does NOT change title, sort_order, or module assignment.
hivelearn_update_member
id*roleis_banned
Change a member's role or ban status. role accepts member/moderator/admin (owner cannot be assigned via the API). Set is_banned=true to ban, false to lift. At least one field requi… Change a member's role or ban status. role accepts member/moderator/admin (owner cannot be assigned via the API). Set is_banned=true to ban, false to lift. At least one field required.
hivelearn_update_module
id*titlesort_order
Rename or reorder a module. To reorder lessons within a module use hivelearn_reorder_module_lessons. Rename or reorder a module. To reorder lessons within a module use hivelearn_reorder_module_lessons.
hivelearn_update_post
id*contentcategoryis_pinnedcontent_jsoncontent_format
Edit an existing post. Only include fields you want to change. Use is_pinned to pin/unpin a post from the top of the feed. Edit an existing post. Only include fields you want to change. Use is_pinned to pin/unpin a post from the top of the feed.
hivelearn_update_quiz
id*titledescriptionmax_attemptspassing_scoreshuffle_questions
+1
Edit quiz settings. Cannot move a quiz to a different lesson — create a new one instead. Edit quiz settings. Cannot move a quiz to a different lesson — create a new one instead.
hivelearn_update_quiz_question
id*pointsoptionssort_orderexplanationquestion_text
+2
Edit a question. Changing question_type will require resupplying options or correct_answer to match the new type. Edit a question. Changing question_type will require resupplying options or correct_answer to match the new type.
hivelearn_update_resource
id*tagspricetitlefile_urlfolder_id
+8
Edit a resource. Only include fields you want to change. Set is_featured to surface it; set is_published=false to unlist. Edit a resource. Only include fields you want to change. Set is_featured to surface it; set is_published=false to unlist.
hivelearn_update_track
id*titledescriptionis_featuredis_publishedthumbnail_url
+2
Edit a learning track. Only include fields you want to change. Set is_published=true to make it live. Edit a learning track. Only include fields you want to change. Set is_published=true to make it live.
hivelearn_verify_certificate
code*