# BlackDome Threat Intel

> BlackDome Threat Intel is a freemium MCP server for security. Query honeypot-captured attacker IPs, credentials and payloads from your AI tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://blackdome.ai
- **Repository:** https://github.com/blackdome-ai/blackdome-mcp
- **MCP Registry name:** io.github.blackdome-ai/blackdome-mcp
- **Categories:** security
- **Listing updated:** 2026-11-14

## About

BlackDome runs its own honeypot network, which its pricing page describes as six edges and twenty emulated services, and exposes what attackers do there. The README lists read-only lookups of attacker IPs, indicators of compromise, captured credentials and malware payloads, deterministic sample comparison, bounded evidence clusters and ThreatDrop case and workflow status.

The free community tools need no key but are delayed by 72 hours, redacted, aggregated and rate-limited. A BlackDome API key unlocks paid features such as the live attacker-typed credential feed, payloads, actors, the warboard and STIX export. Errors are explicit: no key gives a 401 on paid tools, a wrong plan returns 403, and there is no silent fallback to free data. The whoami tool reports your plan, features and live quota.

You can use the hosted endpoint at api.blackdome.ai/mcp or run the pypi package locally with uvx blackdome-mcp. The credential feed is attacker-typed data from the honeypots, not breach dumps.

## Features

- **Attacker IP dossiers:** lookup_attacker_ip returns events, protocols, masked credentials, MITRE mapping and edge nodes.
- **Top attackers:** top_attackers ranks the most active IPs over a time window.
- **Attack map:** attack_map shows recent geolocated events.
- **Plan check:** whoami reports plan, features and quota.
- **Tiered access:** Free delayed and redacted data; paid tiers are real time and unredacted.
- **ThreatDrop status:** Retrieve case and workflow status for forwarded suspicious emails.

## Good for

- Look up an IP seen in your logs against honeypot evidence
- Pull recent IOC bundles for a red-team engagement
- Compare malware samples deterministically
- Check the status of a forwarded phishing email

## Install

### Claude Code (Terminal)

```sh
claude mcp add blackdome-mcp --env BLACKDOME_API_KEY='<BLACKDOME_API_KEY>' -- uvx blackdome-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "blackdome-mcp": {
      "command": "uvx",
      "args": [
        "blackdome-mcp"
      ],
      "env": {
        "BLACKDOME_API_KEY": "<BLACKDOME_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "blackdome-mcp": {
      "command": "uvx",
      "args": [
        "blackdome-mcp"
      ],
      "env": {
        "BLACKDOME_API_KEY": "<BLACKDOME_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "blackdome-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "blackdome-mcp"
      ],
      "env": {
        "BLACKDOME_API_KEY": "<BLACKDOME_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "blackdome-mcp": {
      "command": "uvx",
      "args": [
        "blackdome-mcp"
      ],
      "env": {
        "BLACKDOME_API_KEY": "<BLACKDOME_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "blackdome-mcp": {
      "command": "uvx",
      "args": [
        "blackdome-mcp"
      ],
      "env": {
        "BLACKDOME_API_KEY": "<BLACKDOME_API_KEY>"
      }
    }
  }
}
```

## Tools

- `lookup_attacker_ip`: Returns a full dossier for one attacker IP.
- `top_attackers`: Lists the most active attacker IPs over a window.
- `attack_map`: Shows recent geolocated attack events.
- `whoami`: Reports your plan, features and live quota.

## FAQ

### Do I need an API key?

Not for the free community tools. Credential intel, payloads, actors, warboard and STIX export require one.

### How fresh is the free data?

The pricing page lists a 72-hour delay on the Community plan.

### Where does the data come from?

The site says it is first-party, captured on BlackDome's own honeypot network.

### How do I run it?

Use the hosted https://api.blackdome.ai/mcp or run uvx blackdome-mcp locally.

### Is BlackDome Threat Intel free?

BlackDome Threat Intel has a free plan, with paid plans for more usage or features.

### How do I add BlackDome Threat Intel to Claude Code?

Run this command in your terminal: claude mcp add blackdome-mcp --env BLACKDOME_API_KEY='<BLACKDOME_API_KEY>' -- uvx blackdome-mcp

### What are the best alternatives to BlackDome Threat Intel?

The closest alternatives to BlackDome Threat Intel are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/blackdome-threat-intel-2
