Find subdomains
find_subdomainsList known subdomains (hostnames) of a root domain. Data is passive (not active scanning): results are historic observations and may include subdomains that no longer resolve or are no longer live. Results are a point-in-time snapshot that changes over time as new subdomains are observed — re-query rather than caching the result. Use for attack-surface mapping, security recon, asset inventory, or SEO host discovery. Hostnames are returned most-recently-seen first. The response always reports total (full distinct count known) and a truncated flag, so you can tell when more exist beyond limit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>"
},
"name": "find_subdomains"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max subdomains to return (1-1000, default 200). `total` always reports the full count regardless of this cap. | |
| domain | Yes | Root (registrable) domain as a bare hostname, e.g. "example.com". No scheme, path, port, or leading "www." — these are stripped. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Total distinct subdomains known. | |
| domain | Yes | ||
| returned | Yes | Number in `subdomains`. | |
| truncated | Yes | True if more exist beyond `limit`. | |
| subdomains | Yes |