================================================================================
KONSTANTLY MCP SERVER
================================================================================
Connect Claude, Cursor, and other AI agents to your Konstantly workspace via the Model Context Protocol.
25 tools. Read your data, take action, generate & refine courses. Same permissions as the UI. Audited end-to-end.
------------------------------------------------------------------------------
> Step 1. Generate an MCP key from Settings → MCP Keys
> Step 2. Paste a config block into your AI tool (see below)
> Step 3. Restart, ask, done
## Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"konstantly": {
"command": "npx",
"args": ["-y", "@konstantly/mcp-server"],
"env": {
"KONSTANTLY_MCP_KEY": "kmcp_...",
"KONSTANTLY_URL": "https://your-instance.konstantly.com"
}
}
}
}## Claude Code
claude mcp add konstantly \ --env KONSTANTLY_MCP_KEY=kmcp_... \ --env KONSTANTLY_URL=https://your-instance.konstantly.com \ -- npx -y @konstantly/mcp-server
## Cursor
// ~/.cursor/mcp.json
{
"mcpServers": {
"konstantly": {
"command": "npx",
"args": ["-y", "@konstantly/mcp-server"],
"env": {
"KONSTANTLY_MCP_KEY": "kmcp_...",
"KONSTANTLY_URL": "https://your-instance.konstantly.com"
}
}
}
}## ChatGPT
MCP support in ChatGPT is rolling out. When generally available, the same @konstantly/mcp-server package will work without any changes.
------------------------------------------------------------------------------
## Read (Business and Enterprise)
find_user Search users by name or email get_user Full details for one user find_course Search courses by name get_course Full details for one course list_assignments Assignments per user OR per group list_my_assignments Your own assigned courses get_compliance_status The OSHA-audit / who's-compliant tool list_certificates Including expiry dates get_statistics Overview, publishing, activity, tags get_leaderboard Top learners by points/completion get_audit_log Who did what, when
## Write (Business and Enterprise)
assign_training Single course to single learner bulk_assign Multiple courses to a whole group assign_chain Full learning path to users/groups ban_user Offboarding unban_user Reinstate access change_user_email Update email + notify clone_course Fork a course for new audience
## AI — build a course (Business and Enterprise)
upload_source_material Stage a PDF / DOCX / image for grounding create_course_from_prompt Generate a course from a prompt create_course_from_files Generate a course grounded in your files get_course_generation_status Poll a generation job to completion
## AI — iterate on a course (Business and Enterprise)
refine_course Whole-course edit from a plain-English brief regenerate_question Swap a single question, keep the rest regenerate_lesson Rewrite one lesson against its brief
## Coming soon
extend_deadline Push deadlines back send_reminder Nudge overdue learners
------------------------------------------------------------------------------
> Compliance audit prep
“OSHA inspection Tuesday. Show me everyone in the warehouse group who's overdue on confined-spaces training, with their managers' emails, sorted by how overdue they are.”
calls: find_course → get_compliance_status
> Onboarding automation
“Sarah starts Monday. Assign the new-hire bundle, role-specific safety training for warehouse staff, and IT security refresher — all due in two weeks.”
calls: 3x find_course → 3x assign_training
> Certification expiry
“Show me everyone whose forklift certification expires in the next 60 days. Schedule the recertification course two weeks before each expiry.”
calls: list_certificates → per-learner assign_training
> Weekly leadership digest
“What training was completed last week? Who's behind? Format as a 4-bullet executive summary.”
calls: get_statistics, get_compliance_status
> Build a course from a PDF
“Here's our 40-page forklift safety SOP. Make a 5-lesson course for new warehouse hires, one quiz per lesson, plus a final assessment. Use plain English.”
calls: upload_source_material → create_course_from_files → get_course_generation_status
> Refine and fix
“Course 412 reads too corporate. Tighten the tone, drop the legal jargon, and swap question 3 in lesson 2 — it's ambiguous.”
calls: refine_course → regenerate_question
------------------------------------------------------------------------------
- Each key inherits the issuing user's permissions. A learner's key
cannot read admin data. Same model as the browser UI.
- 256 bits of entropy per key. Brute-force is mathematically infeasible
(10^77 attempts). Failed-auth attempts are rate-limited per source IP.
- Every write tool call writes a MCP_TOOL_CALL audit event so
compliance can filter agent actions from human actions.
- Rate-limited per key: Business 60/min + 1k/day; Enterprise 600/min + 100k/day.
- AI tools share a separate quota: 5 calls/day per key, 50/day per tenant.
Covers course generation + refine + per-question/lesson regeneration.
- Revoke any key in seconds from Settings -> MCP Keys.Full security model: docs.konstantly.com/api-reference/mcp/security
------------------------------------------------------------------------------
Free Not available Business All 25 tools, 60/min + 1k/day Enterprise All 25 tools, 600/min + 100k/day
> Pricing details | Talk to sales
------------------------------------------------------------------------------
Setup guide konstantly.com/help/guides/integrations/mcp-server Technical docs docs.konstantly.com/api-reference/mcp npm package npmjs.com/package/@konstantly/mcp-server Launch blog post How to ask Claude about your training data AI policy konstantly.com/legal/ai-policy Model Context Protocol modelcontextprotocol.io
================================================================================
v0.2.0 · published to npm @konstantly/mcp-server · MIT-licensed protocol, proprietary integration
================================================================================