IOC Lookup: $ARGUMENTS
Automatically detect the IOC type and run the appropriate enrichment chain.
Step 1: Identify IOC Type
Determine what type of indicator was provided:
- IPv4/IPv6 address → run IP enrichment
- Domain name → run domain enrichment
- URL → run URL enrichment
- MD5 (32 hex) / SHA1 (40 hex) / SHA256 (64 hex) → run file hash enrichment
- Email address → run email enrichment
If the type is ambiguous, ask for clarification.
IP Address Enrichment
Run all applicable checks:
Geolocation & ASN
- Country, city, ASN, ISP, organization
- Is it a datacenter/hosting/VPN/Tor exit node?
Reputation
- VirusTotal:
get_ip_report — detection count, community score
- Shodan:
ip_lookup — open ports, running services, banners, SSL certs, hostnames
- AbuseIPDB category if available
Threat Intelligence
- AlienVault OTX: pulse hits, threat actor associations
- Is this IP in any known C2 infrastructure databases?
- Recent malicious activity reported?
Passive DNS
- What domains has this IP hosted? (Shodan reverse DNS)
- How long has it been active?
- Any suspicious hosting patterns?
ATT&CK Context
If associated with known threat activity, map to ATT&CK:
- Infrastructure technique: T1583 (Acquire Infrastructure), T1584 (Compromise Infrastructure)
- C2 technique if applicable
Verdict: [Malicious / Suspicious / Unknown / Benign]
Confidence: [High / Medium / Low]
Recommended action: [Block / Monitor / No action]
Domain Enrichment
WHOIS
- Registrar, registration date, expiry, registrant (if not privacy-protected)
- Newly registered? (< 30 days = higher risk)
- Privacy-protected registration?
DNS Records
- A/AAAA: what IPs does it resolve to?
- MX: mail servers (useful for phishing assessment)
- NS: nameservers
- TXT: SPF, DKIM, DMARC (phishing infrastructure assessment)
Reputation
- VirusTotal:
get_domain_report — detection count, categories, SSL cert history
- Shodan:
dns_lookup — resolution and hosting info
Threat Intelligence
- OTX: threat actor associations, pulse hits
- Is this a typosquat/lookalike of a legitimate domain?
- DGA (Domain Generation Algorithm) characteristics?
- Sinkholed?
Certificate Transparency
- Historical SSL certs (org name, SANs, issuer)
- Does the cert cover unexpected domains? (shared hosting / malicious infra)
ATT&CK Context
- T1566.002 (Spearphishing Link) if phishing
- T1583.001 (Acquire Domains) for C2 infrastructure
- T1071.001 (Web Protocols) for C2 comms
Verdict: [Malicious / Suspicious / Unknown / Benign]
Confidence: [High / Medium / Low]
Recommended action: [Block / Monitor / No action]
URL Enrichment
Reputation
- VirusTotal:
get_url_report — scan results from 70+ engines, downloaded files, contacted domains
- Check URL shortener expansion if applicable
Content Analysis (if safe to access)
- What does the page serve? Phishing kit? Malware dropper? Legitimate?
- Does it redirect? To where?
Infrastructure
- What IP does the hostname resolve to? (run IP enrichment on result)
- Hosting provider?
Threat Intelligence
- Known phishing campaign?
- Exploit kit delivery URL?
- Malware C2 endpoint?
Verdict: [Malicious / Suspicious / Unknown / Benign]
Confidence: [High / Medium / Low]
Recommended action: [Block URL / Block domain / Monitor / No action]
File Hash Enrichment
Basic Info
- Hash format: MD5 / SHA1 / SHA256
- File type (magic bytes if known)
- File size
Reputation
- VirusTotal:
get_file_report — detection ratio (X/72 engines), community score, first/last seen
- Family name if detected
- Tags: trojan, ransomware, backdoor, dropper, etc.
Behavioral Analysis (from VT sandbox)
- Network connections: C2 IPs/domains
- Dropped files
- Registry modifications
- Process injection techniques
- Persistence mechanisms
Threat Intelligence
- Known malware family?
- APT group attribution?
- Campaign associations?
ATT&CK Mapping
Map behaviors to ATT&CK techniques. Common patterns:
- T1055 (Process Injection)
- T1059 (Command and Scripting Interpreter)
- T1071 (Application Layer Protocol — C2)
- T1082 (System Information Discovery)
- T1543 (Create or Modify System Process — Persistence)
If MCP YARA tool available: run against known signatures.
Verdict: [Malicious — Family name / Suspicious / Unknown / Benign]
Confidence: [High / Medium / Low]
Recommended action: [Quarantine / Investigate / No action]
Email Address Enrichment
Breach Data
- Has this email appeared in known breach data? (via public APIs)
- What services were breached?
Domain Assessment
- Run domain enrichment on the email domain
- Is this a free provider (gmail, proton) or corporate?
- Is the domain newly registered or suspicious?
Threat Intelligence
- Used in phishing campaigns?
- Social engineering activity?
- Spamhaus / reputation lists?
Verdict: [Malicious / Suspicious / Unknown / Benign]
Confidence: [High / Medium / Low]
Step 2: Consolidated Report
After all enrichment is complete, output a structured summary:
IOC: $ARGUMENTS
Type: [IP / Domain / URL / Hash / Email]
Verdict: [Malicious / Suspicious / Unknown / Benign]
Confidence: [High / Medium / Low]
Key Findings:
- [Most important finding]
- [Second finding]
- [Third finding]
Threat Context:
- Malware family / Actor: [If known]
- ATT&CK techniques: [T-IDs]
- Campaign: [If known]
Sources:
- VirusTotal: [X/Y detections]
- Shodan: [Key finding]
- OTX: [Pulse hits]
- Other: [Any additional sources]
Recommended Actions:
1. [Immediate action]
2. [Follow-up action]
3. [Detection/hunting recommendation]
Related IOCs to investigate:
- [Connected IPs, domains, hashes from the analysis]
Step 3: Detection Recommendations
Based on the findings, suggest at least one hunting/detection rule:
- SIEM query to find other systems that communicated with this IOC
- EDR query for process/network patterns
- DNS query pattern to detect similar domains (DGA, typosquats)
- YARA rule structure if this is a file hash
1---2name: ioc-lookup3description: Enriches an indicator of compromise (IP, domain, URL, file hash, or email). Pulls reputation data, threat intelligence, WHOIS, passive DNS, malware associations, and ATT&CK context. Use during incident response, threat hunting, or alert triage.4---56# IOC Lookup: $ARGUMENTS78Automatically detect the IOC type and run the appropriate enrichment chain.910## Step 1: Identify IOC Type1112Determine what type of indicator was provided:13- **IPv4/IPv6 address** → run IP enrichment14- **Domain name** → run domain enrichment15- **URL** → run URL enrichment16- **MD5 (32 hex) / SHA1 (40 hex) / SHA256 (64 hex)** → run file hash enrichment17- **Email address** → run email enrichment1819If the type is ambiguous, ask for clarification.2021---2223## IP Address Enrichment2425Run all applicable checks:2627### Geolocation & ASN28- Country, city, ASN, ISP, organization29- Is it a datacenter/hosting/VPN/Tor exit node?3031### Reputation32- VirusTotal: `get_ip_report` — detection count, community score33- Shodan: `ip_lookup` — open ports, running services, banners, SSL certs, hostnames34- AbuseIPDB category if available3536### Threat Intelligence37- AlienVault OTX: pulse hits, threat actor associations38- Is this IP in any known C2 infrastructure databases?39- Recent malicious activity reported?4041### Passive DNS42- What domains has this IP hosted? (Shodan reverse DNS)43- How long has it been active?44- Any suspicious hosting patterns?4546### ATT&CK Context47If associated with known threat activity, map to ATT&CK:48- Infrastructure technique: T1583 (Acquire Infrastructure), T1584 (Compromise Infrastructure)49- C2 technique if applicable5051**Verdict:** [Malicious / Suspicious / Unknown / Benign]52**Confidence:** [High / Medium / Low]53**Recommended action:** [Block / Monitor / No action]5455---5657## Domain Enrichment5859### WHOIS60- Registrar, registration date, expiry, registrant (if not privacy-protected)61- Newly registered? (< 30 days = higher risk)62- Privacy-protected registration?6364### DNS Records65- A/AAAA: what IPs does it resolve to?66- MX: mail servers (useful for phishing assessment)67- NS: nameservers68- TXT: SPF, DKIM, DMARC (phishing infrastructure assessment)6970### Reputation71- VirusTotal: `get_domain_report` — detection count, categories, SSL cert history72- Shodan: `dns_lookup` — resolution and hosting info7374### Threat Intelligence75- OTX: threat actor associations, pulse hits76- Is this a typosquat/lookalike of a legitimate domain?77- DGA (Domain Generation Algorithm) characteristics?78- Sinkholed?7980### Certificate Transparency81- Historical SSL certs (org name, SANs, issuer)82- Does the cert cover unexpected domains? (shared hosting / malicious infra)8384### ATT&CK Context85- T1566.002 (Spearphishing Link) if phishing86- T1583.001 (Acquire Domains) for C2 infrastructure87- T1071.001 (Web Protocols) for C2 comms8889**Verdict:** [Malicious / Suspicious / Unknown / Benign]90**Confidence:** [High / Medium / Low]91**Recommended action:** [Block / Monitor / No action]9293---9495## URL Enrichment9697### Reputation98- VirusTotal: `get_url_report` — scan results from 70+ engines, downloaded files, contacted domains99- Check URL shortener expansion if applicable100101### Content Analysis (if safe to access)102- What does the page serve? Phishing kit? Malware dropper? Legitimate?103- Does it redirect? To where?104105### Infrastructure106- What IP does the hostname resolve to? (run IP enrichment on result)107- Hosting provider?108109### Threat Intelligence110- Known phishing campaign?111- Exploit kit delivery URL?112- Malware C2 endpoint?113114**Verdict:** [Malicious / Suspicious / Unknown / Benign]115**Confidence:** [High / Medium / Low]116**Recommended action:** [Block URL / Block domain / Monitor / No action]117118---119120## File Hash Enrichment121122### Basic Info123- Hash format: MD5 / SHA1 / SHA256124- File type (magic bytes if known)125- File size126127### Reputation128- VirusTotal: `get_file_report` — detection ratio (X/72 engines), community score, first/last seen129- Family name if detected130- Tags: trojan, ransomware, backdoor, dropper, etc.131132### Behavioral Analysis (from VT sandbox)133- Network connections: C2 IPs/domains134- Dropped files135- Registry modifications136- Process injection techniques137- Persistence mechanisms138139### Threat Intelligence140- Known malware family?141- APT group attribution?142- Campaign associations?143144### ATT&CK Mapping145Map behaviors to ATT&CK techniques. Common patterns:146- T1055 (Process Injection)147- T1059 (Command and Scripting Interpreter)148- T1071 (Application Layer Protocol — C2)149- T1082 (System Information Discovery)150- T1543 (Create or Modify System Process — Persistence)151152If MCP YARA tool available: run against known signatures.153154**Verdict:** [Malicious — Family name / Suspicious / Unknown / Benign]155**Confidence:** [High / Medium / Low]156**Recommended action:** [Quarantine / Investigate / No action]157158---159160## Email Address Enrichment161162### Breach Data163- Has this email appeared in known breach data? (via public APIs)164- What services were breached?165166### Domain Assessment167- Run domain enrichment on the email domain168- Is this a free provider (gmail, proton) or corporate?169- Is the domain newly registered or suspicious?170171### Threat Intelligence172- Used in phishing campaigns?173- Social engineering activity?174- Spamhaus / reputation lists?175176**Verdict:** [Malicious / Suspicious / Unknown / Benign]177**Confidence:** [High / Medium / Low]178179---180181## Step 2: Consolidated Report182183After all enrichment is complete, output a structured summary:184185```186IOC: $ARGUMENTS187Type: [IP / Domain / URL / Hash / Email]188Verdict: [Malicious / Suspicious / Unknown / Benign]189Confidence: [High / Medium / Low]190191Key Findings:192- [Most important finding]193- [Second finding]194- [Third finding]195196Threat Context:197- Malware family / Actor: [If known]198- ATT&CK techniques: [T-IDs]199- Campaign: [If known]200201Sources:202- VirusTotal: [X/Y detections]203- Shodan: [Key finding]204- OTX: [Pulse hits]205- Other: [Any additional sources]206207Recommended Actions:2081. [Immediate action]2092. [Follow-up action]2103. [Detection/hunting recommendation]211212Related IOCs to investigate:213- [Connected IPs, domains, hashes from the analysis]214```215216## Step 3: Detection Recommendations217218Based on the findings, suggest at least one hunting/detection rule:219220- SIEM query to find other systems that communicated with this IOC221- EDR query for process/network patterns222- DNS query pattern to detect similar domains (DGA, typosquats)223- YARA rule structure if this is a file hash