# 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

```bash
npm install rdap-mcp
```

Or use directly with npx:

```bash
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`

```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:**
```json
{
  "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

```bash
# 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

- [domaindetails-mcp](https://github.com/simplebytes-com/domaindetails-mcp) - Full-featured domain research toolkit with RDAP, WHOIS, and more
- [DomainDetails.com](https://domaindetails.com) - Full-featured domain research SaaS