Skip to content

simplebytes-com/rdap-mcp

Repository files navigation

RDAP MCP Server

A simple Model Context Protocol (MCP) server that provides RDAP (Registration Data Access Protocol) domain lookup capabilities.

Features

  • Pure RDAP: Uses the modern RDAP protocol for structured domain data
  • Registry Detection: Automatically detects the correct RDAP server for any TLD
  • Comprehensive Coverage: Supports 50+ TLDs including gTLDs and ccTLDs
  • Lightweight: Minimal dependencies, RDAP-only (no WHOIS fallback)
  • Easy Integration: Works with any MCP-compatible client

Installation

npm install rdap-mcp

Or use directly with npx:

npx rdap-mcp

Usage

Option 1: Local Installation (Recommended)

Add to your Claude Desktop configuration file:

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Option 2: Hosted Version

This server is also available as a hosted service at mcp.domaindetails.com for HTTP-based integrations:

GET https://mcp.domaindetails.com/lookup/{domain}
POST https://mcp.domaindetails.com/mcp/call-tool

The hosted version runs on Cloudflare Workers for global low-latency access. Use the local version for Claude Desktop and the hosted version for custom HTTP integrations.

Available Tools

rdap_lookup

Look up domain information using the RDAP protocol.

Parameters:

  • domain (string, required): The domain name to look up (e.g., example.com)
  • include_raw (boolean, optional): If true, include raw RDAP 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.

Development

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

# Install dependencies
npm install

# Build
npm run build

# Test locally
node build/index.js

License

MIT

Related Projects

About

Simple RDAP MCP Server for domain information lookup using Model Context Protocol

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published