MCP Threatintel

🚀 MCP Threat Intel Server

The MCP Threat Intel Server offers unified access to multiple threat intelligence sources, which is highly beneficial for security research and analysis. It simplifies the process of gathering threat - related information by aggregating data from various platforms.

🚀 Quick Start

The MCP server is designed to provide unified access to multiple threat intelligence sources, which is extremely useful for security research, incident response, and threat analysis.

✨ Features

📦 Installation

Using npm (Recommended)

npx mcp-threatintel-server

Or install globally:

npm install -g mcp-threatintel-server

From Source

git clone https://github.com/aplaceforallmystuff/mcp-threatintel.git
cd mcp-threatintel
npm install
npm run build

📚 Documentation

Prerequisites

• Node.js 18+
• API keys for your preferred threat intelligence sources (see below)

Configuration

For Claude Desktop

Add to your Claude Desktop config file: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "threatintel": {
      "command": "npx",
      "args": ["-y", "mcp-threatintel-server"],
      "env": {
        "OTX_API_KEY": "your-otx-api-key",
        "ABUSEIPDB_API_KEY": "your-abuseipdb-api-key",
        "GREYNOISE_API_KEY": "your-greynoise-api-key",
        "ABUSECH_AUTH_KEY": "your-abusech-auth-key"
      }
    }
  }
}

For Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "threatintel": {
      "command": "npx",
      "args": ["-y", "mcp-threatintel-server"],
      "env": {
        "OTX_API_KEY": "your-otx-api-key",
        "ABUSEIPDB_API_KEY": "your-abuseipdb-api-key",
        "GREYNOISE_API_KEY": "your-greynoise-api-key",
        "ABUSECH_AUTH_KEY": "your-abusech-auth-key"
      }
    }
  }
}

API Keys

Note: Tools are dynamically enabled based on which API keys you provide. Feodo Tracker works without authentication (public JSON feeds).

Usage Examples

Check Available Sources

"What threat intel sources are configured?" "Show me threatintel status"

IP Investigation

"Check if 185.220.101.1 is malicious" "Look up this IP across all threat intel sources"

Domain Analysis

"Is evil - domain.com known to be malicious?" "Check domain reputation"

Malware Hash Lookup

"Look up this SHA256 hash in threat intel" "Is this file hash known malware?"

URL Analysis

"Check if this URL is in any blocklists"

Botnet Tracking (No API Key Required)

"Show me active botnet C2 servers" "Get Feodo tracker data for Emotet"

Threat Pulses

"Search OTX for recent ransomware pulses" "Get latest threat intelligence pulses"

Available Tools

Status

Unified Lookups

AbuseIPDB (requires API key)

AlienVault OTX (requires API key)

GreyNoise (requires API key)

URLhaus (requires abuse.ch auth key)

MalwareBazaar (requires abuse.ch auth key)

ThreatFox (requires abuse.ch auth key)

Feodo Tracker (no key required)

Development

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

Troubleshooting

"No threat intel sources configured"

You can use the server without any API keys - Feodo Tracker will still work. For other sources, add the appropriate API keys to your configuration.

"API error: 401 Unauthorized"

Your API key is invalid or expired. Generate a new one from the respective service.

"API error: 429 Too Many Requests"

You've exceeded the rate limit for a service. Wait a while or upgrade your API tier.

Partial results

If some sources return errors, the unified lookup tools will still return results from working sources. Check threatintel_status to see which sources are configured correctly.

Data Sources

AlienVault OTX

Open Threat Exchange - community - driven threat intelligence platform with pulses containing indicators of compromise.

AbuseIPDB

Crowdsourced IP reputation database with abuse reports from network administrators worldwide.

GreyNoise

Identifies IPs scanning the internet vs targeted attacks. Helps reduce false positives in threat detection.

abuse.ch Projects

• URLhaus - Malware distribution URLs
• MalwareBazaar - Malware sample repository
• ThreatFox - IOC sharing platform
• Feodo Tracker - Botnet C2 infrastructure tracking

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE for details.

Links

• Model Context Protocol
• MCP Specification
• GitHub Repository

Related Projects

For additional threat intelligence capabilities, consider:

• @burtthecoder/mcp-shodan - Shodan internet scanning
• @burtthecoder/mcp-virustotal - VirusTotal malware analysis