MCP · Streamable HTTP · 96 Tools

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.

https://mcp.hivelearn.app·Streamable HTTP

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.

1

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.

2

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.

3

Add HiveLearn to your app

  1. 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.
  2. In Claude Desktop, open Settings → Developer → Edit Config. This opens claude_desktop_config.json.
  3. Paste the config below. If the file already has an mcpServers section, add the hivelearn entry inside it instead.
  4. Save, then quit Claude Desktop completely (Cmd+Q on Mac, or right-click the tray icon and choose Quit on Windows). Reopen it.
claude_desktop_config.jsonjson
{
  "mcpServers": {
    "hivelearn": {
      "command": "npx",
      "args": [
        "-y",
        "hivelearn-mcp"
      ],
      "env": {
        "HIVELEARN_API_KEY": "hl_live_YOUR_KEY_HERE"
      }
    }
  }
}
Don't use Settings → Connectors → Add custom connector. That screen only takes a URL and has nowhere to put your API key. HiveLearn's tools will show up, but every request fails with "Missing API key". Use the config file above instead.

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.