Whois

by KincaidYang

62 stars
284 downloads
Not rated
GitHub Website

About

Self-hosted WHOIS/RDAP API and MCP server for domains, IPv4/IPv6, CIDRs and ASNs.

Details

Author
KincaidYang
GitHub stars
62
Downloads
284
Categories
Developer Tools

- https://whois.ddnsip.cn
- https://whois.mmoke.com By immoke
- Redis配置:建议使用Redis以获得更好的性能和多实例缓存共享能力
- 缓存过期时间:根据查询频率调整,建议3600秒
- 内存缓存:Redis 不可用时的兜底,达到上限后按 LRU(最近最少使用)淘汰

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Whois
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The README includes setup instructions such as docker run -d --name redis -p 6379:6379 redis:latest.

whois_batch_lookup

Query WHOIS/RDAP information for multiple domain names, IP addresses/CIDR prefixes, or ASNs in one call. Results are returned per query with individual statuses. Disabled unless the operator enables batch queries.

whois_lookup

Query WHOIS/RDAP information for a domain name, IP address or CIDR prefix (v4 or v6), or ASN

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "whois": {
        "type": "streamable-http",
        "url": "https://whois.ddnsip.cn/mcp"
    }
}

whois is a self-hosted WHOIS/RDAP API and MCP server written in Go. It answers lookups for domains, IPv4/IPv6 addresses, CIDR prefixes and ASNs through one endpoint, normalizing registry data to RDAP-style (RFC 9083) JSON. The MCP endpoint (Streamable HTTP) exposes whois_lookup and whois_batch_lookup tools for AI assistants, with a public demo at whois.ddnsip.cn/mcp. Deployment is a single binary or Docker container with no external dependencies — in-memory cache by default, optional Redis, plus API key auth, rate limiting, OpenAPI 3.1 and Prometheus metrics.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.