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

This MCP server supports all five Regional Internet Registries (RIRs) with varying tool availability:

Tool	RIPE NCC	ARIN	APNIC	AfriNIC	LACNIC
WHOIS Query	✅	✅	✅	✅	✅
AS-SET Expansion	✅	✅	➖	➖	➖
Route Validation	✅	✅	➖	➖	➖
Contact Card	✅	✅	✅	✅	✅

Legend:

✅ Fully supported via REST/RDAP APIs
➖ Not available (no public API; use {rir}_whois_query and parse output instead)

RIR Coverage:

RIPE NCC : Europe, Middle East, Central Asia
ARIN : North America
APNIC : Asia-Pacific
AfriNIC : Africa
LACNIC : Latin America & Caribbean

Usage

This MCP server supports two transport modes:

Stdio mode (recommended for Claude Desktop and Claude Code CLI)
HTTP server mode (for web-based clients and remote access)

With Claude Desktop

Add to your Claude Desktop configuration file:

Location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

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

With Claude Code CLI

Add the MCP server using the CLI:

claude mcp add --transport stdio whois-mcp -- uvx --from git+https://github.com/dadepo/whois-mcp.git whois-mcp # Verify it was added claude mcp list # Start Claude Code claude

HTTP Server Mode

For web-based MCP clients or remote access:

Start the server:

uvx --from git+https://github.com/dadepo/whois-mcp.git whois-mcp-server # With custom host/port HTTP_HOST=0.0.0.0 HTTP_PORT=9000 uvx --from git+https://github.com/dadepo/whois-mcp.git whois-mcp-server

The server will be available at http://127.0.0.1:8000/mcp by default.

Add to Claude Code (HTTP):

claude mcp add --transport http whois-mcp-http http://127.0.0.1:8000/mcp

Add to Claude Desktop (HTTP):

{ "mcpServers": { "whois-mcp-http": { "url": "http://127.0.0.1:8000/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-HETZNER?" → Uses expand_as_set to list member ASNs

Validate Route Objects

"Is there a route object for 185.1.1.0/24 originated by AS61417?" → 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):

# Enable/disable RIR support (all default to true) SUPPORT_RIPE=true # RIPE NCC (Europe/Middle East/Central Asia) SUPPORT_ARIN=true # ARIN (North America) SUPPORT_APNIC=true # APNIC (Asia-Pacific) SUPPORT_AFRINIC=true # AfriNIC (Africa) SUPPORT_LACNIC=true # LACNIC (Latin America & Caribbean) # General Configuration HTTP_TIMEOUT_SECONDS=10 WHOIS_CONNECT_TIMEOUT_SECONDS=5 WHOIS_READ_TIMEOUT_SECONDS=5 CACHE_TTL_SECONDS=60 CACHE_MAX_ITEMS=512 # Custom User-Agent string USER_AGENT="whois-mcp/1.0" # HTTP Server Configuration (only used by whois-mcp-server command) HTTP_HOST=127.0.0.1 HTTP_PORT=8000

RIR Support Control

Each RIR can be individually enabled or disabled using environment variables. All RIR endpoints are hardcoded for reliability:

RIPE NCC: whois.ripe.net, https://rest.db.ripe.net
ARIN: whois.arin.net, https://whois.arin.net/rest
APNIC: whois.apnic.net, https://rdap.apnic.net
AfriNIC: whois.afrinic.net, https://rdap.afrinic.net/rdap
LACNIC: whois.lacnic.net, https://rdap.lacnic.net/rdap

Set any SUPPORT_{RIR}=false to disable specific RIRs. Tools are prefixed with the RIR name (e.g., ripe_whois_query, arin_whois_query, apnic_contact_card).

Development

Local Setup

# Clone the repository git clone https://github.com/dadepo/whois-mcp.git cd whois-mcp # Install dependencies uv sync # Run in stdio mode uv run whois-mcp # Run HTTP server mode uv run whois-mcp-server # Run tests uv run pytest

License

This project is licensed under the MIT License - see the LICENSE file for details.

WHOIS MCP Server