Explain Correlation
explain_correlationExplain why two threats are linked: decompose similarity across techniques, IOCs, CVEs, products, CWEs, context, showing dominant channel, shared artifacts, counts, and quality flags.
Instructions
Why two threats are linked: the per-channel similarity decomposition (techniques, IOCs, CVEs, products, CWEs, context), which channel dominates and by how much, the concrete shared artifacts, the signal count, and quality flags for high-confidence/low-evidence and stale links. Use when get_similar_threats gives a score and you need the evidence behind it. Pass the pair in either order. Returns 404 when the engine has no edge between them.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"threat_a": "<threat_a>",
"threat_b": "<threat_b>"
},
"name": "explain_correlation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| threat_a | Yes | First threat ID. | |
| threat_b | Yes | Second threat ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present with HTTP 404 when the engine has no edge between the pair. | |
| is_stale | No | ||
| dominance | No | ||
| shared_cves | No | ||
| shared_iocs | No | ||
| signal_count | No | ||
| score_breakdown | No | ||
| shared_techniques | No | ||
| is_high_conf_low_signal | No |