AI agents that actually build your community.
Connect Claude, Cursor, or any MCP-compatible AI to HiveLearn in 60 seconds. Your assistant can draft courses, schedule events, answer member questions, and issue certificates, using the same public API you'd use yourself.
What is MCP?
Model Context Protocol is an open standard for connecting AI assistants to real systems: databases, APIs, file systems, and SaaS products. Think of it as "USB-C for AI": one cable, many devices.
The HiveLearn MCP server exposes 96 tools across 19 domains. Any MCP-compatible assistant (Claude Desktop, Claude Code, Cursor, IDE integrations) can read your community data and take actions on your behalf, with per-key scopes and rate limits.
Connect in 3 steps
About two minutes. You need a HiveLearn community on Pro or above.
Create an API key
In your community, open Admin → API Keys → Create Key. Pick the scopes your assistant needs, such as read:members or write:courses. Copy the key right away. It's shown only once.
Paste your key here
Optional. Your key stays in this browser tab and is never sent anywhere. It just fills in the copy-ready config below.
Add HiveLearn to your app
- Install Node.js (the LTS version) if you don't have it. Claude Desktop uses it to run the small HiveLearn connector on your computer.
- In Claude Desktop, open Settings → Developer → Edit Config. This opens
claude_desktop_config.json. - Paste the config below. If the file already has an
mcpServerssection, add thehivelearnentry inside it instead. - Save, then quit Claude Desktop completely (Cmd+Q on Mac, or right-click the tray icon and choose Quit on Windows). Reopen it.
{
"mcpServers": {
"hivelearn": {
"command": "npx",
"args": [
"-y",
"hivelearn-mcp"
],
"env": {
"HIVELEARN_API_KEY": "hl_live_YOUR_KEY_HERE"
}
}
}
}- Run this once in your terminal. It makes HiveLearn available in every project.
- Start Claude Code and type
/mcp. HiveLearn should show as connected.
claude mcp add --transport http --scope user hivelearn https://mcp.hivelearn.app \ --header "X-Hivelearn-Api-Key: hl_live_YOUR_KEY_HERE"
- Open (or create)
mcp.jsonin the.cursorfolder in your home directory. - Paste the config below, or add the
hivelearnentry to your existingmcpServers. - Save. HiveLearn shows a green dot in the MCP list when it connects.
{
"mcpServers": {
"hivelearn": {
"url": "https://mcp.hivelearn.app",
"headers": {
"X-Hivelearn-Api-Key": "hl_live_YOUR_KEY_HERE"
}
}
}
}Any app that supports MCP over Streamable HTTP with custom headers can connect directly:
- Server URL:
https://mcp.hivelearn.app - Header:
X-Hivelearn-Api-Key: hl_live_YOUR_KEY_HERE - Or:
Authorization: Bearer hl_live_YOUR_KEY_HERE
If the app can only start local servers, or can't send custom headers, use the same config as Claude Desktop. It runs npx -y hivelearn-mcp with your key in HIVELEARN_API_KEY.
Check it works
Ask your assistant: "Which HiveLearn community am I connected to?" It should answer with your community's name.
Troubleshooting
The tools show up, but every request fails with "Missing API key"
Your app connected without sending the key. This happens with Claude Desktop's "Add custom connector" screen, and with a url entry in claude_desktop_config.json. Claude Desktop only runs local servers from that file, so use the npx config from the Claude Desktop tab.
HiveLearn never appears in Claude Desktop
First make sure you fully quit and reopened the app. If it still doesn't appear, Claude Desktop may not be finding Node.js. Run which npx in Terminal (or where npx on Windows) and put that full path in "command" instead of "npx".
"API key format is invalid" or "Unauthorized"
The key was sent but HiveLearn didn't accept it. Check you copied the whole key with no spaces, and that it hasn't been revoked under Admin → API Keys. If in doubt, create a new key.
A request fails with "Missing required scope"
The key works but wasn't given the scope that tool needs. Create a key with the extra scope, such as write:courses. AI course generation needs generate:ai_courses, which is never included by default.
Tool Catalog
Full OpenAPI spec🏛️ Community
1 tool- hivelearn_get_community_me
👥 Members
3 tools- hivelearn_list_members
- hivelearn_get_member
- hivelearn_update_member
🗂️ CRM
9 tools- hivelearn_list_member_notes
- hivelearn_create_member_note
- hivelearn_list_member_tags
- hivelearn_create_member_tag
- hivelearn_list_member_tag_assignments
- hivelearn_add_member_tag
- hivelearn_list_segments
- hivelearn_list_segment_members
- hivelearn_get_member_health
📝 Posts
6 tools- hivelearn_list_posts
- hivelearn_get_post
- hivelearn_create_post
- hivelearn_update_post
- hivelearn_list_post_comments
- hivelearn_create_post_comment
💬 Discussions
5 tools- hivelearn_list_discussions
- hivelearn_get_discussion
- hivelearn_create_discussion
- hivelearn_list_discussion_replies
- hivelearn_create_discussion_reply
📅 Events
6 tools- hivelearn_list_events
- hivelearn_get_event
- hivelearn_create_event
- hivelearn_update_event
- hivelearn_list_event_attendees
- hivelearn_list_event_waitlist
🎓 Courses
7 tools- hivelearn_list_courses
- hivelearn_get_course
- hivelearn_create_course
- hivelearn_update_course
- hivelearn_publish_course
- hivelearn_get_course_structure
- hivelearn_create_course_outline
📚 Modules
4 tools- hivelearn_list_course_modules
- hivelearn_create_module
- hivelearn_update_module
- hivelearn_reorder_module_lessons
📖 Lessons
4 tools- hivelearn_list_course_lessons
- hivelearn_create_lesson
- hivelearn_update_lesson
- hivelearn_update_lesson_content
✅ Quizzes
8 tools- hivelearn_list_quizzes
- hivelearn_get_quiz
- hivelearn_create_quiz
- hivelearn_update_quiz
- hivelearn_list_quiz_questions
- hivelearn_create_quiz_question
- hivelearn_update_quiz_question
- hivelearn_list_quiz_attempts
🗃️ Question Banks
7 tools- hivelearn_list_question_banks
- hivelearn_get_question_bank
- hivelearn_create_question_bank
- hivelearn_update_question_bank
- hivelearn_list_question_bank_items
- hivelearn_create_question_bank_item
- hivelearn_update_question_bank_item
📝 Assignments
3 tools- hivelearn_list_assignment_submissions
- hivelearn_get_assignment_submission
- hivelearn_grade_assignment_submission
🎟️ Enrollments
5 tools- hivelearn_list_enrollments
- hivelearn_get_enrollment
- hivelearn_create_enrollment
- hivelearn_get_course_progress
- hivelearn_get_course_gradebook
🏅 Certificates
5 tools- hivelearn_list_certificates
- hivelearn_get_certificate
- hivelearn_create_certificate
- hivelearn_update_certificate
- hivelearn_verify_certificate
📦 Resources
8 tools- hivelearn_list_resources
- hivelearn_get_resource
- hivelearn_create_resource
- hivelearn_update_resource
- hivelearn_list_resource_folders
- hivelearn_get_resource_folder
- hivelearn_create_resource_folder
- hivelearn_update_resource_folder
🏆 Leaderboard
2 tools- hivelearn_get_leaderboard
- hivelearn_get_member_points
🧭 Learning Tracks
7 tools- hivelearn_list_tracks
- hivelearn_get_track
- hivelearn_create_track
- hivelearn_update_track
- hivelearn_list_track_courses
- hivelearn_add_track_course
- hivelearn_get_track_progress
📊 Analytics
2 tools- hivelearn_get_analytics_summary
- hivelearn_get_course_analytics
🤖 AI Course Builder
4 tools- hivelearn_get_ai_credits
- hivelearn_list_ai_jobs
- hivelearn_get_ai_job
- hivelearn_generate_ai_course
No delete_* tools are exposed. Agents can draft, publish, and unpublish, but they can't destroy content.
What You Can Ask
"Draft a 4-module course called "Launch on Product Hunt" with 3 lessons each, but don't publish yet."
calls → create_course_outline
"Turn this YouTube talk into a course, but check how many AI credits I have first."
calls → get_ai_credits, generate_ai_course, get_ai_job
"Show the gradebook for "Intro to Capacitor" and who is below 70%."
calls → get_course_gradebook
"Find members enrolled in "Intro to Capacitor" and show how far along each one is."
calls → list_enrollments, get_course_progress
"Schedule a live Q&A next Thursday at 6pm ET and announce it in the feed."
calls → create_event, create_post
"How did the community do in the last 30 days, and which course has the lowest completion rate?"
calls → get_analytics_summary, get_course_analytics
"Who RSVPed to Thursday's Q&A, and who is still on the waitlist?"
calls → list_event_attendees, list_event_waitlist
"Publish course abc-123 now that all lessons are ready."
calls → publish_course
Security
- Keys are hashed server-side (SHA-256). Plaintext shown once at creation. Rotate or revoke any time.
- Per-key scopes. Grant only what the agent needs (read:members, write:courses, etc).
- Per-community tenancy. The key determines the community. An agent cannot read or write another community's data.
- Rate-limited and logged. Every tool call is tracked per key in your admin panel.
- No delete tools. The worst an agent can do is unpublish. Content is never permanently removed.
FAQ
Which plan do I need?
API keys are available on Pro, Scale, Enterprise, and pioneer communities. Any plan can use MCP once keys are issued.
Does this work with ChatGPT or Gemini?
MCP is an open standard. Any compliant client works. Claude Desktop, Claude Code, Cursor, and Zed all support it natively today. ChatGPT and Gemini are adding support progressively.
Can I call the API without an AI assistant?
Yes. Every MCP tool is backed by the public REST API, and the same key works there. See the REST API docs for endpoints and a first request you can copy.
What happens if the agent hits a rate limit?
The MCP client surfaces the error to the model, which typically backs off and retries. Rate limits are per-key, configurable per tier.
Does the agent see member emails?
Only if the key has the read:members scope. Without it, agents see public profile fields only (display name, avatar, role).
Ready to let your AI do the work?
Create your community, generate a key, and plug in your assistant. No credit card, free on every tier with API access.