← Back to directory
D

Darknet MCP Server

Community
Full-spectrum dark web and threat intelligence for AI agents
GitHub source repository ↗
★ 451 Stars Category · Other Very popular
51FMRS · D

darknet-mcp-server is a non-official community project (MIT, Bun + TypeScript) that exposes 66 dark web and threat intelligence tools over MCP stdio, covering 16 data sources. Its main value is consolidating scattered breach lookups, ransomware tracking, Tor .onion access, malware analysis, blockchain tracing and exploit search into a single conversation, with per-provider rate limiters, TTL caching, DNS leak prevention and graceful degradation when API keys are missing. Most free tools work immediately, but HIBP account/paste search, IntelligenceX, AbuseIPDB, Hudson Rock and Hybrid Analysis require API keys, and the 7 Tor tools need a local Tor proxy. Intended for authorized security testing and assessment only.

Reliability
9/20
Security and permissions
5/20
Maintenance
11/20
Documentation
14/20
Setup experience
12/20
Read the FMRS scoring method →

darknet-mcp-server is a Model Context Protocol (MCP) server that gives AI agents dark web and threat intelligence capabilities through 66 tools across 16 data sources. It unifies Have I Been Pwned, IntelligenceX, AlienVault OTX, AbuseIPDB, the abuse.ch suite (ThreatFox, URLhaus, MalwareBazaar), GreyNoise, Pulsedive, Hudson Rock, Vulners, Blockchain.info, ChainAbuse, Hybrid Analysis, CIRCL AIL and the Tor network into a single MCP server, letting an agent query all sources in parallel and correlate data in one conversation for breach investigation, ransomware tracking, dark web reconnaissance, malware analysis and blockchain tracing. It is built with Bun + TypeScript and runs over stdio, starting with zero config via npx.

Tools

tor_status
Check if the local Tor SOCKS5 proxy daemon is running and accessible
tor_fetch_onion
Fetch raw HTML from a .onion URL via Tor SOCKS5 proxy (DNS leak prevention via socks5h)
tor_scrape_onion
Fetch and parse a .onion site — returns structured data: title, links, body text
tor_search_onion
Search for .onion sites using the Ahmia.fi search engine
tor_exit_nodes
Get current Tor exit node IP addresses from the official Tor Project bulk exit list
tor_exit_check
Check if a specific IP address is a known Tor exit node
tor_exit_details
Get detailed Tor exit node information including fingerprints and publish timestamps
ransomwareRecent
Fetch the most recent ransomware victims from ransomware.live
ransomwareGroups
List all known ransomware groups tracked by ransomware.live
ransomwareGroup
Get a detailed profile for a specific ransomware group by name
ransomwareGroupVictims
Get all victims claimed by a specific ransomware group
ransomwareSearch
Search ransomware victims by keyword (company name, domain, etc.)
ransomwareByCountry
Get ransomware victims filtered by ISO 3166-1 alpha-2 country code
ransomwareBySector
Get ransomware victims filtered by sector/industry (healthcare, finance, etc.)
ransomlookGroups
List all 582+ ransomware groups tracked by RansomLook
ransomlookRecent
Fetch the most recent ransomware posts and victim claims from RansomLook
breachList
List all known data breaches from HaveIBeenPwned, optionally filter by domain — free
breachGet
Get details of a specific data breach by name — free
breachLatest
Get the most recently added data breach — free
breachDataClasses
List all data classes (types of compromised data) known to HIBP — free
breachPassword
Check if a password has appeared in known breaches (k-anonymity, only 5-char SHA-1 prefix sent) — free
breachSearch
Search all breaches for a specific account (email/username) — requires HIBP_API_KEY
breachPastes
Search for an email address in publicly posted pastes — requires HIBP_API_KEY
threatfoxGetIocs
Get recent IOCs from ThreatFox reported in the last N days
threatfoxSearch
Search ThreatFox IOCs by IP, domain, hash, or URL
threatfoxTag
Search ThreatFox IOCs by tag (e.g., Cobalt Strike, Emotet)
threatfoxMalware
Search ThreatFox IOCs by malware family using Malpedia naming
urlhausLookup
Look up a URL or host in URLhaus for malware distribution
urlhausTag
Search URLhaus entries by tag
bazaarHash
Look up a malware sample in MalwareBazaar by MD5, SHA1, or SHA256 hash
bazaarRecent
Get the most recently submitted malware samples from MalwareBazaar
bazaarTag
Search MalwareBazaar by tag or YARA signature name
otx_ip
Look up threat intelligence for an IP address — pulse info, reputation, country, ASN
otx_domain
Look up threat intelligence for a domain — pulse info, whois, reputation
otx_hash
Look up threat intelligence for a file hash (MD5, SHA1, SHA256)
otx_cve
Look up threat intelligence for a CVE — related pulses and indicators
otx_search_pulses
Search OTX threat pulses by keyword
abuseipdb_check
Check an IP address for abuse reports — confidence score, ISP, country, report count
abuseipdb_reports
Get individual abuse reports for an IP with detailed comments and categories
abuseipdb_blacklist
Get AbuseIPDB's blacklist of the most reported malicious IP addresses
abuseipdb_check_block
Check an entire CIDR network block for abuse reports
greynoise_ip
Look up an IP on GreyNoise — classification (benign/malicious/unknown), scanner status
greynoise_check
Quick check: is this IP a known scanner or known benign service?
pulsedive_indicator
Look up an indicator (IP, domain, URL, or hash) — risk level, threats, feeds
pulsedive_search
Search Pulsedive indicators by value
pulsedive_explore
Explore linked indicators using advanced queries (related IOCs with risk levels)
stealer_domain
Search stealer log entries by domain — compromised machines, credentials, malware details
stealer_email
Search stealer logs by email address — compromised machines with that email in browser credentials
stealer_ip
Search stealer logs by IP address — compromised machines originating from that IP
vulners_search
Search the Vulners vulnerability database using Lucene queries
vulners_id
Look up a specific vulnerability or exploit by ID (CVE, EDB, GHSA) — free
vulners_exploit
Search specifically for exploits (ExploitDB entries)
btc_address
Look up a Bitcoin address — balance, transaction count, recent transactions
btc_balance
Get Bitcoin address balance in satoshi (quick check without full history)
btc_tx
Get detailed Bitcoin transaction information by hash — inputs, outputs, fees, block info
btc_abuse_check
Check a Bitcoin address for abuse reports on ChainAbuse — scam reports with categories
malware_search
Search Hybrid Analysis sandbox by file hash — verdict, AV detection rate, analysis details
malware_overview
Full malware analysis overview — MITRE ATT&CK techniques, network indicators, processes
malware_feed
Get the latest malware detonation feed — recently analyzed samples with verdicts
onion_lookup
Look up metadata for a .onion address via CIRCL AIL project — first/last seen, status, tags, certs, ports, BTC addresses
intelx_search
Initiate a search on IntelligenceX for leaked data, dark web content, and more
intelx_search_results
Retrieve results for an IntelligenceX search by ID
intelx_phonebook
Phonebook search — find emails, domains, URLs associated with a term
intelx_phonebook_results
Retrieve phonebook search results by ID
phishing_check
Check if a URL is a known phishing site via PhishTank
darknet_list_sources
List all available data sources with configuration status, API key status, and tool counts

Setup

Option 1 (no install): run npx darknet-mcp-server. Free tools work immediately — ransomware tracking, breach listings, GreyNoise, blockchain, OTX and more need no API keys. Option 2 (clone): git clone https://github.com/badchars/darknet-mcp-server.git && cd darknet-mcp-server && bun install. Optional environment variables: HIBP_API_KEY, INTELX_API_KEY, OTX_API_KEY, ABUSEIPDB_API_KEY, ABUSECH_AUTH_KEY, PULSEDIVE_API_KEY, HUDSONROCK_API_KEY, VULNERS_API_KEY, HYBRID_API_KEY, PHISHTANK_API_KEY, plus Tor proxy settings TOR_SOCKS_HOST (default 127.0.0.1) and TOR_SOCKS_PORT (default 9050). Connect a client: for Claude Code run claude mcp add darknet-mcp-server -- npx darknet-mcp-server, or with a local clone claude mcp add darknet-mcp-server -- bun run /path/to/darknet-mcp-server/src/index.ts; for Claude Desktop add the npx launch config to mcpServers in claude_desktop_config.json; Cursor / Windsurf use the same JSON format. To use the 7 Tor tools, run a local Tor SOCKS5 proxy first (macOS brew install tor && brew services start tor; Linux sudo apt install tor && sudo systemctl start tor; Docker docker run -d -p 9050:9050 dperson/torproxy) and verify connectivity with npx darknet-mcp-server --check-tor.

claude_desktop_config.json
{
  "mcpServers": {
    "darknet": {
      "command": "npx",
      "args": ["-y", "darknet-mcp-server"],
      "env": {
        "HIBP_API_KEY": "optional",
        "INTELX_API_KEY": "optional",
        "ABUSEIPDB_API_KEY": "optional",
        "HUDSONROCK_API_KEY": "optional",
        "HYBRID_API_KEY": "optional",
        "VULNERS_API_KEY": "optional"
      }
    }
  }
}

Fit and risk

Best for

  • Authorized security assessment, incident response and threat intelligence teams
  • AI agent workflows that need multi-source intelligence correlated in a single conversation
  • Analysts wanting ransomware and breach listing data without configuring API keys
  • Users already running the companion security MCP servers (hackbrowser-mcp, cve-mcp, osint-mcp-server, etc.)

Not for

  • Users performing intelligence gathering on third-party targets without authorization
  • Users who expect every tool to work out of the box (several require paid or requested API keys)
  • Users needing Ethereum or Monero blockchain data (Bitcoin only)
  • Users needing officially supported Windows operation (only macOS / Linux are tested)

Required permissions

  • Read third-party API keys from environment variables (HIBP, IntelligenceX, OTX, AbuseIPDB, abuse.ch, Pulsedive, Hudson Rock, Vulners, Hybrid Analysis, PhishTank)
  • Communicate with a local Tor daemon over the local SOCKS5 port (default 127.0.0.1:9050)
  • Make outbound HTTPS requests to 16 external data sources
  • Install locally and run a process over stdio via npx / Bun

Risks and side effects

  • Dark web intelligence gathering is legally and compliance sensitive — proper authorization is essential
  • Tor .onion tools leak DNS if attribution is not routed through the proxy; the project mitigates this with socks5h but users should verify their proxy setup
  • API keys live in plain environment variables and could leak into logs or config files
  • Tor-dependent tools are unavailable without a local Tor daemon
  • Free tiers have low rate limits, so bulk queries may be throttled
  • Upstream sources (e.g. ransomware.live, RansomLook, PhishTank) depend on scraping frequency, so data may lag or be incomplete
  • All content returned by external sources is untrusted input and should not be executed as instructions

Troubleshooting

  1. If Tor tools fail, first run `npx darknet-mcp-server --check-tor` to test SOCKS5 connectivity
  2. Verify TOR_SOCKS_HOST / TOR_SOCKS_PORT match the actual Tor listener port (default 127.0.0.1:9050)
  3. A 'set XXX_API_KEY to enable…' style error means that tool requires the key — this is expected graceful degradation
  4. Use `npx darknet-mcp-server --list` to see all tools and `--tool <name> '<json args>'` to debug a single tool
  5. If throttled, configure ABUSECH_AUTH_KEY, OTX_API_KEY, PULSEDIVE_API_KEY and similar to raise quotas
  6. If tools do not appear in your MCP client, confirm the command is `npx darknet-mcp-server` or the local `src/index.ts` path is correct

Use cases

Assess a domain's or email's exposure across known breaches, pastes and stealer logs
Track ransomware victims and active groups by sector, country or organization
Fetch, scrape and search .onion hidden services through a Tor SOCKS5 proxy
Cross-analyze a file hash for malware: sandbox verdicts, sample repositories, IOCs and threat pulses
Look up abuse reports, scanner status and reputation for IP addresses
Trace Bitcoin address balances, transactions and abuse/scam reports
Search vulnerability databases and ExploitDB entries for exploits

Supported clients

Claude CodeFull support
Claude DesktopFull support
CursorFull support
WindsurfFull support