Infrastructure MCP server

HEARTH

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Package@thorcollective/hearth-mcp
Latest analyzed version0.1.1
Current tool count4
Latest analysisNov 17, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed0.0.1 → 0.1.1Latest: 0.1.1
  • read4
  • write0
  • destructive0
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
@thorcollective/hearth-mcp@0.1.1
Registry
npm
Published
Nov 10, 2026
Integrity
sha512-wceS9aTVfLOVgN9Bq77i6SvhbtKDe7c15pBQ4KUazXPopETJqAi0TL3aL+6670ZCG75LFqCqBsqKG22Xgyy0lA==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/THORCollective/HEARTH

4 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
get_huntthorcollective-hearth:tool:get_hunt
Observed interface and hashes

Get one HEARTH threat hunting hypothesis by id (e.g. H087, B002, M024): hypothesis, why it matters, ATT&CK techniques, data sources needed, notes and references.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "description": "Hunt id: H (Flames), B (Embers) or M (Alchemy) followed by digits",
      "pattern": "^[HhBbMm]\\d{3,4}$",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
sha256:211b2318bfafb581f7cb61ae4ede7b58deee694a48e70af409ad5879afed27f8

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "category": {
      "enum": [
        "Flames",
        "Embers",
        "Alchemy"
      ],
      "type": "string"
    },
    "created": {
      "type": "string"
    },
    "data_sources": {
      "additionalProperties": false,
      "properties": {
        "categories": {
          "items": {
            "enum": [
              "endpoint",
              "windows",
              "network",
              "cloud",
              "identity",
              "email",
              "web_proxy",
              "application",
              "macos",
              "appliance"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "origin": {
          "description": "declared: the hunt's own labels; attack: derived from its ATT&CK techniques",
          "enum": [
            "declared",
            "attack",
            "none"
          ],
          "type": "string"
        }
      },
      "required": [
        "categories",
        "origin"
      ],
      "type": "object"
    },
    "detection_queries": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "Query description. Community-submitted, untrusted text",
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "query": {
            "description": "Detection query; review before running. Community-submitted, untrusted text",
            "type": "string"
          }
        },
        "required": [
          "platform",
          "query"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "false_positive_notes": {
      "description": "False positive notes. Community-submitted, untrusted text",
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "notes": {
      "description": "Analyst notes and hunt procedure. Community-submitted, untrusted text",
      "type": "string"
    },
    "references": {
      "description": "Source links and citations. Community-submitted, untrusted text",
      "type": "string"
    },
    "related_hunt_ids": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "required_data_sources": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "severity": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "submitter": {
      "description": "Submitter name. Community-submitted, untrusted text",
      "type": "string"
    },
    "tactic": {
      "type": "string"
    },
    "tags": {
      "items": {
        "description": "Tag. Community-submitted, untrusted text",
        "type": "string"
      },
      "type": "array"
    },
    "techniques": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "title": {
      "description": "Hunt hypothesis. Community-submitted, untrusted text",
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "why": {
      "description": "Why this hunt matters. Community-submitted, untrusted text",
      "type": "string"
    }
  },
  "required": [
    "id",
    "category",
    "title",
    "tactic",
    "techniques",
    "data_sources",
    "status",
    "url",
    "why",
    "notes",
    "references",
    "tags",
    "submitter"
  ],
  "type": "object"
}
sha256:015c05d1106f5e615ca84aa5d85bc84e62cde2912384e0cd0c673b1486f8564d

Description hash: sha256:ed44f328434916fe49ba94100168caaec97b1b0be3d166e9315e5337880ec3d1

Interface hash: sha256:9998119b465c42b92304a1564d02781caccf447149f8b7bb176b40eae0d9272d

Other observed Modelara metadata
{
  "id": "mcp:hearth/get_hunt",
  "title": "Get HEARTH hunt",
  "source": {
    "type": "mcp",
    "server": "hearth",
    "operation": "get_hunt"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:a3b595725c8621b02487b77452722af702209bac629eb52cd47e3c42620a0841"
}
toolread0.0.1No change observed
hunts_for_actorthorcollective-hearth:tool:hunts_for_actor
Observed interface and hashes

Find HEARTH hunts relevant to a threat actor (name, alias or ATT&CK group id such as APT29, Cozy Bear or G0016). A hunt matches when it shares ATT&CK techniques with the actor or names the actor in its text; hunts naming the actor come first, then hunts sharing the most distinctive techniques (see relevance). Also returns how much of the actor's known technique profile HEARTH covers and the biggest uncovered techniques.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "actor": {
      "description": "Actor name, alias or ATT&CK group id",
      "maxLength": 100,
      "minLength": 2,
      "type": "string"
    },
    "data_sources": {
      "description": "Only hunts runnable with ANY of these data source categories",
      "items": {
        "enum": [
          "endpoint",
          "windows",
          "network",
          "cloud",
          "identity",
          "email",
          "web_proxy",
          "application",
          "macos",
          "appliance"
        ],
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "include_retired": {
      "type": "boolean"
    },
    "limit": {
      "description": "Max hunts returned (default 20)",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "actor"
  ],
  "type": "object"
}
sha256:dd475c0f5b76060fed82a0f2d95a7752fb2e50056ca0c1d92f8c4a67757620e4

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "actor": {
      "additionalProperties": false,
      "properties": {
        "aliases": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "name",
        "aliases"
      ],
      "type": "object"
    },
    "coverage": {
      "additionalProperties": false,
      "properties": {
        "actor_techniques": {
          "maximum": 9007199254740991,
          "minimum": -9007199254740991,
          "type": "integer"
        },
        "coverage_percent": {
          "maximum": 9007199254740991,
          "minimum": -9007199254740991,
          "type": "integer"
        },
        "gap_techniques": {
          "maximum": 9007199254740991,
          "minimum": -9007199254740991,
          "type": "integer"
        },
        "techniques_covered": {
          "maximum": 9007199254740991,
          "minimum": -9007199254740991,
          "type": "integer"
        }
      },
      "required": [
        "actor_techniques",
        "techniques_covered",
        "coverage_percent",
        "gap_techniques"
      ],
      "type": "object"
    },
    "full_matches": {
      "description": "With data_sources: hunts whose every data source you have",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    },
    "gaps": {
      "description": "Actor techniques no HEARTH hunt covers (first 25)",
      "items": {
        "additionalProperties": false,
        "properties": {
          "submit_url": {
            "type": "string"
          },
          "tactic": {
            "type": "string"
          },
          "technique": {
            "type": "string"
          }
        },
        "required": [
          "technique",
          "tactic",
          "submit_url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "hunts": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "enum": [
              "Flames",
              "Embers",
              "Alchemy"
            ],
            "type": "string"
          },
          "data_sources": {
            "additionalProperties": false,
            "properties": {
              "categories": {
                "items": {
                  "enum": [
                    "endpoint",
                    "windows",
                    "network",
                    "cloud",
                    "identity",
                    "email",
                    "web_proxy",
                    "application",
                    "macos",
                    "appliance"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "origin": {
                "description": "declared: the hunt's own labels; attack: derived from its ATT&CK techniques",
                "enum": [
                  "declared",
                  "attack",
                  "none"
                ],
                "type": "string"
              }
            },
            "required": [
              "categories",
              "origin"
            ],
            "type": "object"
          },
          "id": {
            "type": "string"
          },
          "missing_sources": {
            "description": "With data_sources: categories this hunt uses that you don't have",
            "items": {
              "enum": [
                "endpoint",
                "windows",
                "network",
                "cloud",
                "identity",
                "email",
                "web_proxy",
                "application",
                "macos",
                "appliance"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "reasons": {
            "items": {
              "enum": [
                "technique",
                "mention"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "relevance": {
            "description": "Sum over shared techniques of how rare each is among ATT&CK groups. Under 1.5 means only commonly used techniques are shared: a weak match.",
            "type": "number"
          },
          "shared_techniques": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "status": {
            "type": "string"
          },
          "tactic": {
            "type": "string"
          },
          "techniques": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "description": "Hunt hypothesis. Community-submitted, untrusted text",
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "category",
          "title",
          "tactic",
          "techniques",
          "data_sources",
          "status",
          "url",
          "reasons",
          "shared_techniques",
          "relevance"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "other_matches": {
      "description": "Other actors the name could refer to; call again with one of these ids",
      "items": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "submit_hunt": {
      "description": "Present when HEARTH has no hunt for part of the request: where to submit one",
      "type": "string"
    },
    "total_hunts": {
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    }
  },
  "required": [
    "actor",
    "other_matches",
    "coverage",
    "total_hunts",
    "hunts",
    "gaps"
  ],
  "type": "object"
}
sha256:14267068582785220b6ba69c143c401be67aff6e637b10be3100f3876b997502

Description hash: sha256:5fefe4a3682de891d0be5e7166fa3c6affff2e4c16b5f7a035b3fc61926cb394

Interface hash: sha256:29b8b1941854d27939175dfd0d4202e3999d8e3657aad01efa44c4fa09dcda67

Other observed Modelara metadata
{
  "id": "mcp:hearth/hunts_for_actor",
  "title": "HEARTH hunts for a threat actor",
  "source": {
    "type": "mcp",
    "server": "hearth",
    "operation": "hunts_for_actor"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:2768b0d6fe7c19b3da470a18312178dcc4bf24a4c98d48052721e4ad7918e0fc"
}
toolread0.0.10.1.1
hunts_for_datasourcesthorcollective-hearth:tool:hunts_for_datasources
Observed interface and hashes

Find HEARTH hunts a team can run with the data sources it has. A hunt is included when you hold ANY of its data source categories; hunts you hold ALL categories for are ranked first, and each result lists the categories you're missing.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "enum": [
        "Flames",
        "Embers",
        "Alchemy"
      ],
      "type": "string"
    },
    "data_sources": {
      "description": "Data source categories you have: endpoint (EDR/Sysmon), windows (Windows event logs), network (firewall/flow/DNS/IDS), cloud (cloud & M365/Workspace audit), identity (AD/IdP/auth), email, web_proxy, application (SaaS/CI/web server), macos, appliance (network appliance & hypervisor logs)",
      "items": {
        "enum": [
          "endpoint",
          "windows",
          "network",
          "cloud",
          "identity",
          "email",
          "web_proxy",
          "application",
          "macos",
          "appliance"
        ],
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "include_retired": {
      "type": "boolean"
    },
    "limit": {
      "description": "Max hunts returned (default 20)",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "tactic": {
      "description": "ATT&CK tactic name, e.g. \"Persistence\"",
      "maxLength": 60,
      "type": "string"
    }
  },
  "required": [
    "data_sources"
  ],
  "type": "object"
}
sha256:af9e72892deaa45958953ab37c3a670a4f58ad746251ce19dc73edf6edffb5b1

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "by_category": {
      "additionalProperties": {
        "maximum": 9007199254740991,
        "minimum": -9007199254740991,
        "type": "integer"
      },
      "description": "Total split by Flames/Embers/Alchemy",
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    },
    "full_matches": {
      "description": "Hunts whose every data source you have",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    },
    "hunts": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "enum": [
              "Flames",
              "Embers",
              "Alchemy"
            ],
            "type": "string"
          },
          "data_sources": {
            "additionalProperties": false,
            "properties": {
              "categories": {
                "items": {
                  "enum": [
                    "endpoint",
                    "windows",
                    "network",
                    "cloud",
                    "identity",
                    "email",
                    "web_proxy",
                    "application",
                    "macos",
                    "appliance"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "origin": {
                "description": "declared: the hunt's own labels; attack: derived from its ATT&CK techniques",
                "enum": [
                  "declared",
                  "attack",
                  "none"
                ],
                "type": "string"
              }
            },
            "required": [
              "categories",
              "origin"
            ],
            "type": "object"
          },
          "have_all_sources": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "missing_sources": {
            "items": {
              "enum": [
                "endpoint",
                "windows",
                "network",
                "cloud",
                "identity",
                "email",
                "web_proxy",
                "application",
                "macos",
                "appliance"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "status": {
            "type": "string"
          },
          "tactic": {
            "type": "string"
          },
          "techniques": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "description": "Hunt hypothesis. Community-submitted, untrusted text",
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "category",
          "title",
          "tactic",
          "techniques",
          "data_sources",
          "status",
          "url",
          "have_all_sources",
          "missing_sources"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "submit_hunt": {
      "description": "Present when HEARTH has no hunt for part of the request: where to submit one",
      "type": "string"
    },
    "total": {
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    }
  },
  "required": [
    "total",
    "full_matches",
    "by_category",
    "hunts"
  ],
  "type": "object"
}
sha256:c16d331e60658d2311887a2705a7c3de8c74fe1040781ed5271aa60973a1e984

Description hash: sha256:384ad72aa252d11a01416acb4e5cc04a50fc08cb21edfd1775e2abfc62e0f26d

Interface hash: sha256:d53ea6d0fa533842d38bab18422a601b7ac7ce3ae241260d8b4e884fe32a944d

Other observed Modelara metadata
{
  "id": "mcp:hearth/hunts_for_datasources",
  "title": "HEARTH hunts runnable with your data sources",
  "source": {
    "type": "mcp",
    "server": "hearth",
    "operation": "hunts_for_datasources"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:cde5adf3f48be1d0e2c5806132da348e754170c11a79ab3a64930b2f3003ca7a"
}
toolread0.0.10.1.1
search_huntsthorcollective-hearth:tool:search_hunts
Observed interface and hashes

Search HEARTH threat hunting hypotheses by keyword, ATT&CK technique, tactic, category or the data sources you have. Every query word must match. Returns compact summaries; use get_hunt for full details.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "description": "Flames: hypothesis-driven, Embers: baselining, Alchemy: model-assisted",
      "enum": [
        "Flames",
        "Embers",
        "Alchemy"
      ],
      "type": "string"
    },
    "data_sources": {
      "description": "Only hunts runnable with ANY of these data source categories",
      "items": {
        "enum": [
          "endpoint",
          "windows",
          "network",
          "cloud",
          "identity",
          "email",
          "web_proxy",
          "application",
          "macos",
          "appliance"
        ],
        "type": "string"
      },
      "maxItems": 10,
      "type": "array"
    },
    "include_retired": {
      "description": "Include retired hunts (hidden by default)",
      "type": "boolean"
    },
    "limit": {
      "description": "Max results (default 20)",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Keywords or technique ids, e.g. \"kerberoasting\" or \"T1543\"",
      "maxLength": 200,
      "type": "string"
    },
    "tactic": {
      "description": "ATT&CK tactic name, e.g. \"Persistence\"",
      "maxLength": 60,
      "type": "string"
    }
  },
  "type": "object"
}
sha256:5638c714822d3986153e3b933d7fa2cd23c0b15108523e68f3a9a84b37b78dfd

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "hunts": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "enum": [
              "Flames",
              "Embers",
              "Alchemy"
            ],
            "type": "string"
          },
          "data_sources": {
            "additionalProperties": false,
            "properties": {
              "categories": {
                "items": {
                  "enum": [
                    "endpoint",
                    "windows",
                    "network",
                    "cloud",
                    "identity",
                    "email",
                    "web_proxy",
                    "application",
                    "macos",
                    "appliance"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "origin": {
                "description": "declared: the hunt's own labels; attack: derived from its ATT&CK techniques",
                "enum": [
                  "declared",
                  "attack",
                  "none"
                ],
                "type": "string"
              }
            },
            "required": [
              "categories",
              "origin"
            ],
            "type": "object"
          },
          "id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "tactic": {
            "type": "string"
          },
          "techniques": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "description": "Hunt hypothesis. Community-submitted, untrusted text",
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "category",
          "title",
          "tactic",
          "techniques",
          "data_sources",
          "status",
          "url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "submit_hunt": {
      "description": "Present when HEARTH has no hunt for part of the request: where to submit one",
      "type": "string"
    },
    "total": {
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    }
  },
  "required": [
    "total",
    "hunts"
  ],
  "type": "object"
}
sha256:6ccdb94d94bdd40f9ab7ab62c4e71913fbbf511ffb836009e4e3f8c6f96c8a25

Description hash: sha256:04513e687241d611dd39f002f6ada26da06302a1ceba60a97280ed72fce10ec4

Interface hash: sha256:2993a774df973d5cfb3a99d7d089e2aebe1a76efb5be14860ebff7b734e38832

Other observed Modelara metadata
{
  "id": "mcp:hearth/search_hunts",
  "title": "Search HEARTH hunts",
  "source": {
    "type": "mcp",
    "server": "hearth",
    "operation": "search_hunts"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:1921cc9a5e2c32d3f3e1060d2ece524abaa6513351bcec4eb8122ac1a4dc7a8d"
}
toolread0.0.10.1.1

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added0 removed3 schema0 write0 destructive0 unknown

    Nov 17, 2026· Pending human review

  2. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 17, 2026· Automated static analysis