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 structuredContent matching the output schema. content[0].text repeats 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

encrisoft_organisation_overview_v1 inputSchema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

Output schema

encrisoft_organisation_overview_v1 outputSchema
{
  "$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)

JSON
{
  "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

  • forbidden when the installation was not granted organisation:read, or the approving administrator is still an owner or admin but no longer holds people.read.
  • unauthorized when 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_arguments is returned if the Encrisoft API rejects the request.
  • rate_limited and upstream_unavailable as 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 null when the organisation has no risk data yet.

Input schema

encrisoft_risk_overview_v1 inputSchema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

Output schema

encrisoft_risk_overview_v1 outputSchema
{
  "$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)

JSON
{
  "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

  • forbidden when the installation was not granted risk:read, or the approving administrator is still an owner or admin but no longer holds risk.read.
  • unauthorized when 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_arguments is returned if the Encrisoft API rejects the request.
  • rate_limited and upstream_unavailable as 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, INTERMEDIATE or ADVANCED.
  • Returned titles are bounded to 160 characters, descriptions to 600 and categories to 60.

Input schema

encrisoft_training_catalogue_v1 inputSchema
{
  "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

encrisoft_training_catalogue_v1 outputSchema
{
  "$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)

JSON
{
  "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

  • forbidden when the installation was not granted training_catalogue:read, or the approving administrator is still an owner or admin but no longer holds courses.read.
  • unauthorized when 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_arguments is returned if the Encrisoft API rejects the request.
  • rate_limited and upstream_unavailable as described in MCP Errors, Rate Limits and Quotas.