datapulse_dns_neighborhood
datapulse:dnsRead-onlyLooks up the DNS infrastructure cluster (HDBSCAN over the similarity embedding) a domain belongs to, or a cluster by ID. Every indexed …
Description
Looks up the DNS infrastructure cluster (HDBSCAN over the similarity embedding) a domain belongs to, or a cluster by ID. Every indexed domain is in exactly one normal or anomaly cluster.
Exactly one of domain or cluster_id; is_anomaly (true for an anomaly cluster ID) applies to cluster_id only. Returns a one-row JSON array: cluster_id, is_anomaly, cluster_name (a label from the cluster’s dominant nameserver patterns, not any member’s own DNS), member_count, density metrics, and exemplar_domain (the member closest to the centroid, a natural seed for datapulse_dns_dptechsim). A domain lookup adds anomaly_score and nearest_normal_dist.
Cluster membership says domains are built alike on similar providers; it does not link them to one operator.
Reference: datapulse_help(topic="infrastructure")
Parameters
| Parameter | Type | Description |
|---|---|---|
cluster_id | integer | Cluster ID to look up. |
domain | string | Domain to look up, e.g. google.com. Its spelling is canonicalized and no labels are removed (www. kept); a single label is refused. When canonicalizing changed more than letter case, a hint line reads submitted_domain: Min length: 1Max length: 253 |
is_anomaly | boolean | Set true when looking up an anomaly cluster by ID (default false). Applies to cluster_id lookups only. |
Input schema (JSON)
{
"additionalProperties": false,
"properties": {
"cluster_id": {
"description": "Cluster ID to look up.",
"type": "integer"
},
"domain": {
"description": "Domain to look up, e.g. google.com. Its spelling is canonicalized and no labels are removed (www. kept); a single label is refused. When canonicalizing changed more than letter case, a hint line reads submitted_domain: \u003cyour input\u003e (sent as \u003cname\u003e).",
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"is_anomaly": {
"description": "Set true when looking up an anomaly cluster by ID (default false). Applies to cluster_id lookups only.",
"type": "boolean"
}
},
"type": "object"
}Generated from the live server (DataPulse MCP v0.9-341-g27163c2) on October 20, 2026.