mcp server

HiveLearn

Read and author HiveLearn courses, events, quizzes, certificates, resources, leaderboards, tracks.

Description as published by the maintainer. Source

• version 0.3.0
• active

active — Registry entry last updated 2026-06-23.

What this server can do

57 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

hivelearn_add_track_course(track_id, course_id, sort_order, is_required, unlock_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 for no gate). is_required defaults to true. Required: track_id, course_id, sort_order.

hivelearn_create_certificate(user_id, course_id, expires_at, final_score, completion_date, instructor_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. Required: user_id, course_id.

hivelearn_create_course(tags, title, difficulty, visibility, description, thumbnail_url, instructor_name, description_json, description_format, instructor_avatar_url)

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. Required: title.

hivelearn_create_course_outline(tags, title, modules, difficulty, visibility, description, thumbnail_url, instructor_name, description_json, description_format, instructor_avatar_url)

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. Required: title, modules.

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. Required: user_id, course_id.

hivelearn_create_event(tags, title, end_date, location, timezone, event_type, start_date, description, meeting_url, max_attendees, cover_image_url, description_json, description_format)

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. Required: title, event_type, start_date, end_date.

hivelearn_create_lesson(title, course_id, module_id, is_preview, sort_order, content_url, description, content_json, content_type, is_published, thumbnail_url, content_format, duration_seconds)

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. Required: course_id, title, content_url.

hivelearn_create_module(title, course_id, sort_order)

Add a module to a course. sort_order is optional — server auto-appends if omitted. Required: course_id, title.

hivelearn_create_post(content, category, content_json, content_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 — omit for default "general".

hivelearn_create_quiz(title, lesson_id, description, max_attempts, passing_score, shuffle_questions, time_limit_seconds)

Create a quiz attached to a lesson. passing_score is 0-100 (percent). Omit time_limit_seconds or max_attempts for unlimited. Required: lesson_id, title.

hivelearn_create_quiz_question(points, options, quiz_id, sort_order, explanation, question_text, question_type, correct_answer)

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). Required: quiz_id, question_text, question_type.

hivelearn_create_resource(tags, price, title, file_url, folder_id, is_premium, description, access_level, is_published, resource_url, resource_type, cover_image_url)

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. Required: title.

hivelearn_create_track(title, description, is_featured, is_published, thumbnail_url, estimated_hours, difficulty_level)

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. Required: title.

hivelearn_get_certificate(id)

Fetch one certificate by id. Includes verification_code and download URL. Required: id.

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 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. Required: id.

hivelearn_get_course_gradebook(limit, offset, user_id, course_id)

Quiz-score gradebook for a course: per-user quiz attempts, scores, pass/fail. Use for analytics or grading dashboards. Required: course_id.

hivelearn_get_course_progress(limit, offset, user_id, course_id)

Aggregate lesson-completion progress for a course across enrolled users. Returns per-user percent_complete, last_accessed_at, completed_lesson_count. Required: course_id.

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 body content. Required: id.

hivelearn_get_enrollment(id)

Fetch one enrollment with status and progress. Required: id.

hivelearn_get_event(id)

Fetch one event by id with full description and RSVP metadata. Required: id.

hivelearn_get_leaderboard(limit, offset, period)

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. Required: id.

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 no points record here. Required: user_id.

hivelearn_get_post(id)

Fetch one post with full content. Reply thread is NOT included — this is the post itself only. Required: id.

hivelearn_get_quiz(id)

Fetch one quiz with metadata (passing_score, time_limit, max_attempts). Questions are NOT included — use hivelearn_list_quiz_questions. Required: id.

hivelearn_get_resource(id)

Fetch one published resource by id, with joined author. 404 if unpublished or in another community. Required: id.

hivelearn_get_track(id)

Fetch one learning track by id with full metadata. For its ordered curriculum use hivelearn_list_track_courses. Required: id.

hivelearn_get_track_progress(limit, offset, track_id)

Per-member progress through a learning track: enrolled_at, started_at, completed_at, total_courses, completed counts. Use for cohort/track analytics. Required: track_id.

hivelearn_list_certificates(limit, offset, user_id, course_id)

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. Required: course_id.

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. Required: course_id.

hivelearn_list_courses(limit, offset, status)

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(limit, offset, user_id, course_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.

hivelearn_list_events(limit, offset, upcoming)

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(role, limit, offset)

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(limit, offset, category)

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. Required: quiz_id.

hivelearn_list_quizzes(limit, offset, course_id, lesson_id)

List quizzes, optionally scoped to a course or a specific lesson. Each quiz belongs to one lesson.

hivelearn_list_resources(limit, offset, folder_id, access_level, resource_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, 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). Required: track_id.

hivelearn_list_tracks(limit, offset)

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 diagnose. Required: id.

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. Required: module_id, lesson_ids.

hivelearn_update_certificate(id, status)

Change a certificate status. Use "revoked" to invalidate (verify endpoint will reject). Required: id, status.

hivelearn_update_course(id, tags, title, is_pinned, difficulty, visibility, description, is_featured, is_published, thumbnail_url, instructor_name, description_json, description_format, instructor_avatar_url)

Edit course metadata. Use hivelearn_publish_course instead of setting is_published=true directly — publish runs validation. Required: id.

hivelearn_update_event(id, tags, title, end_date, location, timezone, event_type, start_date, description, meeting_url, is_cancelled, max_attendees, cover_image_url, description_json, description_format)

Edit an event. Set is_cancelled=true to cancel (preserves history). Set max_attendees=null to lift the cap. Required: id.

hivelearn_update_lesson(id, title, module_id, is_preview, sort_order, content_url, description, content_json, content_type, is_published, thumbnail_url, content_format, duration_seconds)

Edit lesson metadata or move it between modules. To edit ONLY the content body use hivelearn_update_lesson_content (narrower scope, safer). Required: id.

hivelearn_update_lesson_content(id, content_url, description, content_json, content_type, thumbnail_url, content_format, duration_seconds)

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. Required: id.

hivelearn_update_member(id, role, is_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 required. Required: id.

hivelearn_update_module(id, title, sort_order)

Rename or reorder a module. To reorder lessons within a module use hivelearn_reorder_module_lessons. Required: id.

hivelearn_update_post(id, content, category, is_pinned, content_json, content_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. Required: id.

hivelearn_update_quiz(id, title, description, max_attempts, passing_score, shuffle_questions, time_limit_seconds)

Edit quiz settings. Cannot move a quiz to a different lesson — create a new one instead. Required: id.

hivelearn_update_quiz_question(id, points, options, sort_order, explanation, question_text, question_type, correct_answer)

Edit a question. Changing question_type will require resupplying options or correct_answer to match the new type. Required: id.

hivelearn_update_resource(id, tags, price, title, file_url, folder_id, is_premium, description, is_featured, access_level, is_published, resource_url, resource_type, cover_image_url)

Edit a resource. Only include fields you want to change. Set is_featured to surface it; set is_published=false to unlist. Required: id.

hivelearn_update_track(id, title, description, is_featured, is_published, thumbnail_url, estimated_hours, difficulty_level)

Edit a learning track. Only include fields you want to change. Set is_published=true to make it live. Required: id.

hivelearn_verify_certificate(code)

Public verification lookup by verification_code. Returns { valid, certificate } if found and active. Use this when a third party presents a certificate code. Required: code.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.hivelearn.app. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.hivelearn.app.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/hivelearn/community-hub
• Website — https://hivelearn.app/mcp
• npm: hivelearn-mcp
• Remote endpoint (streamable-http) — https://mcp.hivelearn.app