Whoisfreaks MCP Server

A **Model Context Protocol (MCP)** server that exposes the full **WhoisFreaks API** suite as AI-callable tools. Works with Claude Desktop, Cursor

Local serverstdio

What is the Whoisfreaks MCP server?

If you already use Whoisfreaks, the whoisfreaks mcp server is the piece that lets your assistant work with it directly. A Model Context Protocol (MCP) server that exposes the full WhoisFreaks API suite as AI-callable tools. Works with Claude Desktop, Cursor, Windsurf, VS Code, Continue, Zed, and any other MCP-compatible AI client.

Installation

The server ships on npm as @modelcontextprotocol/inspector, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • liveWhoisLookup — Real-time WHOIS data for any domain — registrar, registrant, dates, nameservers
  • whoisHistory — Complete ownership history timeline for a domain
  • reverseWhoisLookup — Find all domains registered by an email address, keyword, owner name, or company
  • ipWhoisLookup — WHOIS registration data for any IPv4 or IPv6 address
  • asnWhoisLookup — WHOIS data for an Autonomous System Number (e.g. AS15169)
  • dnsLookup — Live DNS records — A, AAAA, MX, NS, CNAME, SOA, TXT, SPF, or all
  • dnsHistory — Historical DNS records with full change timeline
  • reverseDnsLookup — Find all domains pointing to a given IP or nameserver
  • ipGeolocation — Country, city, region, ISP, and coordinates for any IP address
  • ipSecurity — VPN, proxy, Tor exit node, bot, and threat intelligence for any IP
  • domainAvailability — Check if a domain is available to register, with optional suggestions
  • subdomainLookup — Enumerate all known subdomains for a domain, with status and date filters

Credentials and setup notes

Configuration is passed through the environment: WHOISFREAKS_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

| Requirement | Notes | |-------------|-------| | Docker | Required for the recommended Docker path | | Java 17 + Maven 3.8 | Required only if building from source | | WhoisFreaks API Key | Free at whoisfreaks.com/signup | ---

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Whoisfreaks.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

This sits in the team communication group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Whoisfreaks's toolset — liveWhoisLookup, whoisHistory, reverseWhoisLookup and 11 more — is a fair guide to whether it matches your workflow. It is maintained by whoisfreaks; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Whoisfreaks's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
liveWhoisLookupReal-time WHOIS data for any domain — registrar, registrant, dates, nameservers
whoisHistoryComplete ownership history timeline for a domain
reverseWhoisLookupFind all domains registered by an email address, keyword, owner name, or company
ipWhoisLookupWHOIS registration data for any IPv4 or IPv6 address
asnWhoisLookupWHOIS data for an Autonomous System Number (e.g. AS15169)
dnsLookupLive DNS records — A, AAAA, MX, NS, CNAME, SOA, TXT, SPF, or all
dnsHistoryHistorical DNS records with full change timeline
reverseDnsLookupFind all domains pointing to a given IP or nameserver
ipGeolocationCountry, city, region, ISP, and coordinates for any IP address
ipSecurityVPN, proxy, Tor exit node, bot, and threat intelligence for any IP
domainAvailabilityCheck if a domain is available to register, with optional suggestions
subdomainLookupEnumerate all known subdomains for a domain, with status and date filters
domainDiscoveryFind domains by keyword, including typosquatting and similar variants
sslLookupSSL/TLS certificate details — issuer, expiry, SANs, chain, and raw output

How to install the Whoisfreaks MCP server

{
  "mcpServers": {
    "whoisfreaks": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "WHOISFREAKS_API_KEY=your-api-key-here",
        "--entrypoint", "java",
        "whoisfreaks/mcp-server:latest",
        "-jar", "app.jar"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

| Requirement | Notes | |-------------|-------| | Docker | Required for the recommended Docker path | | Java 17 + Maven 3.8 | Required only if building from source | | WhoisFreaks API Key | Free at whoisfreaks.com/signup | ---

VariableDescriptionRequired
WHOISFREAKS_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Whoisfreaks to liveWhoisLookup.
  • Use Whoisfreaks to whoisHistory.
  • Use Whoisfreaks to reverseWhoisLookup.

Frequently asked questions

It connects Whoisfreaks to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (liveWhoisLookup, whoisHistory, reverseWhoisLookup, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Whoisfreaks directly.