# WhoisXML MCP MCP

> WhoisXML lets you run deep network intelligence checks directly from your agent. Validate domain ownership, check if an IP address belongs to a specific city or company, confirm email addresses are real, and see immediately if a domain name is available for registration.

## Overview
- **Category:** fort-knox
- **Price:** Free
- **Tags:** domain-intelligence, whois, ip-geolocation, email-verification, threat-intelligence, network-recon

## Description

Need to vet suspicious domains or clean up a lead list? This MCP connects advanced network intelligence—everything from WHOIS records to IP location data—right into your workflow. Instead of jumping between multiple external databases, you ask your agent one question and get a fully validated answer.

For example, if a client gives you an email address, the system first checks its syntax and MX records to confirm it can actually receive mail. If they give you an IP address, it immediately maps that IP back to a geographic location and ISP owner. This capability is critical for security research or due diligence. When you chain this MCP with other tools in the Vinkius catalog, your agent doesn't just run checks; it builds a full audit trail of every piece of data used and how the budget was spent. The result is actionable intelligence, not just raw data.

It handles everything necessary to validate digital assets—from checking if a domain name is free for registration to pulling historical ownership records.

## Tools

### check_domain_availability
Checks whether a specific domain name is available to be registered right now.

### get_ip_geolocation
Pulls the geographical location, ISP, and coordinates for any given IP address.

### get_whois_record
Gets detailed ownership information, including raw or parsed registration data for a domain name.

### verify_email
Checks if an email address is syntactically valid and whether the associated domain has active mail exchange records.

## Prompt Examples

**Prompt:** 
```
Get the WHOIS record for google.com.
```

**Response:** 
```
I've retrieved the WHOIS data for google.com. It was registered via MarkMonitor Inc. on 1997-09-15 and is set to expire on 2028-09-14.
```

**Prompt:** 
```
Where is the IP address 8.8.8.8 located?
```

**Response:** 
```
The IP address 8.8.8.8 is located in Mountain View, California, United States. It is operated by Google LLC.
```

**Prompt:** 
```
Verify if the email test@example.com is valid.
```

**Response:** 
```
I checked test@example.com. The syntax is valid, but the domain does not have active MX records, suggesting it cannot receive emails.
```

## Capabilities

### Validate Domain Ownership
Retrieve both parsed and raw WHOIS data, showing who registered the domain and when.

### Map IP Location Data
Instantly identify the country, city, ISP, and coordinates associated with any given IP address.

### Confirm Email Deliverability
Check an email address's syntax and MX records to confirm it is valid and capable of receiving messages.

### Check Domain Status
Run a quick check to see if a specific domain name can be registered right now.

## Use Cases

### Incident Response: Profiling Malicious IPs
A security analyst gets an IP address from a threat feed. Instead of manually running multiple lookups, they ask their agent to run get_ip_geolocation. The agent immediately reports the country and ISP, giving the initial context needed for triage.

### Marketing Lead Scrubbing
A sales rep imports a list of 500 leads. They ask their agent to run verify_email on the entire batch. The agent filters out all addresses that are syntactically invalid or lack MX records, saving hours of manual cleanup.

### Project Planning: Domain Conflict
A developer is setting up a new service and needs to ensure the name doesn't conflict. They ask their agent to run check_domain_availability for three potential names, getting instant confirmation on which ones are open.

### Due Diligence: Tracking Corporate Change
A researcher suspects a company is rebranding or shifting servers. They use get_whois_record to pull the historical ownership data for their main domain, tracking changes in registrar and creation dates.

## Benefits

- Instantly map IP addresses to their physical location using get_ip_geolocation. You don't just know the number; you know the city and country it belongs to.
- Stop wasting time on bad leads. Use verify_email to confirm if a contact email is actually valid, checking for active MX records before sending any message.
- Before building anything, use check_domain_availability to see if your target domain name is open for immediate registration.
- Gather historical context with get_whois_record. You can pull raw and parsed ownership data to understand the full history of a website.
- When combining this MCP with messaging tools in Vinkius, you build automated workflows that validate every piece of contact information before action is taken.

## How It Works

The bottom line is that your AI agent uses this connector to run multiple, specialized data lookups without you ever leaving your chat window.

1. Subscribe to the WhoisXML MCP and provide your unique API key.
2. Connect this MCP to your preferred agent (Claude, Cursor, etc.).
3. Tell your agent what you need to know—for example, 'What is the location of 203.0.113.45?' or 'Is test@company.com a valid email?'. The agent runs the necessary checks and provides the answer.

## Frequently Asked Questions

**How does the WhoisXML MCP confirm if an email address is real?**
The verify_email tool checks more than just spelling. It validates the syntax and, critically, checks MX records to ensure the domain can actually receive mail.

**What kind of data does get_whois_record provide?**
It provides comprehensive ownership details for a domain, including both parsed information (like creation dates) and raw registration data from the registrar.

**Can I use WhoisXML to check multiple domains at once?**
Yes. You can ask your agent to run checks on an entire list of domains, using the tool that handles domain availability and ownership lookups efficiently.

**Does get_ip_geolocation provide just country data?**
No, it gives much more detail. You'll get the city, ISP, coordinates, and full location context for any IP address you input.

**How does the WhoisXML MCP keep my network data private when I run `get_whois_record`?**
Your credentials never sit on a disk; they pass through a zero-trust proxy. The entire operation executes inside Vinkius's secure sandbox, ensuring your keys are only used in transit for the call.

**Are there rate limits when I use `check_domain_availability`?**
The platform handles request throttling to maintain stability. You’ll hit a usage ceiling long before we do; you can always check your billing dashboard for current quotas.

**Which AI clients can I use to run the `get_ip_geolocation` tool?**
You connect once from any MCP-compatible client, including Claude, Cursor, or Windsurf. That single connection gives your agent access to every tool in our full catalog.

**When I use `get_whois_record`, do I get raw text or clean data?**
You get both parsed and raw data streams. This lets you pull easy-to-read dates and structured fields while retaining the complete, unedited WHOIS record for maximum context.

**Can I check if a domain is available for registration?**
Yes! Use the `check_domain_availability` tool. It provides a lightweight check to see if a specific domain name is currently available.

**How do I find the physical location of an IP address?**
Simply use the `get_ip_geolocation` tool with the target IP. The agent will return the country, city, latitude, longitude, and ISP information.

**Can this tool detect disposable or fake email addresses?**
Yes. The `verify_email` tool checks email syntax, MX records, and SMTP connections, and specifically flags disposable email providers.