# Risks MCP tools

This page documents **49 tools** in the risks group. Return to the [complete MCP tool reference](/docs/developers/api/mcp/tools) to browse another group.

Select a tool to inspect its schemas and behavior. Schema links open the exact definition in GitHub.

### `listRisks` — List Risks

List all risks for the organization.

- **Input:** [`ListRisksInput`](/docs)
- **Output:** [`ListRisksOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14593–L14604 ↗](/docs)

### `getRisk` — Get Risk

Get a risk by ID.

- **Input:** [`GetRiskInput`](/docs)
- **Output:** [`GetRiskOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14605–L14616 ↗](/docs)

### `addRisk` — Add Risk

Add a new risk to the organization.

- **Input:** [`AddRiskInput`](/docs)
- **Output:** [`AddRiskOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L14617–L14628 ↗](/docs)

### `updateRisk` — Update Risk

Update an existing risk.

- **Input:** [`UpdateRiskInput`](/docs)
- **Output:** [`UpdateRiskOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14629–L14640 ↗](/docs)

### `deleteRisk` — Delete Risk

Delete a risk.

- **Input:** [`DeleteRiskInput`](/docs)
- **Output:** [`DeleteRiskOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14641–L14652 ↗](/docs)

### `listRiskObligations` — List Risk Obligations

List obligations linked to a risk.

- **Input:** [`ListRiskObligationsInput`](/docs)
- **Output:** [`ListRiskObligationsOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15673–L15684 ↗](/docs)

### `linkRisk` — Link Risk

Link a risk to a resource (document, measure, or obligation). The resource type is determined from the resource_id GID.

- **Input:** [`LinkRiskInput`](/docs)
- **Output:** [`LinkRiskOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15685–L15696 ↗](/docs)

### `unlinkRisk` — Unlink Risk

Unlink a risk from a resource (document, measure, or obligation). The resource type is determined from the resource_id GID.

- **Input:** [`UnlinkRiskInput`](/docs)
- **Output:** [`UnlinkRiskOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15697–L15708 ↗](/docs)

### `publishRiskList` — Publish Risk List

Publish the risk register for an organization as a document. If a document already exists, a new version is created.

- **Input:** [`PublishRiskListInput`](/docs)
- **Output:** [`PublishRiskListOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L16189–L16200 ↗](/docs)

### `listRiskAnalyses` — List Risk Analyses

List all risk assessments for an organization.

- **Input:** [`ListRiskAnalysesInput`](/docs)
- **Output:** [`ListRiskAnalysesOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17629–L17640 ↗](/docs)

### `getRiskAnalysis` — Get Risk Analysis

Get a risk assessment by ID.

- **Input:** [`GetRiskAnalysisInput`](/docs)
- **Output:** [`GetRiskAnalysisOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17641–L17652 ↗](/docs)

### `addRiskAnalysis` — Add Risk Analysis

Create a new risk assessment.

- **Input:** [`AddRiskAnalysisInput`](/docs)
- **Output:** [`AddRiskAnalysisOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L17653–L17664 ↗](/docs)

### `updateRiskAnalysis` — Update Risk Analysis

Update an existing risk assessment.

- **Input:** [`UpdateRiskAnalysisInput`](/docs)
- **Output:** [`UpdateRiskAnalysisOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17665–L17676 ↗](/docs)

### `deleteRiskAnalysis` — Delete Risk Analysis

Delete a risk assessment.

- **Input:** [`DeleteRiskAnalysisInput`](/docs)
- **Output:** [`DeleteRiskAnalysisOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17677–L17688 ↗](/docs)

### `listRiskAnalysisDiagrams` — List Risk Analysis Diagrams

List all diagrams for a risk analysis.

- **Input:** [`ListRiskAnalysisDiagramsInput`](/docs)
- **Output:** [`ListRiskAnalysisDiagramsOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17689–L17700 ↗](/docs)

### `getRiskAnalysisDiagram` — Get Risk Analysis Diagram

Get a risk analysis diagram by ID.

- **Input:** [`GetRiskAnalysisDiagramInput`](/docs)
- **Output:** [`GetRiskAnalysisDiagramOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17701–L17712 ↗](/docs)

### `getRiskAnalysisDiagramMermaidChart` — Get Risk Analysis Diagram Mermaid Chart

Get the Mermaid chart for a risk analysis diagram.

- **Input:** [`GetRiskAnalysisDiagramMermaidChartInput`](/docs)
- **Output:** [`GetRiskAnalysisDiagramMermaidChartOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17713–L17724 ↗](/docs)

### `addRiskAnalysisDiagram` — Add Risk Analysis Diagram

Create a new risk analysis diagram.

- **Input:** [`AddRiskAnalysisDiagramInput`](/docs)
- **Output:** [`AddRiskAnalysisDiagramOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L17725–L17736 ↗](/docs)

### `updateRiskAnalysisDiagram` — Update Risk Analysis Diagram

Update an existing risk analysis diagram.

- **Input:** [`UpdateRiskAnalysisDiagramInput`](/docs)
- **Output:** [`UpdateRiskAnalysisDiagramOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17737–L17748 ↗](/docs)

### `deleteRiskAnalysisDiagram` — Delete Risk Analysis Diagram

Delete a risk analysis diagram.

- **Input:** [`DeleteRiskAnalysisDiagramInput`](/docs)
- **Output:** [`DeleteRiskAnalysisDiagramOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17749–L17760 ↗](/docs)

### `listRiskAnalysisNodes` — List Risk Analysis Nodes

List all nodes for a risk analysis diagram.

- **Input:** [`ListRiskAnalysisNodesInput`](/docs)
- **Output:** [`ListRiskAnalysisNodesOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17761–L17772 ↗](/docs)

### `getRiskAnalysisNode` — Get Risk Analysis Node

Get a risk assessment node by ID.

- **Input:** [`GetRiskAnalysisNodeInput`](/docs)
- **Output:** [`GetRiskAnalysisNodeOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17773–L17784 ↗](/docs)

### `addRiskAnalysisNode` — Add Risk Analysis Node

Create a new risk assessment node.

- **Input:** [`AddRiskAnalysisNodeInput`](/docs)
- **Output:** [`AddRiskAnalysisNodeOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L17785–L17796 ↗](/docs)

### `updateRiskAnalysisNode` — Update Risk Analysis Node

Update an existing risk assessment node.

- **Input:** [`UpdateRiskAnalysisNodeInput`](/docs)
- **Output:** [`UpdateRiskAnalysisNodeOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17797–L17808 ↗](/docs)

### `deleteRiskAnalysisNode` — Delete Risk Analysis Node

Delete a risk assessment node.

- **Input:** [`DeleteRiskAnalysisNodeInput`](/docs)
- **Output:** [`DeleteRiskAnalysisNodeOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17809–L17820 ↗](/docs)

### `listRiskAnalysisBoundaries` — List Risk Analysis Boundaries

List all boundaries for a risk analysis diagram.

- **Input:** [`ListRiskAnalysisBoundariesInput`](/docs)
- **Output:** [`ListRiskAnalysisBoundariesOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17821–L17832 ↗](/docs)

### `getRiskAnalysisBoundary` — Get Risk Analysis Boundary

Get a risk assessment boundary by ID.

- **Input:** [`GetRiskAnalysisBoundaryInput`](/docs)
- **Output:** [`GetRiskAnalysisBoundaryOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17833–L17844 ↗](/docs)

### `addRiskAnalysisBoundary` — Add Risk Analysis Boundary

Create a new risk assessment boundary.

- **Input:** [`AddRiskAnalysisBoundaryInput`](/docs)
- **Output:** [`AddRiskAnalysisBoundaryOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L17845–L17856 ↗](/docs)

### `updateRiskAnalysisBoundary` — Update Risk Analysis Boundary

Update an existing risk assessment boundary.

- **Input:** [`UpdateRiskAnalysisBoundaryInput`](/docs)
- **Output:** [`UpdateRiskAnalysisBoundaryOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17857–L17868 ↗](/docs)

### `deleteRiskAnalysisBoundary` — Delete Risk Analysis Boundary

Delete a risk assessment boundary.

- **Input:** [`DeleteRiskAnalysisBoundaryInput`](/docs)
- **Output:** [`DeleteRiskAnalysisBoundaryOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17869–L17880 ↗](/docs)

### `listRiskAnalysisProcesses` — List Risk Analysis Processes

List all processes for a risk analysis diagram.

- **Input:** [`ListRiskAnalysisProcessesInput`](/docs)
- **Output:** [`ListRiskAnalysisProcessesOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17881–L17892 ↗](/docs)

### `getRiskAnalysisProcess` — Get Risk Analysis Process

Get a risk assessment process by ID.

- **Input:** [`GetRiskAnalysisProcessInput`](/docs)
- **Output:** [`GetRiskAnalysisProcessOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17893–L17904 ↗](/docs)

### `addRiskAnalysisProcess` — Add Risk Analysis Process

Create a new risk assessment process.

- **Input:** [`AddRiskAnalysisProcessInput`](/docs)
- **Output:** [`AddRiskAnalysisProcessOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L17905–L17916 ↗](/docs)

### `updateRiskAnalysisProcess` — Update Risk Analysis Process

Update an existing risk assessment process.

- **Input:** [`UpdateRiskAnalysisProcessInput`](/docs)
- **Output:** [`UpdateRiskAnalysisProcessOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17917–L17928 ↗](/docs)

### `deleteRiskAnalysisProcess` — Delete Risk Analysis Process

Delete a risk assessment process.

- **Input:** [`DeleteRiskAnalysisProcessInput`](/docs)
- **Output:** [`DeleteRiskAnalysisProcessOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17929–L17940 ↗](/docs)

### `listRiskAnalysisThreats` — List Risk Analysis Threats

List all threats for a risk analysis diagram.

- **Input:** [`ListRiskAnalysisThreatsInput`](/docs)
- **Output:** [`ListRiskAnalysisThreatsOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17941–L17952 ↗](/docs)

### `getRiskAnalysisThreat` — Get Risk Analysis Threat

Get a risk assessment threat by ID.

- **Input:** [`GetRiskAnalysisThreatInput`](/docs)
- **Output:** [`GetRiskAnalysisThreatOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17953–L17964 ↗](/docs)

### `addRiskAnalysisThreat` — Add Risk Analysis Threat

Create a new risk assessment threat.

- **Input:** [`AddRiskAnalysisThreatInput`](/docs)
- **Output:** [`AddRiskAnalysisThreatOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L17965–L17976 ↗](/docs)

### `updateRiskAnalysisThreat` — Update Risk Analysis Threat

Update an existing risk assessment threat.

- **Input:** [`UpdateRiskAnalysisThreatInput`](/docs)
- **Output:** [`UpdateRiskAnalysisThreatOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17977–L17988 ↗](/docs)

### `deleteRiskAnalysisThreat` — Delete Risk Analysis Threat

Delete a risk assessment threat.

- **Input:** [`DeleteRiskAnalysisThreatInput`](/docs)
- **Output:** [`DeleteRiskAnalysisThreatOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L17989–L18000 ↗](/docs)

### `listRiskAnalysisScenarios` — List Risk Analysis Scenarios

List all scenarios for a risk analysis diagram.

- **Input:** [`ListRiskAnalysisScenariosInput`](/docs)
- **Output:** [`ListRiskAnalysisScenariosOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18001–L18012 ↗](/docs)

### `getRiskAnalysisScenario` — Get Risk Analysis Scenario

Get a risk assessment scenario by ID.

- **Input:** [`GetRiskAnalysisScenarioInput`](/docs)
- **Output:** [`GetRiskAnalysisScenarioOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18013–L18024 ↗](/docs)

### `addRiskAnalysisScenario` — Add Risk Analysis Scenario

Create a new risk assessment scenario.

- **Input:** [`AddRiskAnalysisScenarioInput`](/docs)
- **Output:** [`AddRiskAnalysisScenarioOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L18025–L18036 ↗](/docs)

### `updateRiskAnalysisScenario` — Update Risk Analysis Scenario

Update an existing risk assessment scenario.

- **Input:** [`UpdateRiskAnalysisScenarioInput`](/docs)
- **Output:** [`UpdateRiskAnalysisScenarioOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18037–L18048 ↗](/docs)

### `deleteRiskAnalysisScenario` — Delete Risk Analysis Scenario

Delete a risk assessment scenario.

- **Input:** [`DeleteRiskAnalysisScenarioInput`](/docs)
- **Output:** [`DeleteRiskAnalysisScenarioOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18049–L18060 ↗](/docs)

### `linkRiskAnalysisScenarioThreat` — Link Risk Analysis Scenario Threat

Link a threat to a risk assessment scenario.

- **Input:** [`LinkRiskAnalysisScenarioThreatInput`](/docs)
- **Output:** [`LinkRiskAnalysisScenarioThreatOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18061–L18072 ↗](/docs)

### `unlinkRiskAnalysisScenarioThreat` — Unlink Risk Analysis Scenario Threat

Unlink a threat from a risk assessment scenario.

- **Input:** [`UnlinkRiskAnalysisScenarioThreatInput`](/docs)
- **Output:** [`UnlinkRiskAnalysisScenarioThreatOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18073–L18084 ↗](/docs)

### `linkRiskAnalysisScenarioRisk` — Link Risk Analysis Scenario Risk

Link a risk to a risk assessment scenario.

- **Input:** [`LinkRiskAnalysisScenarioRiskInput`](/docs)
- **Output:** [`LinkRiskAnalysisScenarioRiskOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18085–L18096 ↗](/docs)

### `unlinkRiskAnalysisScenarioRisk` — Unlink Risk Analysis Scenario Risk

Unlink a risk from a risk assessment scenario.

- **Input:** [`UnlinkRiskAnalysisScenarioRiskInput`](/docs)
- **Output:** [`UnlinkRiskAnalysisScenarioRiskOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L18097–L18108 ↗](/docs)