HiveLearn
@hivelearn
关于 HiveLearn
Read and author HiveLearn communities, courses, events, quizzes, and certificates.
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"hivelearn": {
"command": "npx",
"args": [
"-y",
"hivelearn-mcp"
],
"env": {
"HIVELEARN_API_KEY": "hl_live_YOUR_KEY_HERE"
}
}
}
}工具
43Returns 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.
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.
Fetch a single member by profile uuid. Returns the same fields as list_members for one row.
List community feed posts, newest first. Use category to filter (e.g. "announcements"). Returns id, title, content, category, author, reply counts, timestamps.
Fetch one post with full content. Reply thread is NOT included — this is the post itself only.
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".
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.
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.
Fetch one event by id with full description and RSVP metadata.
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.
Edit an event. Set is_cancelled=true to cancel (preserves history). Set max_attendees=null to lift the cap.
List courses in the authenticated community. status=published returns only courses visible to learners. Returns id, title, visibility, is_published, thumbnail_url, timestamps.
Fetch one course with full metadata (description, instructor, tags, flags). For the lesson tree use hivelearn_get_course_structure instead.
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.
Edit course metadata. Use hivelearn_publish_course instead of setting is_published=true directly — publish runs validation.
List modules (sections) of a course, ordered by sort_order. Modules group lessons; a course has 1..N modules.
Add a module to a course. sort_order is optional — server auto-appends if omitted.
Rename or reorder a module. To reorder lessons within a module use hivelearn_reorder_module_lessons.
List lessons of a course, optionally filtered to one module. Use hivelearn_get_course_structure for a nested tree.
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.
Edit lesson metadata or move it between modules. To edit ONLY the content body use hivelearn_update_lesson_content (narrower scope, safer).
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.
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.
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.
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.
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.
List quizzes, optionally scoped to a course or a specific lesson. Each quiz belongs to one lesson.
Fetch one quiz with metadata (passing_score, time_limit, max_attempts). Questions are NOT included — use hivelearn_list_quiz_questions.
Create a quiz attached to a lesson. passing_score is 0-100 (percent). Omit time_limit_seconds or max_attempts for unlimited.
Edit quiz settings. Cannot move a quiz to a different lesson — create a new one instead.
List all questions for a quiz, ordered by sort_order. Each question carries its options and 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).
Edit a question. Changing question_type will require resupplying options or correct_answer to match the new type.
List course enrollments, optionally scoped to one course or one user. Returns enrollment_id, user_id, course_id, status, progress %, enrolled_at, completed_at.
Fetch one enrollment with status and progress.
Enroll a user in a course. Both user_id and course_id must belong to the authenticated community. Duplicate enrollments are rejected.
Aggregate lesson-completion progress for a course across enrolled users. Returns per-user percent_complete, last_accessed_at, completed_lesson_count.
Quiz-score gradebook for a course: per-user quiz attempts, scores, pass/fail. Use for analytics or grading dashboards.
List issued certificates, optionally scoped to one user or one course. Returns id, user, course, verification_code, status, issued_at.
Fetch one certificate by id. Includes verification_code and download URL.
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.
Change a certificate status. Use "revoked" to invalidate (verify endpoint will reject).
Public verification lookup by verification_code. Returns { valid, certificate } if found and active. Use this when a third party presents a certificate code.
概览
What is HiveLearn?
HiveLearn is the official MCP server for the HiveLearn all-in-one community and LMS platform. It enables AI agents to read and author communities, courses, modules, lessons, events, quizzes, question banks, certificates, and members through the HiveLearn public REST API.
How to use HiveLearn?
Install via npm by adding a stdio config entry using npx -y hivelearn-mcp with the HIVELEARN_API_KEY environment variable. Alternatively, connect via the Streamable HTTP transport at https://mcp.hivelearn.app using the X-Hivelearn-Api-Key header. Obtain an API key from the HiveLearn admin panel (Admin → API Keys) — keys require a Pro, Scale, Enterprise, or Pioneer tier community.
Key features of HiveLearn
- Build courses at conversation speed
- Moderate and grow communities
- Run quizzes with question banks and attempts
- Issue certificates programmatically
- Supports stdio and Streamable HTTP transports
- Authenticates via API key header or environment variable
Use cases of HiveLearn
- Scaffold outlines, drop in lesson content, reorder modules, and publish courses
- Query members, read posts, and manage events in a community
- Create question banks, build quizzes, and pull attempts and scores
- Generate completion certificates for learners automatically
FAQ from HiveLearn
What transport protocols does HiveLearn MCP support?
It supports stdio (for Claude Desktop, Cursor, Windsurf) and Streamable HTTP at https://mcp.hivelearn.app.
How do I get an API key for HiveLearn?
Sign in to your HiveLearn community, go to Admin → API Keys, and create a new key. The key format is hl_live_....
What HiveLearn tier is required to use the MCP server?
The API key requires a Pro, Scale, Enterprise, or Pioneer tier community.
Can I use the HiveLearn MCP server without an internet connection?
No. The server connects to the HiveLearn public REST API, so an internet connection and a valid API key are required.
Where can I find additional documentation?
Full MCP documentation is at https://hivelearn.app/mcp, public API docs at https://hivelearn.app/api-docs, and the source code on GitHub at https://github.com/hivelearn/community-hub.
其他 分类下的更多 MCP 服务器
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
Codelf
unbugA search tool helps dev to solve the naming things problem.
ICSS
chokcoco不止于 CSS
评论