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 ASNsexpand_as_set- Recursively expand AS-SETs into concrete ASN listsvalidate_route_object- Check IRR route/route6 object existencecontact_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_queryand 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.