Skip to main content
The Konstantly MCP server lets external AI agents — Claude Desktop, Claude Code, Cursor, ChatGPT (when MCP support lands), and any other agent that speaks the Model Context Protocol — read your Konstantly data and take actions on your behalf, without anyone logging into the browser UI.
“Who’s overdue on the OSHA refresher?” “Assign the safety training to the warehouse crew, deadline Friday.” “Show me last week’s leaderboard for the Sales team.”
Your agent answers from your real data. No tab-switching, no copy-paste, no custom integration code.

​
How it works

┌─────────────────────┐
│ Claude Desktop /    │
│ Code / Cursor       │   (your AI tool)
└──────────┬──────────┘
           │ MCP protocol over stdio
           ▼
┌─────────────────────┐
│ @konstantly/        │   (installed via npx, runs on your machine)
│ mcp-server          │
└──────────┬──────────┘
           │ HTTPS + X-MCP-Key header
           ▼
┌─────────────────────┐
│ Konstantly v2 API   │   (your tenant — same backend as the web UI)
└─────────────────────┘
Three pieces work together:
  1. Your AI tool (Claude Desktop, etc.) handles the conversation with you
  2. @konstantly/mcp-server — a small Node CLI installed via npx, brokers between your AI tool and Konstantly
  3. Your Konstantly instance — authenticates the request, applies your existing permissions, returns data
The MCP server is a thin adapter. All business logic, permission checks, license gating, and audit logging happen in your Konstantly backend — exactly like the browser UI. An MCP key acts as you; your permissions apply.

​
What you can do

​
Read (Business and Enterprise)

Compliance reports

get_compliance_status — who’s done what training, who’s overdue, ready for OSHA / SOC 2 / HIPAA audits

Find people and courses

find_user, find_course, get_user, get_course — semantic lookup by name/email

Track assignments

list_assignments, list_my_assignments — per-user, per-group, by status

Certificates

list_certificates — including expiry dates for recertification planning

Statistics + leaderboard

get_statistics, get_leaderboard — engagement, completion rates, top learners

Audit log

get_audit_log — investigate who did what, when

​
Write (Business and Enterprise)

Assign training

assign_training, bulk_assign, assign_chain — single learner, whole group, or full learning path

User management

ban_user, unban_user, change_user_email — offboarding and account hygiene

Clone courses

clone_course — duplicate for a new audience, location, or compliance year

​
AI course generation (Business and Enterprise)

Upload source material

upload_source_material — read a local PDF / DOC / image and index it for course generation

Generate a course

create_course_from_prompt / create_course_from_files — the agent builds the whole course with lessons and a quiz, grounded in your materials

Poll job status

get_course_generation_status — generation runs in the background; the agent polls for completion and reads courseId

​
AI course refinement (Business and Enterprise)

Once a course exists, the agent can iterate on it without starting fresh. All three tools share the same daily AI quota as generation (5 per key, 50 per tenant) — each call counts as one.

Refine a course

refine_course — append new lessons / tests / sections to an existing course. Append-only by design: never deletes or modifies existing content.

Rewrite a question

regenerate_question — surgical fix for a single quiz question. Stays on the same concept; previous text preserved in the audit log.

Rethink a lesson

regenerate_lesson — refresh a lesson’s AI brief without touching pages the author already created.
The complete tool reference lives in the Tools Reference page.

​
When to use MCP vs the REST API

Use the REST API when you’re building a custom integration with a known shape — a Zapier flow, a HRIS sync, a dashboard, a one-off ETL job.Use MCP when you want an AI agent (yours or your customers’) to access Konstantly conversationally — when the prompt is “who’s overdue on safety training” not “GET /api/v2/courses/123/statistics/users”.
The two are complementary. MCP is just a different consumption pattern over the same v2 API surface.

​
Licensing

PlanMCP access
FreeNot available
BusinessAll 25 tools (read, write, AI course generation + refinement). 60 calls/min + 1,000/day.
EnterpriseAll 25 tools. 600 calls/min + 100,000/day.
AI tools (generation + refinement) share a separate, stricter daily quota — 5 calls per key per day, 50 per tenant per day — to ensure sustainable usage. If your plan doesn’t include MCP, the MCP Keys tab in your settings won’t appear. Upgrade or contact your administrator.

​
Next steps

Quickstart

Generate a key and connect Claude Desktop in 5 minutes

Authentication

How keys work, scopes, license tiers

Tools Reference

All 25 tools with parameters and examples

Security

Key rotation, rate limits, audit log