About this reference
The schemas below are copied from the Encrisoft MCP server’s own tools/list response (JSON Schema 2020-12). Example results use illustrative values.
Behaviour common to all tools
- All tools are read-only, idempotent and side-effect free.
- No tool accepts an organisation identifier. The organisation is fixed by your installation.
- Inputs use
additionalProperties: false, so unknown arguments are rejected. - Successful results contain
structuredContentmatching the output schema.content[0].textrepeats the data as JSON after a notice that names, titles and descriptions are organisation-authored data. - Organisation-authored text has control and bidirectional-override characters removed, whitespace collapsed and length bounded.
- Tool names are versioned. A breaking change ships as a new name (for example
_v2).
encrisoft_organisation_overview_v1
Read-only summary of the organisation this installation was granted for: name, status and aggregate people counts. No personal data.
- Title: Organisation overview
- Required scope:
organisation:read - Granting administrator must hold:
people.read(as an owner or admin) - Annotations:
readOnlyHint: true,destructiveHint: false,idempotentHint: true,openWorldHint: false - Data sensitivity: Organisation-level metadata and aggregate counts only. No plan, subscription, seat or billing information, and no personal data.
- Current availability: Developer preview; tested locally. Sandbox deployment and external access are pending. Not generally available.
Limits and pagination
- Takes no arguments; any argument is rejected.
- Organisation names are bounded to 120 characters.
Input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"organisation": {
"type": "object",
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
},
"createdAt": {
"type": "string"
}
},
"required": [
"name",
"status",
"createdAt"
],
"additionalProperties": false
},
"people": {
"type": "object",
"properties": {
"employees": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"activeEmployees": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"departments": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"pendingInvitations": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"activeExternalParticipants": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"employees",
"activeEmployees",
"departments",
"pendingInvitations",
"activeExternalParticipants"
],
"additionalProperties": false
}
},
"required": [
"organisation",
"people"
],
"additionalProperties": false
}Example structuredContent (illustrative values)
{
"organisation": {
"name": "Example Ltd",
"status": "ACTIVE",
"createdAt": "2026-03-02T10:15:00.000Z"
},
"people": {
"employees": 120,
"activeEmployees": 112,
"departments": 6,
"pendingInvitations": 3,
"activeExternalParticipants": 4
}
}Error behaviour
forbiddenwhen the installation was not grantedorganisation:read, or the approving administrator is still an owner or admin but no longer holdspeople.read.unauthorizedwhen the installation or client has been revoked or has expired, or the approving administrator is no longer an active owner or admin.- Arguments outside the input schema are rejected by MCP input validation before the tool runs.
invalid_argumentsis returned if the Encrisoft API rejects the request. rate_limitedandupstream_unavailableas described in MCP Errors, Rate Limits and Quotas.
encrisoft_risk_overview_v1
Read-only organisation human-risk summary: overall score and severity, baseline, band distribution, and department averages for departments with at least 5 scored people. Never returns individuals.
- Title: Risk overview
- Required scope:
risk:read - Granting administrator must hold:
risk.read(as an owner or admin) - Annotations:
readOnlyHint: true,destructiveHint: false,idempotentHint: true,openWorldHint: false - Data sensitivity: Aggregated human-risk information only. Never returns individual employees, names, avatars, employee identifiers, “top risk users” or recent activity.
- Current availability: Developer preview; tested locally. Sandbox deployment and external access are pending. Not generally available.
Limits and pagination
- Takes no arguments; any argument is rejected.
- A department appears only when at least 5 employees in it have an actual risk score (
minimumDepartmentSize). Smaller departments are omitted, not merged. - At most 10 departments are returned.
- Department names are bounded to 120 characters.
- Scores and severities can be
nullwhen the organisation has no risk data yet.
Input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"overallRisk": {
"type": "object",
"properties": {
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"severity": {
"anyOf": [
{
"type": "string",
"enum": [
"LOW",
"MEDIUM",
"HIGH",
"CRITICAL"
]
},
{
"type": "null"
}
]
},
"previousScore": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"delta": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"severity",
"previousScore",
"delta"
],
"additionalProperties": false
},
"baseline": {
"type": "object",
"properties": {
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"current": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"current"
],
"additionalProperties": false
},
"riskBreakdown": {
"type": "object",
"properties": {
"low": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"percentage": {
"type": "number"
},
"delta": {
"type": "number"
}
},
"required": [
"count",
"percentage",
"delta"
],
"additionalProperties": false
},
"medium": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"percentage": {
"type": "number"
},
"delta": {
"type": "number"
}
},
"required": [
"count",
"percentage",
"delta"
],
"additionalProperties": false
},
"high": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"percentage": {
"type": "number"
},
"delta": {
"type": "number"
}
},
"required": [
"count",
"percentage",
"delta"
],
"additionalProperties": false
},
"critical": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"percentage": {
"type": "number"
},
"delta": {
"type": "number"
}
},
"required": [
"count",
"percentage",
"delta"
],
"additionalProperties": false
}
},
"required": [
"low",
"medium",
"high",
"critical"
],
"additionalProperties": false
},
"departments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"type": "number"
},
"severity": {
"type": "string",
"enum": [
"LOW",
"MEDIUM",
"HIGH",
"CRITICAL"
]
},
"scoredPeople": {
"type": "integer",
"minimum": 5,
"maximum": 9007199254740991
}
},
"required": [
"name",
"score",
"severity",
"scoredPeople"
],
"additionalProperties": false
}
},
"minimumDepartmentSize": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"overallRisk",
"baseline",
"riskBreakdown",
"departments",
"minimumDepartmentSize"
],
"additionalProperties": false
}Example structuredContent (illustrative values)
{
"overallRisk": {
"score": 42,
"severity": "MEDIUM",
"previousScore": 45,
"delta": -3
},
"baseline": {
"score": 51,
"current": 42
},
"riskBreakdown": {
"low": {
"count": 40,
"percentage": 35.7,
"delta": 2
},
"medium": {
"count": 52,
"percentage": 46.4,
"delta": 0
},
"high": {
"count": 17,
"percentage": 15.2,
"delta": -2
},
"critical": {
"count": 3,
"percentage": 2.7,
"delta": 0
}
},
"departments": [
{
"name": "Finance",
"score": 58,
"severity": "MEDIUM",
"scoredPeople": 14
}
],
"minimumDepartmentSize": 5
}Error behaviour
forbiddenwhen the installation was not grantedrisk:read, or the approving administrator is still an owner or admin but no longer holdsrisk.read.unauthorizedwhen the installation or client has been revoked or has expired, or the approving administrator is no longer an active owner or admin.- Arguments outside the input schema are rejected by MCP input validation before the tool runs.
invalid_argumentsis returned if the Encrisoft API rejects the request. rate_limitedandupstream_unavailableas described in MCP Errors, Rate Limits and Quotas.
encrisoft_training_catalogue_v1
Read-only, paginated list of PUBLISHED training courses available to the organisation (global library and its own). Maximum 25 per page.
- Title: Training catalogue
- Required scope:
training_catalogue:read - Granting administrator must hold:
courses.read(as an owner or admin) - Annotations:
readOnlyHint: true,destructiveHint: false,idempotentHint: true,openWorldHint: false - Data sensitivity: Published course metadata from the global library and the organisation’s own courses. Draft or unpublished courses, cover images and plan-upgrade hints are never returned.
- Current availability: Developer preview; tested locally. Sandbox deployment and external access are pending. Not generally available.
Limits and pagination
page: 1–1000, default 1.pageSize: 1–25, default 10.search(case-insensitive title search): up to 80 characters.category: up to 60 characters. Neither may contain control characters.difficulty:BEGINNER,INTERMEDIATEorADVANCED.- Returned titles are bounded to 160 characters, descriptions to 600 and categories to 60.
Input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"pageSize": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 25
},
"search": {
"description": "Case-insensitive title search",
"type": "string",
"maxLength": 80,
"pattern": "^[^\\u0000-\\u001f]*$"
},
"category": {
"type": "string",
"maxLength": 60,
"pattern": "^[^\\u0000-\\u001f]*$"
},
"difficulty": {
"type": "string",
"enum": [
"BEGINNER",
"INTERMEDIATE",
"ADVANCED"
]
}
},
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"difficulty": {
"anyOf": [
{
"type": "string",
"enum": [
"BEGINNER",
"INTERMEDIATE",
"ADVANCED"
]
},
{
"type": "null"
}
]
},
"estimatedDurationMinutes": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"lessonCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"hasAssessment": {
"type": "boolean"
},
"source": {
"type": "string"
},
"availableOnCurrentPlan": {
"type": "boolean"
}
},
"required": [
"id",
"title",
"description",
"category",
"difficulty",
"estimatedDurationMinutes",
"lessonCount",
"hasAssessment",
"source",
"availableOnCurrentPlan"
],
"additionalProperties": false
}
},
"page": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"pageSize": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"totalPages": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"items",
"page",
"pageSize",
"total",
"totalPages"
],
"additionalProperties": false
}Example structuredContent (illustrative values)
{
"items": [
{
"id": "3f2a…",
"title": "Spotting phishing links",
"description": "Learn to inspect links…",
"category": "Phishing",
"difficulty": "BEGINNER",
"estimatedDurationMinutes": 15,
"lessonCount": 3,
"hasAssessment": true,
"source": "PLATFORM",
"availableOnCurrentPlan": true
}
],
"page": 1,
"pageSize": 10,
"total": 24,
"totalPages": 3
}Error behaviour
forbiddenwhen the installation was not grantedtraining_catalogue:read, or the approving administrator is still an owner or admin but no longer holdscourses.read.unauthorizedwhen the installation or client has been revoked or has expired, or the approving administrator is no longer an active owner or admin.- Arguments outside the input schema are rejected by MCP input validation before the tool runs.
invalid_argumentsis returned if the Encrisoft API rejects the request. rate_limitedandupstream_unavailableas described in MCP Errors, Rate Limits and Quotas.

