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, Windsurf, VS Code, Continue, Zed, and any other MCP-compatible AI client.

Two ways to run it — pick what fits your setup:

| | Method | Requires | Best for | |--|--------|----------|----------| | ⭐ Recommended | Docker (pre-built image) | Docker only | Everyone — no Java or Maven needed | | | Build from source | Java 17 + Maven | Contributors / custom builds |

Once running, connect it to any MCP client via stdio (local) or HTTP/SSE on port 3100 (remote VM).

Table of Contents

1. Tools Reference (14 tools)
2. Quick Start
   • ⭐ Recommended — Docker
   • Build from Source
3. Prerequisites
4. Platform Integration
   • 1. Claude Desktop
   • 2. Cursor IDE
   • 3. Windsurf IDE
   • 4. VS Code + GitHub Copilot
   • 5. Continue.dev
   • 6. Zed Editor
5. Example Prompts
6. Troubleshooting

Tools Reference

WHOIS Tools

| Tool | Description | |------|-------------| | 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 |

IP & ASN WHOIS Tools

| Tool | Description | |------|-------------| | ipWhoisLookup | WHOIS registration data for any IPv4 or IPv6 address | | asnWhoisLookup | WHOIS data for an Autonomous System Number (e.g. AS15169) |

DNS Tools

| Tool | Description | |------|-------------| | 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 |

IP Intelligence Tools

| Tool | Description | |------|-------------| | ipGeolocation | Country, city, region, ISP, and coordinates for any IP address | | ipSecurity | VPN, proxy, Tor exit node, bot, and threat intelligence for any IP |

Domain Tools

| Tool | Description | |------|-------------| | 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 | | domainDiscovery | Find domains by keyword, including typosquatting and similar variants |

SSL Tools

| Tool | Description | |------|-------------| | sslLookup | SSL/TLS certificate details — issuer, expiry, SANs, chain, and raw output |

Quick Start

⭐ Recommended — Docker

No Java or Maven required. Pull the pre-built image directly from Docker Hub and run.

Get your free API key first: whoisfreaks.com/signup

Option 1 — Direct docker run (simplest)

docker run -d \
  --name whoisfreaks-mcp \
  --restart unless-stopped \
  -p 3100:3100 \
  -e WHOISFREAKS_API_KEY=your-api-key-here \
  whoisfreaks/mcp-server:latest

The MCP gateway is now live at http://localhost:3100/sse.

Option 2 — Docker Compose (recommended for production / VM)

Create a docker-compose.yml:

services:
  whoisfreaks-mcp:
    image: whoisfreaks/mcp-server:latest
    container_name: whoisfreaks-mcp
    restart: unless-stopped
    ports:
      - "3100:3100"
    environment:
      WHOISFREAKS_API_KEY: your-api-key-here

Start it:

docker compose up -d

Or use a .env file instead of hardcoding the key (recommended):

# Create .env file (never commit this to git)
echo "WHOISFREAKS_API_KEY=your-api-key-here" > 

... [View full README on GitHub](https://github.com/WhoisFreaks/whoisfreaks-mcp-server#readme)