Skip to main content
Glama
@whoisjson/mcp-server

@whoisjson/mcp-server

Official
by Whoisjson

@whoisjson/mcp-server

MCP (Model Context Protocol) server for the WhoisJSON API. Exposes WHOIS, DNS, SSL, and domain availability lookups as tools for AI assistants.

Tools

Tool

Description

whois_lookup

WHOIS registration data for a domain (registrar, dates, contacts, nameservers…)

dns_lookup

All DNS records for a domain (A, AAAA, MX, NS, TXT, CNAME, SOA, CAA, DMARC…)

ssl_check

SSL/TLS certificate details and validity for a domain

domain_availability

Check if a domain is available for registration

Related MCP server: Domain Checker MCP Server

Prerequisites

  1. Sign up at whoisjson.com and copy your API key from the dashboard.

  2. Node.js ≥ 18.

Installation

npm install -g @whoisjson/mcp-server
# or run directly with npx (no install needed):
npx @whoisjson/mcp-server

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or
%APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "whoisjson": {
      "command": "npx",
      "args": ["-y", "@whoisjson/mcp-server"],
      "env": {
        "WHOISJSON_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "whoisjson": {
      "command": "npx",
      "args": ["-y", "@whoisjson/mcp-server"],
      "env": {
        "WHOISJSON_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "whoisjson": {
      "command": "npx",
      "args": ["-y", "@whoisjson/mcp-server"],
      "env": {
        "WHOISJSON_API_KEY": "your_api_key_here"
      }
    }
  }
}

Running locally (development)

cd mcp-server
npm install
npm run build
WHOISJSON_API_KEY=your_key npm start

Publishing

npm run build
npm publish --access public

API reference

Full API documentation: whoisjson.com/documentation

Available Tools

4 tools
dns_lookupA

Query DNS records for a domain name. Returns all available record types including A (IPv4), AAAA (IPv6), MX (mail), NS (nameservers), TXT, CNAME, SOA, CAA, DMARC, BIMI, MTA-STS, and TLS-RPT records. Useful for diagnosing DNS configuration, verifying mail settings, or auditing domain infrastructure.

Inputs: domain (required).

domain_availabilityA

Check whether a domain name is available for registration. Returns a boolean indicating if the domain is available. Useful for finding an unregistered domain before attempting to register it.

Inputs: domain (required).

ssl_checkA

Retrieve and validate the SSL/TLS certificate details for a domain. Returns the issuer, validity period (valid_from / valid_to), whether the certificate is currently valid, fingerprints, subject alternative names, and full certificate details. Useful for checking certificate expiry, verifying the issuer, or auditing TLS configuration.

Inputs: domain (required).

whois_lookupA

Retrieve WHOIS registration data for a domain name. Returns registrar details, creation/expiration dates, nameservers, contact information, DNSSEC status, and domain age analysis. Useful for checking domain ownership and registration info.

Inputs: domain (required).

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 4 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of domain investigation: WHOIS registration data, DNS records, SSL certificate validity, and availability check. There is no overlap or ambiguity in their purposes.

    Naming Consistency4/5

    All names use snake_case and follow a clear pattern, but the verb usage is slightly inconsistent: whois_lookup and dns_lookup share the 'lookup' suffix, ssl_check uses 'check', and domain_availability is a noun phrase. Still readable and predictable.

    Tool Count5/5

    Four tools form a focused, well-scoped set for domain diagnostics. Each tool addresses a core need (WHOIS, DNS, SSL, availability) without redundancy or excess.

    Completeness4/5

    Covers the primary domain lookup operations thoroughly. Minor gaps like reverse DNS or certificate transparency logs are not present, but the included tools handle typical domain investigation workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to perform WHOIS lookups to retrieve domain registration details, including ownership, registration dates, and availability status without requiring browser searches.
      4
      43 npm
      22
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to check domain availability, perform batch domain lookups, and generate intelligent domain name suggestions across multiple TLDs using WHOIS integration.
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables domain intelligence lookups including current and historical WHOIS, reverse WHOIS by registrant info, and DNS record retrieval through the WhoisXML API.
      127 npm
      MIT