Tools: Measures

listMeasures

🔍 Read-only

List all measures for the organization.

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

Supports: Pagination, filtering by state Returns: Array of measures with implementation status, next_cursor for pagination

Example:
AI: "List all implemented measures"
    [Uses listMeasures tool with state filter]
AI: "Show measures in PLANNED state"
    [Uses listMeasures tool with state=PLANNED filter]

getMeasure

🔍 Read-only

Get details of a specific measure.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx"
}

Returns: Full measure details including evidence and history

Example:
AI: "Get details for measure measure_abc123"
    [Uses getMeasure tool]

addMeasure

✏️ Write

Add a new measure to the organization.

Parameters: {
  "organization_id": "org_xxx",
  "name": "Measure Name",
  "description": "Measure description",
  "state": "PLANNED"
}

Returns: Created measure object

Example:
AI: "Add a new measure for employee security training"
    [Uses addMeasure tool]

updateMeasure

✏️ Write

Update an existing measure.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx",
  "state": "IMPLEMENTED",
  "evidence": "Implementation evidence"
}

Returns: Updated measure object

Example:
AI: "Update measure measure_abc123 to IMPLEMENTED state"
    [Uses updateMeasure tool]

deleteMeasure

✏️ Write

Delete a measure.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx"
}

Returns: Confirmation of deletion

Example:
AI: "Delete measure measure_abc123"
    [Uses deleteMeasure tool]

listMeasureRisks

🔍 Read-only

List risks linked to a measure.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx"
}

Returns: Array of risks associated with the measure

Example:
AI: "Show risks linked to measure measure_abc123"
    [Uses listMeasureRisks tool]

listMeasureControls

🔍 Read-only

List controls linked to a measure.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx"
}

Returns: Array of controls associated with the measure

Example:
AI: "Show controls linked to measure measure_abc123"
    [Uses listMeasureControls tool]

listMeasureTasks

🔍 Read-only

List tasks linked to a measure.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx"
}

Returns: Array of tasks associated with the measure

Example:
AI: "Show tasks for measure measure_abc123"
    [Uses listMeasureTasks tool]

listMeasureEvidences

🔍 Read-only

List evidences linked to a measure.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx"
}

Returns: Array of evidences associated with the measure

Example:
AI: "Show evidences for measure measure_abc123"
    [Uses listMeasureEvidences tool]

linkMeasure

✏️ Write

Link a measure to a resource (control or risk). The resource type is determined from the resource GID.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx",
  "resource_id": "gid://resource_xxx"
}

Returns: Updated measure with new link

Example:
AI: "Link measure measure_abc123 to control control_abc123"
    [Uses linkMeasure tool]

unlinkMeasure

✏️ Write

Unlink a measure from a resource (control or risk). The resource type is determined from the resource GID.

Parameters: {
  "organization_id": "org_xxx",
  "measure_id": "measure_xxx",
  "resource_id": "gid://resource_xxx"
}

Returns: Updated measure with link removed

Example:
AI: "Unlink measure measure_abc123 from control control_abc123"
    [Uses unlinkMeasure tool]