Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.konstantly.com/llms.txt

Use this file to discover all available pages before exploring further.

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 (always available with an MCP key)

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 (Enterprise plan)

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
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
Free / StarterNot available
ProRead-only tools (compliance reports, queries, statistics)
EnterpriseFull read + write tools (assignments, user management, course cloning)
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 18 tools with parameters and examples

Security

Key rotation, rate limits, audit log