TalentLMS

@mindstone/mcp-server-talentlms

TalentLMS MCP server for Model Context Protocol hosts. Manage users, courses, groups, branches, categories, enrolments, reporting, and assessments in TalentLMS through a standardised MCP interface.

Status

• Version: 0.4.0 · npm
• Auth: API key (TALENTLMS_API_KEY)
• Tools: 28 (users, courses, groups, categories, reporting, assessments)
• Surface: cloud-api
• Machine-readable: STATUS.json

Requirements

• Node.js 20+
• npm

One-click install

After clicking the button, your host will prompt you to fill: TALENTLMS_API_KEY, TALENTLMS_DOMAIN, TALENTLMS_REQUEST_TIMEOUT.

{
  "mcpServers": {
    "TalentLMS": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-talentlms"
      ],
      "env": {
        "TALENTLMS_API_KEY": "",
        "TALENTLMS_DOMAIN": "",
        "TALENTLMS_REQUEST_TIMEOUT": "30000"
      }
    }
  }
}

Quick Start

Install & build

cd <path-to-repo>/connectors/talentlms
npm install
npm run build

npx (once published)

npx -y @mindstone/mcp-server-talentlms

Local

node dist/index.js

Configuration

Environment variables

• TALENTLMS_API_KEY — TalentLMS API key
• TALENTLMS_DOMAIN — TalentLMS subdomain (e.g. acme for acme.talentlms.com)
• TALENTLMS_REQUEST_TIMEOUT — request timeout in milliseconds (default: 30000)
• MCP_HOST_BRIDGE_STATE — optional path to a host bridge state file used for credential management
• MINDSTONE_REBEL_BRIDGE_STATE — backwards-compatible alias for MCP_HOST_BRIDGE_STATE

Host configuration examples

Claude Desktop / Cursor

{
  "mcpServers": {
    "TalentLMS": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-talentlms"],
      "env": {
        "TALENTLMS_API_KEY": "your-api-key",
        "TALENTLMS_DOMAIN": "your-domain"
      }
    }
  }
}

Local development (no npm publish needed)

{
  "mcpServers": {
    "TalentLMS": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/talentlms/dist/index.js"],
      "env": {
        "TALENTLMS_API_KEY": "your-api-key",
        "TALENTLMS_DOMAIN": "your-domain"
      }
    }
  }
}

Tools (28)

List tools paginate: TalentLMS returns 20 items per page by default — pass page_size (max 1000) and page_number to page through larger tenants.

Configuration

• configure_talentlms — Configure TalentLMS API credentials

Users

• list_talentlms_users — List users (paginated)
• get_talentlms_user — Get a user's full profile by ID or email
• create_talentlms_user — Create a new user
• update_talentlms_user — Update an existing user (name, email, login, password, bio, timezone, deactivation date; non-privileged user types only)
• set_talentlms_user_status — Activate or deactivate a user
• get_talentlms_user_courses — Get all courses a user is enrolled in

Courses

• list_talentlms_courses — List courses (paginated)
• get_talentlms_course — Get full course details by ID
• create_talentlms_course — Create a new course
• get_talentlms_course_users — Get all users enrolled in a course
• enrol_talentlms_user — Enrol a user into a course
• unenrol_talentlms_user — Remove a user from a course
• get_talentlms_course_sso_link — Generate an SSO link to launch a user into a course

Groups

• list_talentlms_groups — List groups (paginated)
• get_talentlms_group — Get group details including members and courses
• create_talentlms_group — Create a new group
• add_course_to_talentlms_group — Assign a course to a group

Branches

• list_talentlms_branches — List branches (paginated, multi-tenant)

Categories

• list_talentlms_categories — List course categories (paginated)

Reporting

• get_talentlms_site_info — Get site-level statistics and configuration
• get_talentlms_timeline — Get activity timeline for users or courses
• get_talentlms_user_progress — Get detailed progress for a user in a course
• get_talentlms_leaderboard — Gamification leaderboard (users ranked by points; derived from the full user list, paged 1000 at a time so no user is dropped)
• get_talentlms_user_certifications — Get a user's issued certifications with expiration dates

Assessments

• get_talentlms_test_answers — Get a user's answers for a test/quiz
• get_talentlms_survey_answers — Get a user's responses to a survey
• get_talentlms_ilt_sessions — Get instructor-led training sessions for a unit

Security notes

• Untrusted-content envelopes: text authored inside TalentLMS (course and group descriptions, user names/bios/custom fields, test and survey answers, etc.) is returned inside <untrusted-content source="..."> envelopes so the host model treats it as data, not instructions. Ids, statuses, timestamps, and other metadata are deliberately left raw so tool chaining (e.g. copying a user_id into the next call) keeps working.
• Privilege guard: create_talentlms_user and update_talentlms_user only accept the non-privileged Learner/Trainer user types — Administrator/SuperAdmin accounts must be managed in the TalentLMS UI.

Licence

FSL-1.1-MIT — Functional Source License, Version 1.1, with MIT future licence. The software converts to MIT licence on 2030-04-08.