Skip to main content
Glama
tudadada

mcp-server-domain-checker

mcp-server-domain-checker

npm version License: MIT MCP

Model Context Protocol (MCP) server for instant domain availability checks, DNS record resolution, and registrar routing.


⚡ Features & Tools

  • check_domain_availability: Performs authoritative registry socket query to verify whether a domain name is available for registration.

  • resolve_dns_records: Resolves live DNS records (A, NS, MX, TXT) for any domain using Node.js native DNS resolver.


Related MCP server: Domain Checker MCP Server

🚀 Quick Start (Running with AI Clients)

Claude Desktop Integration

Add this snippet to your claude_desktop_config.json:

{
  "mcpServers": {
    "domain-checker": {
      "command": "npx",
      "args": ["-y", "mcp-server-domain-checker"]
    }
  }
}

Cursor IDE / Windsurf Integration

Under MCP Settings, add a new stdio transport:

  • Command: npx -y mcp-server-domain-checker


📦 Local Installation & Development

npm install -g mcp-server-domain-checker

Or run directly via stdio:

npx mcp-server-domain-checker

📄 License

MIT License. Developed for the global AI agent and domain ecosystem.

Available Tools

2 tools
check_domain_availabilityB

Performs authoritative registry socket query to verify whether a domain name is available for registration.

ParametersJSON Schema
NameRequiredDescriptionDefault
domainYesDomain name to check (e.g. mynewbrand123.com)

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. It does disclose the query mechanism ('authoritative registry socket query'), which tells the agent this is an external authoritative registry lookup and implies a safe read operation. However, it omits rate limits, timeouts, return format, and error behavior, leaving significant gaps for a no-annotation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, front-loaded sentence that states the action and mechanism without any wasted words. It is appropriately sized for a simple one-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple availability check with no output schema and no annotations, the description covers the core action but does not indicate the return value (e.g., boolean availability), error conditions, or any safety profile. It is minimum viable but leaves clear gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 100% description coverage for the single 'domain' parameter, including an example. The description adds no additional parameter semantics beyond what the schema already provides, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb + resource: 'verify whether a domain name is available for registration.' The mechanism ('authoritative registry socket query') further clarifies it is a registry check, implicitly distinct from a DNS resolver. However, it does not explicitly name or differentiate from the sibling tool resolve_dns_records.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description only restates the tool's purpose. It gives no guidance on when to use this tool versus alternatives (e.g., resolve_dns_records), no prerequisites, and no exclusions. An agent must infer usage entirely from the name and description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

resolve_dns_recordsB

Resolves live DNS records (A, NS, MX, TXT) for any domain using Node.js native DNS resolver.

ParametersJSON Schema
NameRequiredDescriptionDefault
domainYesDomain name to resolve

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. It usefully discloses that resolution is live (not cached), enumerates the record types returned, and notes the Node.js native resolver, which implies unsupported types like AAAA/CNAME are out of scope. It says nothing about failure behavior for nonexistent domains, timeouts, or the shape of results.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with no filler, front-loading the verb, record types, and implementation detail in that order. Nothing could be trimmed without losing information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter, no-annotation, no-output-schema tool, the description is adequate but thin: it does not say what a response looks like (e.g., record arrays), whether lookups fail softly or raise on NXDOMAIN, or how the 'live' behavior affects repeated calls.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is a single 'domain' parameter with 100% schema description coverage, so the schema already documents it. The description adds only the phrase 'for any domain', which conveys scope but no format, subdomain, or IDN handling details. Baseline 3 is appropriate here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb (resolves) plus resource (live DNS records), with the supported record types (A, NS, MX, TXT) and scope (any domain) spelled out. It is self-evidently distinct from check_domain_availability, though it never names or contrasts that sibling explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description states what the tool does but gives no when-to-use, when-not-to-use, or alternative guidance. There is a nearby sibling (check_domain_availability) and no hint about when DNS resolution is the right call versus a simple availability check.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 2 tool updatesv1.0.0
    • First observedcheck_domain_availability
    • First observedresolve_dns_records

TDQS

A3.5/5.0

Scored across 2 tools

Disambiguation5/5

The two tools target entirely different concerns: registration availability via registry socket query versus live DNS record resolution. There is no plausible scenario where an agent would confuse the two.

Naming Consistency5/5

Both tools follow a clean verb_noun snake_case pattern (check_domain_availability, resolve_dns_records). Consistent and predictable.

Tool Count3/5

Two tools is on the thin side for a domain-checker server; a single focused capability pair is defensible but leaves little room for adjacent operations. Not a mismatch, but borderline sparse.

Completeness3/5

Availability and DNS cover the core lookup needs, but there is no WHOIS/registrar data, expiry, or bulk/batch checking. Agents needing registration metadata would hit a dead end.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables checking domain name availability using WHOIS lookups and DNS resolution. Supports both single and batch domain checking with detailed availability analysis.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables domain availability checking through dual verification using WHOIS lookups and DNS resolution. Supports both single and batch processing to provide detailed analysis on whether domains are likely available or already registered.
    4
    -
  • A
    license
    A
    quality
    D
    maintenance
    Enables checking domain name availability for single or multiple domains using WHOIS and DNS verification.
    1
    21
    MIT