add_threat_actor
Add threat actors to your threat model, individually or in batch, to identify and assess potential adversaries.
Instructions
Add a new threat actor. Supports batch operations via the 'items' parameter.
This tool adds one or more threat actors to the threat model. For single item: provide name, type, capability_level, motivations, resources directly. For batch: provide a list of threat actor dicts in the 'items' parameter.
Args: ctx: MCP context for logging and error handling name: Name of the threat actor (required for single item mode) type: Type of the threat actor (required for single item mode) capability_level: Capability level of the threat actor (required for single item mode) motivations: Motivations of the threat actor (required for single item mode) resources: Resources available to the threat actor (required for single item mode) description: Description of the threat actor priority: Priority of the threat actor (1-10, 0 means not ranked) relevance_score: Relevance score of the threat actor (0.0-1.0) is_relevant: Whether the threat actor is relevant to the system items: Optional list of threat actor dicts for batch operation
Returns: A confirmation message with the threat actor ID(s)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name of the threat actor (required for single item mode) | |
| type | No | Type of the threat actor (e.g., 'Insider', 'External', 'Nation-state') (required for single item mode) | |
| items | No | Optional list of threat actors to add in batch. Each dict should contain 'name', 'type', 'capability_level', 'motivations', 'resources', and optionally other fields. When provided, individual parameters are ignored. | |
| priority | No | Priority of the threat actor (1-10, 0 means not ranked) | |
| resources | No | Resources available to the threat actor (Limited, Moderate, Extensive) (required for single item mode) | |
| description | No | Description of the threat actor | |
| is_relevant | No | Whether the threat actor is relevant to the system | |
| motivations | No | Motivations of the threat actor (e.g., 'Financial', 'Political', 'Espionage') (required for single item mode) | |
| relevance_score | No | Relevance score of the threat actor (0.0-1.0) | |
| capability_level | No | Capability level of the threat actor (Low, Medium, High) (required for single item mode) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |