MCP documentation menu

datapulse_dns_neighborhood

OtherScope: datapulse:dnsRead-only

Looks 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

ParameterTypeDescription
cluster_idinteger
Cluster ID to look up.
domainstring
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: (sent as ).
Min length: 1Max length: 253
is_anomalyboolean
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.