Skip to content

simplebytes-com/domaindetails-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.)

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.

Related Packages

  • 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:

Related Projects

About

Complete domain research toolkit with RDAP, WHOIS, and DNS lookup capabilities for Model Context Protocol

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published