LearningSuite Server

A Model Context Protocol (MCP) server that provides tools for interacting with the LearningSuite API. This server enables AI assistants like Claude to manage members, courses, groups, bundles, hubs, community features, and more.

Features

• Member Management: Create, update, delete, and query members
• Course Management: List courses, manage enrollments, track progress
• Group Management: Create groups, manage memberships and course access
• Bundle Management: Manage product bundles and member access
• Hub Management: Create and manage hubs from templates
• Community Features: Manage forums, posts, comments, and badges
• Webhooks: Create and manage webhook subscriptions
• Push Notifications: Send notifications to users (requires custom app)

Prerequisites

• Node.js 18 or higher
• A LearningSuite account with API access
• LearningSuite API key

Installation

1. Clone this repository:

git clone https://github.com/fabienbutz/mcp-server-learningsuite.git
cd mcp-server-learningsuite

2. Install dependencies:

npm install

3. Build the server:

npm run build

Configuration

Environment Variables

Create a .env file or set the environment variable:

LEARNINGSUITE_API_KEY=your_api_key_here

You can get your API key from the LearningSuite Admin Dashboard.

Claude Desktop Configuration

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "learningsuite": {
      "command": "node",
      "args": ["/path/to/mcp-server-learningsuite/dist/index.js"],
      "env": {
        "LEARNINGSUITE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Authentication

• learningsuite_check_auth - Verify API key validity

Members

• learningsuite_list_members - List all members with filtering options
• learningsuite_create_member - Create a new member
• learningsuite_get_member - Get member by ID
• learningsuite_get_member_by_email - Get member by email
• learningsuite_update_member - Update member information
• learningsuite_delete_member - Delete a member

Member Courses

• learningsuite_get_member_courses - Get courses for a member
• learningsuite_add_member_to_courses - Enroll member in courses
• learningsuite_remove_member_from_courses - Remove member from courses
• learningsuite_get_member_course_info - Get member's course progress

Member Bundles

• learningsuite_get_member_bundles - Get member's bundles
• learningsuite_add_member_to_bundles - Add member to bundles
• learningsuite_remove_member_from_bundles - Remove member from bundles

Team Members

• learningsuite_list_team_members - List admin users
• learningsuite_get_team_member - Get team member by ID
• learningsuite_get_team_member_by_email - Get team member by email

Groups

• learningsuite_list_groups - List all groups
• learningsuite_create_group - Create a new group
• learningsuite_find_groups_by_name - Search groups by name
• learningsuite_delete_group - Delete a group
• learningsuite_get_group_courses - Get group's courses
• learningsuite_add_courses_to_group - Add courses to group
• learningsuite_remove_courses_from_group - Remove courses from group
• learningsuite_add_bundles_to_group - Add bundles to group
• learningsuite_add_members_to_groups - Batch add members to groups
• learningsuite_remove_members_from_groups - Batch remove members from groups

Courses

• learningsuite_list_published_courses - List all published courses
• learningsuite_get_course_modules - Get course modules
• learningsuite_get_course_modules_for_member - Get modules with member visibility
• learningsuite_get_course_members - Get course enrollments
• learningsuite_get_course_access_requests - Get pending access requests
• learningsuite_get_course_submissions - Get course submissions
• learningsuite_create_lesson - Create a new lesson

Modules & Lessons

• learningsuite_get_module_sections - Get module sections
• learningsuite_get_module_lessons - Get module lessons
• learningsuite_create_module_unlock_override - Override module unlock timing

Bundles

• learningsuite_list_bundles - List all bundles
• learningsuite_get_bundle_members - Get bundle members

Hubs

• learningsuite_list_hubs - List all published hubs
• learningsuite_create_hub - Create hub from template
• learningsuite_list_hub_templates - List available templates
• learningsuite_get_hub_template_variables - Get template variables
• learningsuite_add_hub_accesses - Grant hub access
• learningsuite_remove_hub_accesses - Revoke hub access

Community

• learningsuite_list_community_areas - List community areas
• learningsuite_list_community_forums - List forums
• learningsuite_list_community_posts - List posts
• learningsuite_comment_on_post - Comment on a post
• learningsuite_list_community_badges - List badges
• learningsuite_assign_badges_to_user - Assign badges
• learningsuite_remove_badges_from_user - Remove badges

Popups

• learningsuite_list_popups - List all popups
• learningsuite_get_popup - Get popup by ID
• learningsuite_trigger_popup - Trigger popup for member
• learningsuite_remove_popup_trigger - Remove popup trigger

Push Notifications

• learningsuite_send_push_notifications - Send push notifications

Roles

• learningsuite_list_roles - List all roles

Webhooks

• learningsuite_list_webhook_subscriptions - List subscriptions
• learningsuite_create_webhook_subscription - Create subscription
• learningsuite_get_webhook_subscription - Get subscription by ID
• learningsuite_update_webhook_subscription - Update subscription
• learningsuite_delete_webhook_subscription - Delete subscription
• learningsuite_get_webhook_sample_data - Get sample webhook payload

Development

Watch mode for development:

npm run dev

Build:

npm run build

API Documentation

This server wraps the LearningSuite API v1.16.0. For detailed API documentation, visit the LearningSuite Developer Portal.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.