mcp-threatintel
Integrates abuse.ch threat feeds (URLhaus, MalwareBazaar, ThreatFox, Feodo) for checking IPs, domains, hashes, and URLs against malware and C2 indicators.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-threatintel
A threat intelligence MCP server for Claude Code. Gives Claude tools to look up IOCs, search threat feeds, check breached credentials, query CVEs, and search the dark web.
Built with FastMCP and SQLite. Feeds are synced locally by a background poller so lookups are fast and don't depend on external API availability.
Tools
Tool | What it does |
| Check an IP, domain, hash, or URL against all threat feeds |
| Full-text search across IOCs, OTX pulses, and CVEs |
| What's been added in the last N hours |
| Check if a CVE is in the CISA Known Exploited Vulnerabilities catalog |
| Show sync status and record counts for all feeds |
| Search AlienVault OTX community threat pulses |
| Check LeakCheck for breached credentials by email, domain, username, or hash |
| Check all known breaches for a domain |
| Search Ahmia.fi's index of Tor hidden services |
| Check if a password has been exposed (HIBP k-anonymity, free, password never leaves machine) |
| Check if an email is in any known breach via HIBP |
| Get the most recently added breach from HIBP |
Related MCP server: CVE MCP Server
Data Sources
Source | What it provides | Auth | Cost |
abuse.ch (URLhaus, MalwareBazaar, ThreatFox, Feodo) | Malware URLs, hashes, C2s, botnet IPs |
| Free |
Community threat pulses, IOC enrichment |
| Free | |
Known exploited vulnerabilities catalog | None | Free | |
Dark web search (.onion index) | None | Free | |
Breached password check (k-anonymity) | None | Free | |
Email breach lookup |
| $4.50/mo | |
Dark web breach data (7B+ records) |
| $10/mo |
All optional keys degrade gracefully. The server runs fine without them and returns a clear error message when a tool needs a key that isn't configured.
Architecture
Claude Code
|
| Streamable HTTP (port 3707, /mcp)
v
mcp-threatintel (mcp_threatintel.server)
|
|-- SQLite cache (threatintel.db) <-- populated by poller
|-- Live API calls (LeakCheck, HIBP, Ahmia)
v
threatintel-poller (mcp_threatintel.poller)
|
|-- abuse.ch feeds (URLhaus, MalwareBazaar, ThreatFox, Feodo)
|-- AlienVault OTX pulses
|-- CISA KEV catalog
(syncs hourly by default)The poller runs as a separate container and syncs threat feeds into a shared SQLite database. The MCP server reads from the cache for fast lookups, with live API calls only for on-demand services (LeakCheck, HIBP, Ahmia).
Setup
1. Clone and configure
git clone https://github.com/pete-builds/mcp-threatintel.git
cd mcp-threatintel
cp .env.example .envEdit .env and add your API keys. Of the feed keys, only ABUSECH_API_KEY is required. All others are optional.
Then generate the bearer token the server requires and put it in .env as MCP_AUTH_TOKEN:
python3 -c "import secrets; print(secrets.token_urlsafe(32))"
chmod 600 .envThe server will not start over HTTP without it. See Authentication.
2. Start the stack
docker compose up -dThis starts two containers:
mcp-threatintel: the MCP server on port 3707. NeedsMCP_AUTH_TOKEN.threatintel-poller: background feed sync (runs every hour). Needs no token.
The poller will do an initial sync on first start. Give it a minute before the tools have data.
3. Connect to Claude Code
Register the MCP server with the Claude CLI, sending the token as a bearer header:
claude mcp add --transport http --scope user threatintel http://localhost:3707/mcp \
--header "Authorization: Bearer <your token>"Or add it to your MCP client configuration:
{
"mcpServers": {
"threatintel": {
"type": "http",
"url": "http://localhost:3707/mcp",
"headers": {
"Authorization": "Bearer <your token>"
}
}
}
}Restart Claude Code. The 12 tools will show up as mcp__threatintel__*. A client that sends no header, or the wrong token, gets 401 Unauthorized and no tools.
Authentication
A bearer token is required for the HTTP transport. There is no unauthenticated mode: with no token the server exits at startup instead of listening.
Variable |
|
Generate |
|
Where it goes |
|
What clients send |
|
What to expect:
No token, or a blank one. The server logs
Bearer token required for client 'threatintel' but not providedand exits non-zero before it binds the port. Underrestart: unless-stoppedthe container restarts in a loop until the token is set..env.exampleshipsMCP_AUTH_TOKEN=blank on purpose, so a copied example refuses to start rather than run with a token everyone knows.MCP_AUTH_REQUIRED=falsedoes not open the HTTP port. The server then exits withRefusing to start streamable-http with no auth provider.MCP_THREATINTEL_AUTH_TOKENis the older name for the same token. It is still accepted, and it wins when both names are set. Set one of them, not both.MCP_AUTH_TOKENis the canonical name.The container healthcheck needs no token. It probes a path outside
/mcpand stays healthy with auth on.The poller needs no token. It serves nothing and never reads the variable.
Rotating the token: change it in
.env, rundocker compose up -dto recreate the server container, then update the header in every client.
Upgrading from 0.3.0 or earlier
Earlier versions ran without a token unless you set one. Before you pull 0.4.0 or later, add MCP_AUTH_TOKEN to .env on the host and add the Authorization header to every client. If the token is missing when the new image starts, the server container will not come up.
stdio for local development
stdio is a local pipe with no network surface, so it needs no token:
MCP_TRANSPORT=stdio DB_PATH=./threatintel.db mcp-threatintelMCP_TRANSPORT=stdio is the only setting required. Without it the server defaults to HTTP and asks for the token.
API Keys
# Required
ABUSECH_API_KEY # Register free at https://auth.abuse.ch/
# Optional (free)
OTX_API_KEY # Register free at https://otx.alienvault.com/
# Optional (paid)
HIBP_API_KEY # $4.50/mo at https://haveibeenpwned.com/API/Key
LEAKCHECK_API_KEY # $10/mo at https://leakcheck.io/Notes
docker-compose.ymlusesnetwork_mode: host. The MCP server binds to0.0.0.0:3707. If you're running this on a server (not just localhost), add a firewall rule to restrict access.A bearer token is required for HTTP. See Authentication. The token is one layer, not the only one: keep the firewall rule too.
The SQLite database is stored in a named Docker volume (
threatintel-data). It persists across container restarts.LeakCheck results redact most of the exposed password value. Only the first and last two characters are shown.
HIBP password checks use k-anonymity: only the first 5 characters of the SHA-1 hash are sent to the API. The full password never leaves the machine.
Credits
Built by Pete Stergion for use with Claude Code.
Related: claude-research-agent — the research skill that uses this server for security investigations.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Cybersecurity MCP server for URL scanning, threat intelligence, and domain reputation.
Enrich, search, assess, and manage threat intelligence through 80+ typed MCP tools.
Pulsedive MCP — threat-intelligence IOC enrichment (pulsedive.com)
Free, read-only public-source threat intel over MCP. No account or API key.
Related MCP Servers
- AlicenseAqualityBmaintenanceAn MCP server that extracts Indicators of Compromise (IoCs) from unstructured text and checks their reputation across multiple threat intelligence services. It enables real-time analysis of IPs, domains, hashes, and URLs, providing enriched context for security workflows within LLMs.539 PyPI19MIT
- AlicenseBqualityDmaintenanceThis MCP server transforms Claude into a comprehensive security analyst by providing access to 27 security tools across 21 APIs for vulnerability intelligence. It enables users to query multiple sources like NVD, EPSS, CISA KEV, and threat intelligence platforms in parallel to get correlated security insights and risk assessments for CVEs.281,778Apache 2.0
- FlicenseNot gradedqualityCmaintenanceThis MCP server connects Claude Desktop to OpenCTI for AI-augmented threat intelligence analysis, enabling natural language queries and instant, contextualized answers from your threat intelligence database.29-
- AlicenseAqualityDmaintenanceAI-powered threat intelligence server with real-time alert monitoring and multi-source IOC analysis, enabling security investigations directly in Claude Desktop.9Apache 2.0