Tools: States of Applicability

listStatesOfApplicability

🔍 Read-only

List all states of applicability for the organization.

Parameters: {
  "organization_id": "org_xxx",
  "size": 50,
  "cursor": "optional_cursor"
}

Supports: Pagination Returns: Array of SoA documents, next_cursor for pagination

Example:
AI: "List all states of applicability"
    [Uses listStatesOfApplicability tool]

getStateOfApplicability

🔍 Read-only

Get a state of applicability by ID.

Parameters: {
  "organization_id": "org_xxx",
  "soa_id": "soa_xxx"
}

Returns: Full SoA details

Example:
AI: "Get details for state of applicability soa_abc123"
    [Uses getStateOfApplicability tool]

addStateOfApplicability

✏️ Write

Add a new state of applicability to the organization.

Parameters: {
  "organization_id": "org_xxx",
  "name": "ISO 27001:2022 SoA",
  "framework_id": "framework_xxx"
}

Returns: Created SoA object

Example:
AI: "Create a new state of applicability for ISO 27001"
    [Uses addStateOfApplicability tool]

updateStateOfApplicability

✏️ Write

Update an existing state of applicability.

Parameters: {
  "organization_id": "org_xxx",
  "soa_id": "soa_xxx",
  "name": "Updated SoA Name"
}

Returns: Updated SoA object

Example:
AI: "Update state of applicability soa_abc123 name"
    [Uses updateStateOfApplicability tool]

deleteStateOfApplicability

✏️ Write

Delete a state of applicability.

Parameters: {
  "organization_id": "org_xxx",
  "soa_id": "soa_xxx"
}

Returns: Confirmation of deletion

Example:
AI: "Delete state of applicability soa_abc123"
    [Uses deleteStateOfApplicability tool]

exportStateOfApplicabilityPDF

🔍 Read-only

Export a state of applicability as a PDF document.

Parameters: {
  "organization_id": "org_xxx",
  "soa_id": "soa_xxx"
}

Returns: PDF document download URL

Example:
AI: "Export state of applicability soa_abc123 as a PDF"
    [Uses exportStateOfApplicabilityPDF tool]

listApplicabilityStatements

🔍 Read-only

List all applicability statements for a state of applicability.

Parameters: {
  "organization_id": "org_xxx",
  "soa_id": "soa_xxx",
  "size": 50,
  "cursor": "optional_cursor"
}

Supports: Pagination Returns: Array of applicability statements, next_cursor for pagination

Example:
AI: "List all applicability statements for SoA soa_abc123"
    [Uses listApplicabilityStatements tool]

getApplicabilityStatement

🔍 Read-only

Get an applicability statement by ID.

Parameters: {
  "organization_id": "org_xxx",
  "statement_id": "stmt_xxx"
}

Returns: Full applicability statement details

Example:
AI: "Get details for applicability statement stmt_abc123"
    [Uses getApplicabilityStatement tool]

addApplicabilityStatement

✏️ Write

Add a control to a state of applicability with an applicability decision.

Parameters: {
  "organization_id": "org_xxx",
  "soa_id": "soa_xxx",
  "control_id": "control_xxx",
  "applicable": true,
  "justification": "Required for ISO 27001 compliance"
}

Returns: Created applicability statement

Example:
AI: "Add control control_abc123 as applicable to SoA soa_abc123"
    [Uses addApplicabilityStatement tool]

updateApplicabilityStatement

✏️ Write

Update the applicability and justification of an applicability statement.

Parameters: {
  "organization_id": "org_xxx",
  "statement_id": "stmt_xxx",
  "applicable": false,
  "justification": "Not relevant to our scope"
}

Returns: Updated applicability statement

Example:
AI: "Mark statement stmt_abc123 as not applicable with justification"
    [Uses updateApplicabilityStatement tool]

deleteApplicabilityStatement

✏️ Write

Delete an applicability statement from a state of applicability.

Parameters: {
  "organization_id": "org_xxx",
  "statement_id": "stmt_xxx"
}

Returns: Confirmation of deletion

Example:
AI: "Remove applicability statement stmt_abc123 from the SoA"
    [Uses deleteApplicabilityStatement tool]