Resources
Architecture
The whole system in one view: who triggers Argus, the MCP-native investigation loop in the middle, the Splunk and enrichment systems it reads, and the gated response and detection-as-code it writes back.
The three paths
- Investigation (read). Argus reads Splunk only through the Splunk MCP Server over JSON-RPC. The agent writes SPL, runs it, reads the rows, and pivots — 100% MCP-native and read-only.
- Enrichment. External indicators are enriched with live threat intel (AbuseIPDB, VirusTotal, ip-api) and validated against the pinned MITRE ATT&CK catalog.
- Response (write). Containment goes through Splunk's authenticated REST API: a KV-store blocklist enforced by a correlation search, recorded cases, and, on a confirmed true positive, a newly installed scheduled detection.
Reusable as infrastructure
Argus is not just a CLI. The same workflow is exposed two ways:
- A Splunk custom alert action can trigger an investigation from any saved search (authenticated with
ARGUS_ALERT_TOKEN). - An Argus MCP server (
uv run argus mcp) lets other SOC copilots call the full investigation as tools.
See How Argus works for the investigation loop, and the CLI reference for the commands behind each path.