Skip to main content
Glama
DomainDetails MCP Server

DomainDetails MCP Server

DomainDetails MCP Server

A Model Context Protocol (MCP) server that provides comprehensive domain research tools including RDAP, WHOIS, and DNS lookup capabilities.

Features

  • RDAP First: Uses modern RDAP protocol for structured domain data

  • WHOIS Fallback: Automatically falls back to WHOIS when RDAP fails

  • Registry Detection: Automatically detects the correct RDAP/WHOIS server for any TLD

  • Comprehensive Coverage: Supports 50+ TLDs including gTLDs and ccTLDs

  • Easy Integration: Works with any MCP-compatible client (Claude Desktop, IDEs, etc.)

Related MCP server: dns-intel

Installation

npm install domaindetails-mcp

Or use directly with npx:

npx domaindetails-mcp

Usage

Claude Desktop

Add to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "domaindetails": {
      "command": "npx",
      "args": ["-y", "domaindetails-mcp"]
    }
  }
}

Claude Code

Add to your Claude Code MCP settings:

claude mcp add domaindetails -- npx -y domaindetails-mcp

Or manually add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "domaindetails": {
      "command": "npx",
      "args": ["-y", "domaindetails-mcp"]
    }
  }
}

Cursor

Add to your Cursor MCP configuration at ~/.cursor/mcp.json:

{
  "mcpServers": {
    "domaindetails": {
      "command": "npx",
      "args": ["-y", "domaindetails-mcp"]
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration at ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "domaindetails": {
      "command": "npx",
      "args": ["-y", "domaindetails-mcp"]
    }
  }
}

Other MCP Clients

For any MCP-compatible client, use:

  • Command: npx

  • Args: ["-y", "domaindetails-mcp"]

Or if installed globally:

  • Command: domaindetails-mcp

Available Tools

domain_lookup

Look up comprehensive domain information using RDAP protocol with WHOIS fallback.

Parameters:

  • domain (string, required): The domain name to look up (e.g., example.com)

  • prefer_whois (boolean, optional): If true, use WHOIS instead of RDAP as primary method

  • include_raw (boolean, optional): If true, include raw protocol response data

Example Response:

{
  "domain": "example.com",
  "found": true,
  "method": "rdap",
  "timestamp": "2025-01-21T10:30:00Z",
  "status": ["client transfer prohibited"],
  "nameservers": ["ns1.example.com", "ns2.example.com"],
  "rdap": {
    "registration_date": "1995-08-14T04:00:00Z",
    "expiration_date": "2025-08-13T04:00:00Z",
    "contacts": [...],
    "dnssec": {...}
  }
}

Supported TLDs

The server includes built-in registry detection for 50+ TLDs:

Generic TLDs: com, net, org, info, biz, name, pro, xyz, top, site, online, tech, store, app, dev, io, ai, co, me, tv, cc

Country Code TLDs: uk, ca, au, de, fr, nl, be, ch, at, it, es, se, no, dk, fi, ie, pl, cz, sk, hu, ro, bg, hr, si, lv, lt, ee

For unsupported TLDs, the server will attempt to fetch registry information from IANA's bootstrap service.

  • domaindetails - CLI tool and library for domain lookups (includes this MCP server)

Development

# Clone repository
git clone https://github.com/simplebytes-com/domaindetails-mcp.git
cd domaindetails-mcp

# Install dependencies
npm install

# Build
npm run build

# Test locally
node build/index.js

License

MIT

Support

For issues and questions:

Available Tools

1 tool
domain_lookupA

Look up domain information using RDAP protocol with WHOIS fallback. Provides comprehensive domain registration details, nameservers, contacts, and status information.

Inputs: domain (required), include_raw, prefer_whois.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion. The tool's purpose is clearly stated and unique.

    Naming Consistency5/5

    The tool name 'domain_lookup' follows a clear, readable pattern and is appropriate for its function. With a single tool, there is no inconsistency.

    Tool Count4/5

    The server is focused on domain details lookup, and a single tool adequately covers this narrow scope. While the typical range is 3-15, the simplicity of the purpose justifies the minimal count, making it slightly under but reasonable.

    Completeness5/5

    The tool provides comprehensive domain information via RDAP with WHOIS fallback, covering registration, nameservers, contacts, and status. There are no obvious missing operations for a lookup-only service.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers