# Whoisfreaks — how to use (mcp.ai)

Connect your Whoisfreaks account and use 17 tools for developer tools straight from your AI agent. Connect with your own API key. Best Source For Domain WHOIS Database and API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_whoisfreaks?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `whoisfreaks_asn_whois_lookup`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/whoisfreaks`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/whoisfreaks/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/whoisfreaks/asn/whois/lookup` — Tool to retrieve comprehensive ASN WHOIS information including ownership, network infrastructure, and IP address ranges. Use when you need to identify ASN ownership, organization details, or associate
  - body: { asn: string, format?: string }
- `POST https://api.mcp.ai/api/whoisfreaks/bulk/dns/lookup` — Tool to process multiple domains or IPs simultaneously, returning all DNS records in a single request (max 100). Use when you need to retrieve DNS records for multiple domains at once for efficient ba
  - body: { type: string, format?: string, domainNames?: string[], ipAddresses?: string[] }
- `POST https://api.mcp.ai/api/whoisfreaks/bulk/domain/availability/check` — Tool to check availability of multiple domains in one request (max 100 domains). Use when you need to verify if domain names are available for registration. Response time ranges from 16 seconds to 1 m
  - body: { format?: string, domainNames: string[] }
- `POST https://api.mcp.ai/api/whoisfreaks/bulk/whois/lookup` — Tool to query WHOIS information for up to 100 domains in a single request. Use when you need comprehensive registration details, contact information, name servers, and domain status for multiple domai
  - body: { format?: string, domainNames: string[] }
- `POST https://api.mcp.ai/api/whoisfreaks/dns/live/lookup` — Tool to perform real-time DNS record resolution for network diagnostics and configuration verification. Use when you need to retrieve current DNS records for a domain or perform reverse DNS lookup for
  - body: { type: string, format?: string, ipAddress?: string, domainName?: string }
- `POST https://api.mcp.ai/api/whoisfreaks/domain/availability/check` — Tool to check if a domain is available for registration with optional suggestions. Use when you need to verify domain availability or get alternative domain suggestions.
  - body: { sug?: boolean, count?: integer, domain: string, format?: string }
- `POST https://api.mcp.ai/api/whoisfreaks/get/domainer/files/status` — Tool to check availability and update status of domain data files including newly registered, expired, and dropped domains. Use when you need to verify that domain data files are prepared and ready fo
- `POST https://api.mcp.ai/api/whoisfreaks/ip/geolocation/lookup` — Tool to retrieve geographic location information for an IP address including country, city, coordinates, ISP, and security details. Use when you need to identify the physical location of an IP, detect
  - body: { ip: string }
- `POST https://api.mcp.ai/api/whoisfreaks/ip/whois/lookup` — Tool to retrieve comprehensive WHOIS information for an IP address including organization, ISP, and network details. Use when you need to identify IP ownership, allocation status, or contact informati
  - body: { ip: string, format?: string }
- `POST https://api.mcp.ai/api/whoisfreaks/security/threat/lookup` — Tool to check if an IP address is associated with malicious activity, security threats, or appears on blocklists. Use when you need to assess IP reputation, detect VPN/proxy/Tor usage, identify bots o
  - body: { ip: string }
- `POST https://api.mcp.ai/api/whoisfreaks/ssl/certificate/lookup` — Tool to fetch live SSL certificate with full secure cert chain, validity dates, and issuer information. Use when you need to retrieve SSL certificate details for a domain, including certificate valida
  - body: { chain?: boolean, format?: string, sslRaw?: boolean, domainName: string }
- `POST https://api.mcp.ai/api/whoisfreaks/subdomains/lookup` — Tool to discover all subdomains associated with a domain name. Use when you need to enumerate subdomains for security assessment, asset discovery, or domain reconnaissance. Supports filtering by activ
  - body: { page?: integer, after?: string, before?: string, domain: string, format?: string, status?: string }
- `POST https://api.mcp.ai/api/whoisfreaks/whois/historical/lookup` — Tool to access historical domain records from comprehensive database with up to 100 records per page. Use when you need to retrieve historical WHOIS data for a domain dating back to 1986. Database is 
  - body: { format?: string, domainName: string }
- `POST https://api.mcp.ai/api/whoisfreaks/whois/live/lookup/v2` — Tool to fetch real-time WHOIS domain data using v2.0 endpoint. Use when you need current domain ownership, registration dates, contact information, or nameserver details via the updated v2.0 API. Note
  - body: { format?: string, domainName: string }
- `POST https://api.mcp.ai/api/whoisfreaks/whois/reverse/lookup/by/company` — Tool to search for domains registered by a specific company or organization using reverse WHOIS lookup. Use when you need to find all domains associated with a particular company name. Performs full-t
  - body: { mode?: string, page?: integer, exact?: boolean, format?: string, company: string }
- `POST https://api.mcp.ai/api/whoisfreaks/whois/reverse/lookup/by/email` — Tool to search for domains registered with a specific email address. Use when you need to find all domains associated with an email in WHOIS records. Supports exact or regex email matching. Returns pa
  - body: { mode?: string, page?: integer, email: string, format?: string }
- `POST https://api.mcp.ai/api/whoisfreaks/whois/reverse/lookup/by/owner` — Tool to search for domains registered by a specific owner name using reverse WHOIS lookup. Use when you need to find all domains associated with a particular registrant or owner name. Performs pattern
  - body: { mode?: string, page?: integer, exact?: boolean, owner: string, format?: string }

## Example prompts
- "What can I do in Whoisfreaks?"
- "Show me a summary of my Whoisfreaks account"

## More
- Page: https://mcp.ai/whoisfreaks
- Agent spec (llms.txt): https://mcp.ai/whoisfreaks/llms.txt
- Postman collection: https://mcp.ai/whoisfreaks/postman.json