subdomain-finder-mcp
A passive, read-only subdomain recon server that mines live certificate transparency logs and public DNS to map a domain's attack surface.
find_subdomains— enumerate deduplicated hostnames for a domain from certspotter (unexpired) or crt.sh (incl. expired), with first/last seen dates, certificate counts, issuers and wildcard flags; optionally resolve the first 40 names.resolve_subdomains— resolve up to 40 hosts via Cloudflare DNS over HTTPS (A, AAAA, CNAME chain), marking live, NXDOMAIN, no-records and dangling CNAMEs (subdomain-takeover leads), naming cloud platforms behind CNAMEs and detecting wildcard DNS.get_certificate_history— certificate details for one host (or its subdomains): issuer org/DN, validity dates, all SANs, revocation status, SHA-256, plus first/latest issuance and CA changes.summarize_attack_surface— group a domain's CT hostnames into dev/test, staging, admin, API, auth, mail, VPN, storage and legacy buckets, with naming clusters, issuers and the newest names.All results are structured JSON with a summary,
as_of, source URL and a link to the matching web tool — no API key, no sign-up, nothing sent to the target.
Uses Cloudflare DNS over HTTPS to resolve subdomains and retrieve A, AAAA, and CNAME records, enabling live-host checks, NXDOMAIN/no-record status, dangling CNAME detection, and wildcard DNS detection.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@subdomain-finder-mcp Find subdomains of example.com and tell me which are live"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
subdomain-finder-mcp
Passive subdomain finder for AI assistants: live certificate transparency lookups (certspotter, crt.sh) with DNS checks over Cloudflare DNS over HTTPS.
This is a Model Context Protocol (MCP) server for subdomain enumeration in bug bounty and security recon. It reads public certificate transparency (CT) logs, deduplicates the names, handles wildcard certificates, and reports first seen, last seen and issuer for each host. It can then resolve the hosts to mark which are live and which have dangling CNAMEs. It needs no API key.
Passive and read-only
It only reads public CT logs and public DNS. It sends nothing to the target's servers.
No port scanning, no HTTP probing, no brute-force wordlists.
Use it on domains you own or are authorised to test, for example inside a bug bounty program's scope.
Related MCP server: External Reconnaissance MCP Server
Tools
Tool | What it returns |
| Deduplicated hostnames for a domain from CT logs, with first seen, last seen, valid until, certificate count, issuers and a wildcard flag. Optional DNS check of up to 40 names. |
| A, AAAA and CNAME chain for up to 40 hosts. Marks live, NXDOMAIN, no records and dangling CNAMEs, names cloud services behind CNAMEs, and detects wildcard DNS. |
| Certificates for one host: issuer, validity dates, every SAN, revocation status and SHA-256, plus first and latest issuance and the issuers used. |
| The domain's CT hostnames grouped into development and test, staging, admin, API, auth, mail, remote access, storage and legacy, with naming clusters, issuers and the newest names. |
Every result has structured JSON, a one-paragraph summary, as_of, source (the CT or DNS query URL) and more (the matching tool on bugbountyreality.com).
What it knows that your model does not
A domain's current subdomains. New hosts appear in CT logs within minutes of getting a certificate; a model's training data is months old and never had most of them.
Which hosts resolve right now, which CNAMEs point at a deleted cloud resource, and whether the zone has wildcard DNS.
Certificate history: when each name first got a certificate, which CAs issued it, and when the current one expires.
How to read CT data cleanly: precertificate and certificate rows merged, e-mail SANs and out-of-scope names dropped,
*.entries reported as wildcards instead of hosts.
Install
Hosted (Claude.ai custom connector, ChatGPT developer mode)
Paste this URL. No token, no sign-up.
https://subdomain-finder-mcp.lipmichal.workers.dev/mcpClaude Code
claude mcp add --transport http subdomain-finder https://subdomain-finder-mcp.lipmichal.workers.dev/mcpOr run it locally over stdio:
claude mcp add subdomain-finder -- npx -y github:theluckystrike/subdomain-finder-mcpClaude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"subdomain-finder": { "command": "npx", "args": ["-y", "github:theluckystrike/subdomain-finder-mcp"] }
}
}Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"subdomain-finder": { "url": "https://subdomain-finder-mcp.lipmichal.workers.dev/mcp" }
}
}VS Code
Add to .vscode/mcp.json:
{
"servers": {
"subdomain-finder": { "type": "http", "url": "https://subdomain-finder-mcp.lipmichal.workers.dev/mcp" }
}
}Node 20 or newer is needed for the local stdio version. The local version uses your own IP for the CT and DNS lookups, so it has its own rate-limit allowance.
Example prompts
"Find subdomains of hackerone.com from certificate transparency and tell me which are live."
"Which of these hosts have dangling CNAMEs: assets.example.com, docs.example.com, status.example.com?"
"Show the certificate history for api.example.com. Did they change CA this year?"
"Summarise the attack surface of example.com. Any staging, admin or VPN hosts?"
"Include expired certificates and list hosts under example.com that first appeared before 2020."
Data sources
All public and keyless. Full list with fetch dates in DATA_SOURCES.md.
SSLMate certspotter CT Search API (api.certspotter.com), unexpired certificates. Primary.
crt.sh, including expired certificates. Fallback, and used when
include_expiredis true.Cloudflare DNS over HTTPS (cloudflare-dns.com/dns-query).
Limitations
Certificate transparency only shows names that got a publicly trusted certificate. Hosts behind a wildcard certificate (
*.example.com) or with no TLS never appear by name. Pair it with other passive sources for full coverage.certspotter's keyless tier is rate limited per IP (
x-ratelimit-limit: 10observed). Results are cached for an hour, the tool reads at most 5 pages per call, and it falls back to crt.sh when certspotter throttles. If both throttle, the error says to wait a few minutes.crt.sh is often slow or overloaded, and two calls minutes apart can return different rows (its database replicas lag). Calls time out after 25 seconds, retry once, then fail with a clear message.
Very large domains return the first pages only; the result says when it was truncated.
DNS checks are capped at 40 hosts per call. A "dangling CNAME" is a lead to verify inside an authorised scope, not proof of a vulnerability.
More
The web versions of these tools, a subdomain takeover checker and a manual recon checklist are on bugbountyreality.com. See also the certificate transparency lookup and the subdomain enumeration checklist.
Part of the Zovo MCP collection: https://mcp.zovo.one
Development
npm install
npm test # builds, then runs the fixture tests against saved CT and DNS payloads
node scripts/smoke-stdio.mjs # live stdio check, one real call per tool
npx wrangler deploy # Cloudflare Worker, Streamable HTTP at /mcpLicense
MIT
More data servers from the same author
Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.
server | tools | hosted URL |
convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature |
| |
calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary |
| |
get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units |
| |
search_lakes, get_lake_level, get_lake_history, compare_lakes |
| |
get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage |
| |
calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility |
| |
calculate_take_home_pay, compare_states_take_home, salary_to_hourly, hourly_to_salary, get_federal_tax_brackets |
| |
calculate_uk_take_home, get_uk_tax_bands, compare_salaries, marginal_rate_at_income |
| |
list_federal_holidays, is_business_day, add_business_days, count_business_days, invoice_due_date |
| |
calculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_risk |
| |
get_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_cap |
| |
get_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_composite |
| |
calculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credit |
| |
get_exemption_amounts, calculate_estate_tax, check_gift, compare_years |
| |
lookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutrition |
| |
get_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_years |
| |
calculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_payment |
| |
calculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dates |
| |
calculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibility |
|
The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one
More from zovo
All free zovo VS Code extensions - file viewers, database clients, formatters. Offline, no telemetry, no sign-up.
Full MCP server catalogue - local-first MCP servers for back-office work: invoices, VAT, PDFs, spreadsheets, payroll.
Hosted no-install MCP endpoints - paste a URL in Claude / Cursor, nothing to install.
Available Tools
4 toolsfind_subdomainsFind subdomains (certificate transparency)ARead-onlyIdempotentInspect
Passive subdomain enumeration for a domain from live certificate transparency logs: certspotter (unexpired certificates) with crt.sh as fallback or for expired history. Returns deduplicated hostnames with first seen and last seen issuance dates, certificate count, issuers and whether a wildcard certificate covers the name, plus the list of wildcard entries. Set resolve=true to also check the first 40 names with DNS over HTTPS and mark live hosts. Passive lookup of public certificate transparency logs; nothing is sent to the target. Use it on assets you own or are authorised to test.
Inputs: domain (required), limit, source, resolve, +2 more.
get_certificate_historyGet certificate history for a hostARead-onlyIdempotentInspect
Certificates logged in certificate transparency for one hostname (or a whole domain with include_subdomains): issuer organisation and DN, not_before and not_after dates, every SAN on the certificate, revocation status and SHA-256 where certspotter has them. Summarises first and last issuance and the issuers used, which shows CA changes and renewal cadence. Default source certspotter (unexpired); include_expired uses crt.sh for the full history.
Inputs: host (required), limit, source, include_expired, +1 more.
resolve_subdomainsResolve subdomains (DNS over HTTPS)ARead-onlyIdempotentInspect
Resolve up to 40 hostnames now through Cloudflare DNS over HTTPS (A, AAAA and the CNAME chain). Each host is marked live, nxdomain, no_records or dangling_cname (a CNAME whose target does not exist, a subdomain takeover lead), and CNAME targets on cloud platforms (S3, Azure, Heroku, GitHub Pages, Netlify, Vercel and others) are named. Also probes a random label per parent domain to detect wildcard DNS. DNS lookups only; no connection is made to the hosts.
Inputs: hosts (required), check_wildcard.
summarize_attack_surfaceSummarize attack surface from CTARead-onlyIdempotentInspect
Reads a domain's subdomains from live certificate transparency and groups them for recon triage: development and test, staging, admin and internal tools, APIs, authentication, mail, remote access (VPN), storage and CDN, legacy and backup. Each group has a count, examples and why it matters. Also returns naming clusters (for example *.eu.example.com), certificate issuers in use, wildcard entries and the 10 newest names. Passive only.
Inputs: domain (required), source, include_expired.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct core action (enumerate, resolve, certificate lookup, triage summary), but find_subdomains and summarize_attack_surface both read the same certificate transparency sources for a domain and differ mainly in output presentation. find_subdomains' resolve=true flag also overlaps with resolve_subdomains, so an agent may pick the wrong entry point for a simple DNS check.
All four tools follow a clean verb_noun snake_case pattern (find_, resolve_, get_, summarize_) with the resource as the noun. No mixed conventions or vague verbs.
Four tools is on the lean side but each covers a genuinely different stage of the recon workflow (enumerate, resolve, inspect certs, triage). Nothing feels redundant enough to remove, though the surface is close to thin.
The toolset covers a coherent end-to-end passive recon lifecycle: discovery, DNS liveness/takeover detection, certificate history, and grouped reporting. Minor gaps remain, such as no export/save of results and no way to feed discovered names directly into history lookups in bulk, but core workflows are covered.
Related MCP Connectors
Passive OSINT and security recon: DNS, TLS, email posture, IP reputation, CVE/KEV, CT logs.
Certificate Transparency search: subdomains, certificate history and hostname keyword search.
Certificate transparency and DNS history: certificates, past IPs, reverse IP and new domains.
WHOIS/RDAP, DNS, SSL, live subdomains with IPs, and SPF/DMARC/DKIM for any domain.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables ethical security testing and attack surface management through SSL certificate validation, CVE queries, subdomain enumeration, security header analysis, and comprehensive reconnaissance capabilities. Designed for authorized penetration testing workflows with responsible disclosure practices.-
- FlicenseNot gradedqualityDmaintenanceEnables external reconnaissance activities including DNS enumeration, subdomain discovery, email security analysis, and SSL certificate inspection against a target domain.14-
- AlicenseNot gradedqualityBmaintenancePassive external attack-surface mapping server that discovers subdomains, DNS records, TLS posture, HTTP headers, and registration data via public sources like CT logs, Shodan, and RDAP/WHOIS, enabling security reconnaissance without active scanning.158 npm4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables searching Certificate Transparency logs for TLS certificates issued for a domain and its subdomains, retrieving certificate details like issuer, validity, serial, and SANs, and looking up individual certificates by ID or serial.59 npmMIT