-
Notifications
You must be signed in to change notification settings - Fork 2
Reference Generated MCP Tools Reports
Input schemas for the 18 reports tools. The index of every module is in mcp-tools.md; a live server answers the same thing authoritatively through the tools/list JSON-RPC method.
Record an ISMS change decided during a management review.
Requires reports.management_review.update.
| Parameter | Type | Required | Description |
|---|---|---|---|
review_id |
string |
yes | |
change_type |
string |
- | scope|policy|control|organization|resource|process|other |
title |
string |
yes | |
description |
string |
yes | |
impact_analysis |
string |
- | |
affected_policies |
string |
- | |
owner_id |
string |
yes | |
status |
string |
- | |
target_date |
string |
- |
Create a management review (ISO 27001:2022 clause 9.3).
Requires reports.management_review.create.
| Parameter | Type | Required | Description |
|---|---|---|---|
title |
string |
yes | |
description |
string |
- | |
frequency |
string |
yes | quarterly|semiannual|annual|exceptional |
period_start |
string |
yes | YYYY-MM-DD |
period_end |
string |
yes | YYYY-MM-DD |
planned_date |
string |
yes | YYYY-MM-DD |
location |
string |
- | |
facilitator_id |
string |
yes | |
scope_ids |
array |
- |
Record a decision from a management review (ISO 27001:2022 clause 9.3.3).
Requires reports.management_review.update.
| Parameter | Type | Required | Description |
|---|---|---|---|
review_id |
string |
yes | |
category |
string |
- | improvement|isms_change|resource_allocation|risk_acceptance|objective_adjustment|policy_update|other |
input_clause |
string |
- | 9.3.2 clause letter: a|b|c|d1|d2|d3|d4|e|f|g |
title |
string |
yes | |
description |
string |
yes | |
rationale |
string |
- | |
owner_id |
string |
- | |
due_date |
string |
- | |
priority |
string |
- | |
status |
string |
- |
Delete a generated report
Requires reports.report.delete.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | UUID of the object |
Retrieve the binary content of a previously generated report. Returns the file as a base64-encoded string along with its content type, size and original filename. Use list_reports first to discover available report IDs.
Requires reports.report.read.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | UUID of the object |
Export a management review as DOCX (meeting minutes) or PPTX (presentation). Returns base64-encoded content.
Requires reports.management_review.read.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | |
format |
string |
- | docx|pptx |
Generate an audit report PDF for a completed or closed compliance assessment
Requires reports.report.create.
| Parameter | Type | Required | Description |
|---|---|---|---|
assessment_id |
string |
yes | UUID of the compliance assessment (must be completed or closed) |
Generate a management review meeting minutes document (Word) covering ISO 27001 clause 9.3 inputs: action plans, issues, stakeholders, security performance, risks, and improvement opportunities
Requires reports.report.create.
| Parameter | Type | Required | Description |
|---|---|---|---|
scope_ids |
array |
- | Optional list of scope UUIDs to filter data. Omit to include all data. |
period_start |
string |
- | Start of the review period (YYYY-MM-DD). Omit to include all past data. |
period_end |
string |
- | End of the review period (YYYY-MM-DD). Defaults to today. |
Generate a management review presentation (PowerPoint) covering ISO 27001 clause 9.3 inputs: action plans, issues, stakeholders, security performance, risks, and improvement opportunities
Requires reports.report.create.
| Parameter | Type | Required | Description |
|---|---|---|---|
scope_ids |
array |
- | Optional list of scope UUIDs to filter data. Omit to include all data. |
period_start |
string |
- | Start of the review period (YYYY-MM-DD). Omit to include all past data. |
period_end |
string |
- | End of the review period (YYYY-MM-DD). Defaults to today. |
Generate a Statement of Applicability (SoA) PDF report for one or more frameworks
Requires reports.report.create.
| Parameter | Type | Required | Description |
|---|---|---|---|
framework_ids |
array |
yes | List of framework UUIDs to include in the SoA |
Get a management review by ID.
Requires reports.management_review.read.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes |
List ISMS changes decided during management reviews (ISO 27001:2022 clause 9.3.3).
Requires reports.management_review.read.
| Parameter | Type | Required | Description |
|---|---|---|---|
review_id |
string |
- | |
limit |
integer |
- | |
offset |
integer |
- |
List decisions (ISO 27001:2022 clause 9.3.3 outputs). Filter by review or status.
Requires reports.management_review.read.
| Parameter | Type | Required | Description |
|---|---|---|---|
review_id |
string |
- | |
status |
string |
- | |
limit |
integer |
- | |
offset |
integer |
- |
List management reviews (ISO 27001:2022 clause 9.3). Filter by status or scope.
Requires reports.management_review.read.
| Parameter | Type | Required | Description |
|---|---|---|---|
status |
string |
- | planned|in_preparation|held|closed|cancelled |
scope_id |
string |
- | |
limit |
integer |
- | |
offset |
integer |
- |
List generated reports, optionally filtered by report_type
Requires reports.report.read.
| Parameter | Type | Required | Description |
|---|---|---|---|
report_type |
string |
- | Filter by report type (e.g. 'soa') |
limit |
integer |
- | Max results (default 50) |
offset |
integer |
- | Offset for pagination |
Create a ComplianceActionPlan from a management review decision.
Requires reports.management_review.update.
| Parameter | Type | Required | Description |
|---|---|---|---|
decision_id |
string |
yes |
Attach a graphical signature (data URI) to a participant for DOCX embedding.
Requires reports.management_review.update.
| Parameter | Type | Required | Description |
|---|---|---|---|
participant_id |
string |
yes | |
signature_data_uri |
string |
yes | Data URI, e.g. data:image/png;base64,iVBORw0KGgo... |
Transition a management review to a new status (planned -> in_preparation -> held -> closed, or cancelled).
Requires reports.management_review.update.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | |
target_status |
string |
yes | |
comment |
string |
- |
Built from docs/ at v0.36.0. Edits made here are overwritten by the next release : open a pull request against the source instead.
- Administration
- Ask Cairn
- Assets and suppliers
- Compliance
- The dashboard
- Finding your way
- Getting started
- Incidents
- How records move
- Organisational context
- Reports and management review
- Risks
- Trust Center
- Architecture
- Configuration
- Contributing
- The documentation system
- Installation
- Internationalisation
- Operations
- Release process
- Security
- Testing
- Adding an assistant provider
- Adding a dashboard widget
- Adding a domain entity
- Declaring a lifecycle
- Adding an MCP tool
- Adding a REST endpoint
- Adding a report
- Interface conventions
- Dashboard widgets
- Lifecycles
- MCP tools
- MCP tool parameters : Assets
- MCP tool parameters : Compliance
- MCP tool parameters : Governance and context
- MCP tool parameters : General
- MCP tool parameters : Incidents
- MCP tool parameters : Reports and management review
- MCP tool parameters : Risks
- MCP tool parameters : System and administration
- MCP tool parameters : Trust Center
- Management commands
- Models
- Permissions
- REST endpoints
- Environment variables
- MCP server
- REST API
- Assistant module (Ask Cairn)
- Module 0: User Management and Access Control
- Module 1: Context and Organization
- Module 2: Asset Management
- Module 3: Compliance
- Module 4: Risk Management
- Module 4 bis - EBIOS Risk Manager
- Module 5 : Trust Center
- Module 6 : Security Incident Management
- Management review : ISO 27001:2022 compliance (clause 9.3)