Whois MCP

by dadepo

289 downloads
Not rated
GitHub

About

A Model Context Protocol (MCP) server that provides LLMs with network information lookup tools through WHOIS and RIPE Database queries.

Details

Author
dadepo
Downloads
289
Categories
Other

- Query WHOIS servers for domains, IPs, and ASNs
- Recursively expand AS-SETs into concrete ASN lists
- Check IRR route/route6 object existence
- Fetch abuse, admin, and technical contacts

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 MCP
    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

Install using uvx and configure in your MCP client (e.g., Claude Desktop) with the command and args shown in the README. Optional environment variables include RIPE_REST, HTTP_TIMEOUT_SECONDS, and USER_AGENT.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "whois mcp": {
            "whois-mcp": {
                "command": "/path/to/bin/uvx",
                "args": [
                    "--from",
                    "git+https://github.com/dadepo/whois-mcp.git",
                    "whois-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "whois-mcp": {
        "command": "/path/to/bin/uvx",
        "args": [
            "--from",
            "git+https://github.com/dadepo/whois-mcp.git",
            "whois-mcp"
        ]
    }
}

whois-mcp

A Model Context Protocol (MCP) server that provides LLMs with network information lookup tools through WHOIS and RIPE Database queries.

Features

Available Tools

- whois_query - Query WHOIS servers for domains, IPs, and ASNs - expand_as_set - Recursively expand AS-SETs into concrete ASN lists - validate_route_object - Check IRR route/route6 object existence - contact_card - Fetch abuse, admin, and technical contacts

Regional Internet Registry (RIR) Support

Currently, this MCP server is primarily optimized for RIPE NCC (Europe/Middle East/Central Asia) resources and databases. Support for other Regional Internet Registries is planned.

Usage

With Claude Desktop (or any other MCP Client)

Add to your Claude Desktop configuration:

{
"mcpServers": {
"whois-mcp": {
"command": "/path/to/bin/uvx",
"args": ["--from", "git+https://github.com/dadepo/whois-mcp.git", "whois-mcp"]
}
}
}

Tool Usage Examples

Query Network Information

"What organization owns 8.8.8.8?"
→ Uses whois_query to retrieve registration details

Expand AS-SETs

"What ASNs are in AS-HURRICANE?"
→ Uses expand_as_set to list member ASNs

Validate Route Objects

"Is there a route object for 192.0.2.0/24 originated by AS64496?"
→ Uses validate_route_object to check IRR databases

Get Contact Information

"Who should I contact about abuse from AS15169?"
→ Uses contact_card to retrieve contact details

Configuration

Environment variables (optional):
```bash

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.