Whoisfreaks

AModel Context Protocol (MCP)server that exposes the fullWhoisFreaks APIsuite 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:

Once running, connect it to any MCP client viastdio(local) orHTTP/SSE on port 3100(remote VM).
- Tools Reference (14 tools)
- Quick Start

- ⭐ Recommended — Docker
- Build from Source

- 1. Claude Desktop
- 2. Cursor IDE
- 3. Windsurf IDE
- 4. VS Code + GitHub Copilot
- 5. Continue.dev
- 6. Zed Editor

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

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

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

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

# Container should show as "Up" docker ps # SSE endpoint should respond curl http://localhost:3100/health # → {"status":"ok"} # List all 14 registered tools curl http://localhost:3100/tools/list

{ "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" ] } } }

No port mapping needed here — Claude Desktop talks to the container directly via stdio.

Only needed if you want to modify the code or build a custom version.

git clone https://github.com/whoisfreaks/whoisfreaks-mcp-server.git cd whoisfreaks-mcp-server mvn clean package -q

This produces a single self-contained fat JAR:

Tip:Note theabsolute pathto this JAR — you will need it in the platform configs below. Example:/Users/yourname/whoisfreaks-mcp-server/target/whoisfreaks-mcp-server-1.0.0.jar

The most popular MCP client. Claude Desktop launches the MCP server as a subprocess on startup and communicates viastdio— it does not support SSE/HTTP URLs.

⭐ Option A — Docker (recommended, no Java needed)

{ "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" ] } } }

Docker must be running before you open Claude Desktop. The image is pulled automatically on first use.

Option B — JAR directly (requires Java 17)

{ "mcpServers": { "whoisfreaks": { "command": "java", "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"], "env": { "WHOISFREAKS_API_KEY": "your-api-key-here" } } } }

- Paste the config above into the config file (create it if it doesn't exist)
- Save the file
- Quit Claude Desktop completely (Cmd+Qon macOS / taskbar exit on Windows)
- Reopen Claude Desktop
- Click thehammer icon(Tools) in the chat input — you should see 14 WhoisFreaks tools listed

Verify it works:TypeWho owns google.com?and Claude will automatically callliveWhoisLookup.

Cursor supports both stdio and SSE transports. Config file:~/.cursor/mcp.json

⭐ Option A — Docker via SSE (recommended)

{ "mcpServers": { "whoisfreaks": { "url": "http://localhost:3100/sse", "transport": "sse" } } }

Start the Docker container first:docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

Option B — Docker via stdio (no port needed)

{ "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" ] } } }

Option C — JAR directly (requires Java 17)

{ "mcpServers": { "whoisfreaks": { "command": "java", "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"], "env": { "WHOISFREAKS_API_KEY": "your-api-key-here" } } } }

- Save~/.cursor/mcp.jsonwith your chosen option
- Restart Cursor
- Open theAI Panel(Cmd+L) → you should see a tools indicator showing WhoisFreaks tools
- Ask:Check the SSL certificate for github.com

Windsurf (by Codeium) supports MCP via its Cascade AI sidebar.

⭐ Option A — Docker via stdio (recommended)

{ "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" ] } } }

Option B — JAR directly (requires Java 17)

{ "mcpServers": { "whoisfreaks": { "command": "java", "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"], "env": { "WHOISFREAKS_API_KEY": "your-api-key-here" } } } }

- Save the config with your chosen option
- Restart Windsurf
- Open Cascade sidebar → look for the MCP tools indicator (plug icon)
- Ask:Find all subdomains of tesla.com

Note:Windsurf requires Cascade to be inWritemode for tool use. Toggle it from the Cascade header if tools are not being called.

VS Code supports MCP tools through the GitHub Copilot extension (Chat Participants / Tools feature).

Config file(.vscode/mcp.jsonin your workspace, or~/.vscode/mcp.jsonglobally):

⭐ Option A — Docker via SSE (recommended, container must be running)

{ "servers": { "whoisfreaks": { "type": "sse", "url": "http://localhost:3100/sse" } } }

Start the container first:docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

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

Option C — JAR directly (requires Java 17)

{ "servers": { "whoisfreaks": { "type": "stdio", "command": "java", "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"], "env": { "WHOISFREAKS_API_KEY": "your-api-key-here" } } } }

- Make sure you have theGitHub Copilot Chatextension installed (v1.99+)
- Save the config file above with your chosen option
- Open Copilot Chat (Ctrl+Shift+I/Cmd+Shift+I)
- Switch the model toAgent modeusing the dropdown
- Click theToolsbutton — WhoisFreaks tools should appear in the list
- Ask:What are the MX records for github.com?

Requirement:VS Code 1.99+ and GitHub Copilot Chat extension are required for MCP tool support.

Continue is an open-source AI coding assistant with MCP support for VS Code and JetBrains IDEs.

Config file(~/.continue/config.json):

⭐ Option A — Docker via SSE (recommended, container must be running)

{ "mcpServers": [ { "name": "whoisfreaks", "url": "http://localhost:3100/sse", "transport": "sse" } ] }

Start the container first:docker run -d -p 3100:3100 -e WHOISFREAKS_API_KEY=your-key whoisfreaks/mcp-server:latest

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

Option C — JAR directly (requires Java 17)

{ "mcpServers": [ { "name": "whoisfreaks", "command": "java", "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"], "env": { "WHOISFREAKS_API_KEY": "your-api-key-here" } } ] }

- Install theContinueextension from the VS Code Marketplace or JetBrains Plugin Marketplace
- Edit~/.continue/config.jsonwith your chosen option
- Reload the window (Cmd+Shift+P→Reload Window)
- Open Continue sidebar — tools from WhoisFreaks will be available in chat
- Ask:Look up IP geolocation for 1.1.1.1

Zed has a built-in AI assistant with MCP support via itsassistantconfiguration.

Config file(~/.config/zed/settings.json):

⭐ Option A — Docker via stdio (recommended)

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

Option B — JAR directly (requires Java 17)

{ "assistant": { "mcp_servers": { "whoisfreaks": { "command": "java", "args": ["-jar", "/absolute/path/to/whoisfreaks-mcp-server-1.0.0.jar"], "env": { "WHOISFREAKS_API_KEY": "your-api-key-here" } } } } }

- Open Zed →Zedmenu →Settings(orCmd+,)
- Add themcp_serversblock to your existing settings JSON using your chosen option
- Save and restart Zed
- Open the AI panel (Cmd+?) → tools will be listed under the tools indicator
- Ask:Is the domain myapp.io available?

Once configured in any client above, try these prompts:

# WHOIS Who owns the domain apple.com? Give me full WHOIS details. Show me the complete ownership history for whoisfreaks.com. Find all domains registered by admin@google.com. # IP & ASN WHOIS What organization owns the IP address 8.8.8.8? Look up ASN information for AS15169. # DNS What are the MX and NS records for github.com? Has facebook.com changed its IP addresses in the last 2 years? (DNS history) Which domains are pointing to the IP 104.21.0.0? (reverse DNS) # IP Intelligence Where is 1.1.1.1 located? What ISP runs it? Is 185.220.101.45 a Tor exit node or a VPN? # Domain Tools Is mycompany.io available to register? Suggest 5 alternatives. List all known subdomains of tesla.com. Find domains similar to 'google' — possible typosquatting targets. # SSL Check the SSL certificate for github.com — who issued it and when does it expire?

- WhoisFreaks API Documentation:https://whoisfreaks.com/documentation
- API Key & Billing:https://whoisfreaks.com/billing
- MCP Protocol Specification:https://modelcontextprotocol.io
- MCP Inspector (test tool):npx @modelcontextprotocol/inspector
- Issues & Support:Open an issue on GitHub

MCP server for 402 Index: discover 15,000+ paid API endpoints across L402, x402, and MPP