DNSBL Blacklist Check
blacklist_checkRead-onlyIdempotent
Check if an IP or domain is listed on email DNS blocklists (DNSBLs) to detect blacklisting issues.
Instructions
Check whether an IPv4 address (or a domain's A records) appears on email DNS blocklists (DNSBLs). Only open-access lists are queried (SORBS, SpamCop, UCEPROTECT-1, DroneBL, s5h); Spamhaus and Barracuda refuse public-resolver queries and are excluded.
Args:
query (string): an IPv4 address or a domain.
response_format ('markdown' | 'json'): output format (default 'markdown').
Returns: { ips[], listedCount, checked, results[{ip, hits[{list, listed, reason}]}], note }.
Example: "Is 203.0.113.5 blacklisted?" -> blacklist_check(query="203.0.113.5").
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | An IPv4 address or a domain to check against DNSBLs. | |
| response_format | No | Output format: 'markdown' for a human-readable summary (default) or 'json' for the full structured payload. | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| ips | Yes | ||
| listedCount | Yes | ||
| checked | Yes | ||
| results | Yes | ||
| note | Yes |