# HEARTH

The HEARTH MCP server for Claude Code searches community threat-hunting hypotheses by keyword, actor, or available log sources. It helps match hunts to the telemetry a team has.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 364 repo stars
- Author: THORCollective
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/THORCollective/HEARTH/tree/HEAD/mcp
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hearth

## What it does

HEARTH searches a community collection of threat-hunting hypotheses. It can return a hunt’s rationale, queries, notes, and references, search by category or tactic, and find hunts associated with a named threat actor. It can also compare available log sources with hunt requirements. Its tools only read data.

The server runs through `npx` and requires Node.js 20 or later. It checks periodically for updated hunt data; if the site cannot be reached, it falls back to a saved copy or the snapshot shipped with the package. Set `HEARTH_OFFLINE=1` to prevent network requests. Review hunt queries before running them: community members contribute the content.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add hearth -- npx -y @thorcollective/hearth-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp -- npx -y @thorcollective/hearth-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@thorcollective/hearth-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@thorcollective/hearth-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp npx -y @thorcollective/hearth-mcp
```

## When to use it
- find hunts linked to a threat actor
- match hunt hypotheses to available log sources
- retrieve queries and references for a hunt
- identify missing data sources for a hunt

## Example prompts
- Find hunts for Volt Typhoon that use firewall and network appliance logs.
- Show hypotheses about persistence on macOS.
- Which hunts can we run fully with Windows endpoint and identity logs?

## Similar
- [secops-hunt](https://affpapa.org/en/nevibecode/skills/secops-hunt.md) — skill · 1900 installs
- [dt-sec-ioc-hunting](https://affpapa.org/en/nevibecode/skills/dt-sec-ioc-hunting.md) — skill · 1400 installs
- [dalonso-security-repo](https://affpapa.org/en/nevibecode/skills/dalonso-security-repo.md) — skill · 251 installs
- [crowdsentinel-mcp-server](https://affpapa.org/en/nevibecode/mcp/crowdsentinel-mcp-server.md) — MCP server · ★ 204 repo stars
- [Defender Scout KQL](https://affpapa.org/en/nevibecode/agents/defender-scout-kql.md) — subagent · ★ 41430 repo stars
- [detection-engineer](https://affpapa.org/en/nevibecode/agents/detection-engineer.md) — subagent · ★ 2482 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
