# WHOIS

> WHOIS is an open-source MCP server for developer tools. Query WHOIS and RDAP for domains, IPs, CIDR prefixes and ASNs from a self-hosted service. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, API, Linux
- **Repository:** https://github.com/kincaidyang/whois
- **MCP Registry name:** io.github.KincaidYang/whois
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

This Go service answers WHOIS and RDAP lookups for any top-level domain that allows public queries, plus IPv4 and IPv6 addresses, CIDR prefixes and ASNs, and exposes the same lookups to assistants through a streamable HTTP /mcp endpoint. To meet ICANN's temporary specification and GDPR, domain results leave out owner contact details such as address, phone and email.

It is built to be run by you. Caching defaults to memory with an optional Redis backend, upstream concurrency is capped so registries are not hammered, and the RDAP server list refreshes from IANA with a built-in fallback. Operators can require API keys with per-key rate limits, enable a batch endpoint, route RDAP queries through a proxy and turn on DNS-rebinding protection for /mcp. Health, readiness, Prometheus metrics and an OpenAPI 3.1 spec are included.

Deploy with Docker, a release binary or a source build. Public demo instances exist, and the README is mainly written in Chinese.

## Features

- **WHOIS and RDAP:** Looks up domains, IP addresses, CIDR prefixes and ASNs.
- **Privacy-aware output:** Omits owner contact fields to follow ICANN and GDPR rules.
- **Caching options:** Memory cache by default, Redis for multi-instance use.
- **API keys and limits:** Optional keys with per-key rate limits.
- **Batch lookups:** Optional endpoint, off by default, for several queries at once.
- **Operations endpoints:** Health, readiness, Prometheus metrics and OpenAPI.

## Good for

- Check who the registrar of a domain is
- Look up which network owns an IP or ASN
- Add domain lookups to an agent without a third-party API
- Run an internal lookup service behind your own proxy

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http whois https://whois.ddnsip.cn/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://whois.ddnsip.cn/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "whois": {
      "url": "https://whois.ddnsip.cn/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "whois": {
      "type": "http",
      "url": "https://whois.ddnsip.cn/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "whois": {
      "serverUrl": "https://whois.ddnsip.cn/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "whois": {
      "type": "http",
      "url": "https://whois.ddnsip.cn/mcp"
    }
  }
}
```

## FAQ

### Does it return owner contact details?

No. For compliance it returns only partial necessary fields.

### Can I host it myself?

Yes, with Docker, a release binary or by building from source.

### Is Redis required?

No. It uses memory caching by default and can fall back to it if Redis fails.

### Can I protect it?

Yes. Configure API keys, and optionally per-key rate limits.

### Is WHOIS free?

Yes. WHOIS is open source, so you can use and self-host it for free.

### How do I add WHOIS to Claude Code?

Run this command in your terminal: claude mcp add --transport http whois https://whois.ddnsip.cn/mcp

### What are the best alternatives to WHOIS?

The closest alternatives to WHOIS are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/whois
