
WhoisXML API MCP Server
This connects Claude to WhoisXML API's suite of 30 domain intelligence tools, covering WHOIS lookups, DNS queries, IP geolocation, and threat data. You'd reach for it when building agents that need to investigate domains, validate email addresses, check domain availability, or pull threat intelligence on suspicious IPs. The breadth here is the point: instead of integrating a dozen different APIs, you get domain registration history, DNS records, reverse IP lookups, and bulk domain tools all through one MCP connection. Useful for security research workflows, brand monitoring, or any agent that needs to quickly pull authoritative data about internet infrastructure.
- tools
- 27
- auth
- Secret needed
- transport
- STDIO, HTTP
- env var
- 1
- last updated
- Nov 6, 2026
Tools
27 toolsPublic tool metadata for what this MCP can expose to an agent.
bulk_dns_lookupRun DNS lookups for up to 200 domain names per call. Emulated bulk (no native upstream bulk endpoint): the server fans out single DNS lookups concurrently and returns a unified envelope. Each input consumes 1 credit. For larger jobs, split client-side.2 params
Run DNS lookups for up to 200 domain names per call. Emulated bulk (no native upstream bulk endpoint): the server fans out single DNS lookups concurrently and returns a unified envelope. Each input consumes 1 credit. For larger jobs, split client-side.
domain_namesarrayquery_typestringbulk_email_verificationRun email verification for up to 10,000 emails per call. Native bulk (uses WhoisXML's Bulk Email Verification API). Each email consumes 1 credit. Returns inline if completes within 20s, otherwise returns a job_id to poll via bulk_job_status / bulk_job_results.1 params
Run email verification for up to 10,000 emails per call. Native bulk (uses WhoisXML's Bulk Email Verification API). Each email consumes 1 credit. Returns inline if completes within 20s, otherwise returns a job_id to poll via bulk_job_status / bulk_job_results.
emailsarraybulk_ip_geolocationRun IP geolocation lookups for up to 200 IP addresses per call. Emulated bulk (no native upstream bulk endpoint exists; the WhoisXML bulk-IP-geo product is CSV-only via web UI). The server fans out single IP geolocation lookups concurrently and returns a unified envelope. Each...1 params
Run IP geolocation lookups for up to 200 IP addresses per call. Emulated bulk (no native upstream bulk endpoint exists; the WhoisXML bulk-IP-geo product is CSV-only via web UI). The server fans out single IP geolocation lookups concurrently and returns a unified envelope. Each...
ip_addressesarraybulk_job_resultsFetch full per-input results for a completed native bulk job (created by bulk_whois or bulk_email_verification). If the job is still in-flight, returns status=running with progress; caller should retry later. Note: per-input order may differ from the original input order — the...1 params
Fetch full per-input results for a completed native bulk job (created by bulk_whois or bulk_email_verification). If the job is still in-flight, returns status=running with progress; caller should retry later. Note: per-input order may differ from the original input order — the...
job_idstringbulk_job_statusCheck progress of an in-flight bulk job created by bulk_whois or bulk_email_verification. Returns status (running|completed) and progress counters. Use bulk_job_results once status=completed.1 params
Check progress of an in-flight bulk job created by bulk_whois or bulk_email_verification. Returns status (running|completed) and progress counters. Use bulk_job_results once status=completed.
job_idstringbulk_subdomain_lookupDiscover subdomains for up to 200 domains per call. Emulated bulk (no native upstream bulk endpoint): the server fans out single subdomain lookups concurrently and returns a unified envelope. Reuses the in-memory cache of subdomain_lookup, so re-querying recently-fetched domai...1 params
Discover subdomains for up to 200 domains per call. Emulated bulk (no native upstream bulk endpoint): the server fans out single subdomain lookups concurrently and returns a unified envelope. Reuses the in-memory cache of subdomain_lookup, so re-querying recently-fetched domai...
domain_namesarraybulk_whoisRun WHOIS lookups for up to 10,000 domains per call. Native bulk (uses WhoisXML's Bulk WHOIS API). Each domain consumes 1 credit. Returns inline if completes within 20s, otherwise returns a job_id to poll via bulk_job_status / bulk_job_results.1 params
Run WHOIS lookups for up to 10,000 domains per call. Native bulk (uses WhoisXML's Bulk WHOIS API). Each domain consumes 1 credit. Returns inline if completes within 20s, otherwise returns a job_id to poll via bulk_job_status / bulk_job_results.
domainsarraycategorizationClassify a URL or domain into IAB content categories, website groups, and content classifications. Returns category labels with confidence scores for content filtering and brand safety.2 params
Classify a URL or domain into IAB content categories, website groups, and content classifications. Returns category labels with confidence scores for content filtering and brand safety.
minimum_confidencenumberurlstringdns_historyGet historical DNS records for a domain (forward) or find domains associated with an IP (reverse).5 params
Get historical DNS records for a domain (forward) or find domains associated with an IP (reverse).
domain_namestringip_addressstringlimitnumberrecord_typestringa · A · aaaa · AAAAsearch_typestringforward · reversedns_lookupPerform DNS record lookups for a domain. Supports A, AAAA, MX, NS, SOA, TXT, CNAME, PTR, SRV, CAA, DS, and DNSKEY record types, or "all" to retrieve every record type at once.2 params
Perform DNS record lookups for a domain. Supports A, AAAA, MX, NS, SOA, TXT, CNAME, PTR, SRV, CAA, DS, and DNSKEY record types, or "all" to retrieve every record type at once.
domain_namestringquery_typestringdomain_and_subdomain_discoveryFind newly registered domains and subdomains containing search terms, returning registration dates. Supports wildcard (*) patterns for partial matching — without wildcards the search is exact. Multiple terms use AND logic; use separate API calls for OR logic.5 params
Find newly registered domains and subdomains containing search terms, returning registration dates. Supports wildcard (*) patterns for partial matching — without wildcards the search is exact. Multiple terms use AND logic; use separate API calls for OR logic.
domain_search_termsstringdomain_search_terms_excludestringsincestringsubdomains_search_termsstringsubdomains_search_terms_excludestringdomain_infoGet enriched WHOIS registration information for a domain. Combines current WHOIS data with historical records to fill missing or redacted fields. Works for active and expired domains.1 params
Get enriched WHOIS registration information for a domain. Combines current WHOIS data with historical records to fill missing or redacted fields. Works for active and expired domains.
domain_namestringemail_verificationVerify an email address via syntax check, DNS MX lookup, and SMTP deliverability test. Also detects disposable/temporary addresses, role-based addresses (e.g. info@, noreply@), free email providers, and catch-all domains.6 params
Verify an email address via syntax check, DNS MX lookup, and SMTP deliverability test. Also detects disposable/temporary addresses, role-based addresses (e.g. info@, noreply@), free email providers, and catch-all domains.
check_if_email_is_catch_allbooleancheck_if_email_is_disposablebooleancheck_if_email_is_freebooleanemailstringvalidate_using_dnsbooleanvalidate_using_smtpbooleanip_netblocksLook up IP netblocks by IP address, ASN, or organization name. Returns CIDR ranges, ASN number and name, organization info, and registration/update dates for each matching netblock.6 params
Look up IP netblocks by IP address, ASN, or organization name. Returns CIDR ranges, ASN number and name, organization info, and registration/update dates for each matching netblock.
asnstringfrom_needlestringip_addressstringlimitnumbernetmask_valuenumberorganizationsstringipgeolocationGet location data for IP addresses, domains, or email addresses. Uses caller's IP if no address provided.4 params
Get location data for IP addresses, domains, or email addresses. Uses caller's IP if no address provided.
domain_namestringemail_addressstringip_addressstringreverse_ipbooleanreverse_dnsFind DNS records matching search criteria. Returns domains and DNS record values. Multiple search terms are combined with AND logic - results must match ALL terms. Use separate API calls for OR logic. Must use wildcards in the "term" field for partial matches otherwise the sea...5 params
Find DNS records matching search criteria. Returns domains and DNS record values. Multiple search terms are combined with AND logic - results must match ALL terms. Use separate API calls for OR logic. Must use wildcards in the "term" field for partial matches otherwise the sea...
include_additional_checksbooleanlimitnumberpreviewbooleanrecord_typestringsoa · txt · cname · SOA · TXT · CNAMEtermsarrayreverse_ipFind all domains sharing the same IP address and connection dates.4 params
Find all domains sharing the same IP address and connection dates.
from_needlestringinclude_additional_checksbooleanipv4_addressstringpreviewbooleanreverse_mxFind all services sharing the same MX server and connection dates.4 params
Find all services sharing the same MX server and connection dates.
from_needlestringinclude_additional_checksbooleanmx_hostnamestringpreviewbooleanreverse_nsFind all services sharing the same NS nameserver and connection dates.4 params
Find all services sharing the same NS nameserver and connection dates.
from_needlestringinclude_additional_checksbooleanns_hostnamestringpreviewbooleanreverse_whoisFind domains whose WHOIS records contain specific search terms. Supports wildcard searches with * and partial string matching. Multiple terms use AND logic — domains must match ALL terms. Use separate API calls for OR logic.11 params
Find domains whose WHOIS records contain specific search terms. Supports wildcard searches with * and partial string matching. Multiple terms use AND logic — domains must match ALL terms. Use separate API calls for OR logic.
count_onlybooleancreated_date_fromstringcreated_date_tostringexcluded_search_termsstringinclude_audit_datesbooleanincluded_search_termsstringpunycodebooleansearch_afterstringsearch_typestringupdated_date_fromstringupdated_date_tostringreverse_whois_advancedFind domains using advanced field-specific search on WHOIS records. Each search term targets a specific WHOIS field (e.g., RegistrantContact.Organization, DomainName, NameServers) with optional exact match and exclude flags. Up to 4 search terms combined with AND logic.10 params
Find domains using advanced field-specific search on WHOIS records. Each search term targets a specific WHOIS field (e.g., RegistrantContact.Organization, DomainName, NameServers) with optional exact match and exclude flags. Up to 4 search terms combined with AND logic.
count_onlybooleancreated_date_fromstringcreated_date_tostringinclude_audit_datesbooleanpunycodebooleansearch_afterstringsearch_termsstringsearch_typestringupdated_date_fromstringupdated_date_tostringssl_certificatesRetrieve TLS certificate details for a domain, including issuer, validity period (not-before/not-after), subject alternative names (SANs), and chain trust status. Optionally returns the full certificate chain.3 params
Retrieve TLS certificate details for a domain, including issuer, validity period (not-before/not-after), subject alternative names (SANs), and chain trust status. Optionally returns the full certificate chain.
domainstringinclude_chainbooleanuse_fresh_databooleansubdomain_lookupDiscover all known subdomains of a domain, including first-seen and last-seen timestamps for each. Can return thousands of subdomains; use pagination to retrieve large result sets.3 params
Discover all known subdomains of a domain, including first-seen and last-seen timestamps for each. Can return thousands of subdomains; use pagination to retrieve large result sets.
domain_namestringlimitnumbernext_page_tokenstringthreat_intelligenceCheck if an IoC (domain, URL, IP, CIDR, or file hash) appears in known malware, phishing, spam, or botnet databases. Returns threat classification, severity, and source feed details.2 params
Check if an IoC (domain, URL, IP, CIDR, or file hash) appears in known malware, phishing, spam, or botnet databases. Returns threat classification, severity, and source feed details.
limitnumbersearch_termstringtyposquattingCheck whether a domain is part of a known typosquatting group, or expand all domains across all groups the queried domain belongs to. Use mode="probe" for a fast triage check (returns inGroup boolean + groupId). Use mode="group" for the heavy follow-up that returns every domai...2 params
Check whether a domain is part of a known typosquatting group, or expand all domains across all groups the queried domain belongs to. Use mode="probe" for a fast triage check (returns inGroup boolean + groupId). Use mode="group" for the heavy follow-up that returns every domai...
domainstringmodestringprobe · groupdefault: probewhoisGet WHOIS data for a domain, returning registrar name, creation/expiry/updated dates, nameservers, domain status codes, and registrant/admin/tech contact info (when not redacted). Supports both WHOIS and RDAP protocols.12 params
Get WHOIS data for a domain, returning registrar name, creation/expiry/updated dates, nameservers, domain status codes, and registrant/admin/tech contact info (when not redacted). Supports both WHOIS and RDAP protocols.
domainstringfetch_whois_from_registry_onlybooleanforce_refreshbooleanget_host_ip_whois_on_no_domain_databooleanget_registrar_proxy_databooleaninclude_domain_availabilitybooleaninclude_ip_for_domain_queriedbooleanparse_registrar_raw_textbooleanparse_registry_raw_textbooleanprefer_refresh_even_if_incompletebooleanquery_typestringauto · whois · rdapdefault: autoremove_raw_textbooleanwhois_historyGet the full timeline of WHOIS changes for a domain, showing ownership transfers, registrar changes, nameserver updates, and contact modifications over time. Supports pagination for domains with many historical records.12 params
Get the full timeline of WHOIS changes for a domain, showing ownership transfers, registrar changes, nameserver updates, and contact modifications over time. Supports pagination for domains with many historical records.
created_date_fromstringcreated_date_tostringdomain_namestringexpired_date_fromstringexpired_date_tostringlimitnumbernext_page_tokenstringpreview_modebooleansince_datestringskip_live_whois_recordsbooleanupdated_date_fromstringupdated_date_tostringSponsors
Configuration
WHOISXMLAPI_TOKEN*secretWhoisXML API key (get one at https://whoisxmlapi.com)
Readme
WhoisXML API
WhoisXML API MCP Server
The official WhoisXML API MCP server: 35 first-party tools for WHOIS, DNS, IP geolocation, threat intelligence, typosquatting, email verification, and bulk lookups — in Claude, Cursor, VS Code, LobeChat, or any MCP client.
- Documentation: https://mcp.whoisxmlapi.com
- Install guide for AI agents: https://mcp.whoisxmlapi.com/llms-install.md
- npm package:
@whoisxmlapidotcom/mcp-whoisxmlapi - Docker image:
whoisxmlapidotcom/mcp-whoisxmlapi - MCP Registry:
io.github.whois-api-llc/mcp-whoisxmlapi
This repository is the public listing home for the server. Distribution is via the hosted endpoint, npm, Docker Hub, and the Claude Desktop installer on the Downloads page; the implementation source is maintained privately by Whois API, Inc.
Hosted endpoint (no install)
Details
- Repository
- github.com/whoisxmlapi/mcp-whoisxmlapi
- Website
- mcp.whoisxmlapi.com
- Category
- Communication & Messaging
- Package
@whoisxmlapidotcom/mcp-whoisxmlapi- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active