Skip to main content

MCP server for checking domain name availability

Project description

Truffle Domain Checker MCP Server

A Model Context Protocol (MCP) server that provides domain availability checking capabilities. Perfect for product name research and brand validation.

Features

  • Single Domain Check: Check availability of a specific domain
  • Batch Domain Check: Check multiple domains simultaneously
  • Domain Variations: Check a base name across multiple TLDs
  • Dual Verification: Uses both WHOIS lookups and DNS resolution
  • Async Operations: Non-blocking concurrent domain checks

Installation

Using uvx (recommended)

uvx --from git+https://github.com/truffle-ai/mcp-servers --subdirectory src/domain-checker truffle-domain-checker-mcp

Using uv

uv add git+https://github.com/truffle-ai/mcp-servers --subdirectory src/domain-checker

From source

git clone https://github.com/truffle-ai/mcp-servers.git
cd mcp-servers/src/domain-checker
uv sync
uv run truffle-domain-checker-mcp

Usage

The server provides three main tools:

check_domain(domain: str)

Check if a single domain is available for registration.

check_multiple_domains(domains: List[str])

Check availability for multiple domains at once. Great for comparing product name options.

check_domain_variations(base_name: str, extensions: List[str] = None)

Check a base name across multiple TLD extensions (.com, .net, .org, .io, .app, .dev, .tech by default).

Domain Status Indicators

  • LIKELY AVAILABLE: Domain appears to be unregistered
  • NOT AVAILABLE: Domain is registered and in use
  • UNCLEAR: Mixed signals, manual verification recommended

Configuration with MCP Clients

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "domain-checker": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/truffle-ai/mcp-servers",
        "--subdirectory",
        "src/domain-checker", 
        "truffle-domain-checker-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Saiki

Add to your Saiki configuration:

mcp_servers:
  - name: domain-checker
    command: uvx
    args:
      - --from
      - git+https://github.com/truffle-ai/mcp-servers
      - --subdirectory
      - src/domain-checker
      - truffle-domain-checker-mcp
    env:
      MCP_TRANSPORT: stdio

Examples

Single Domain Check

User: Is myawesomeapp.com available?
Assistant: [Uses check_domain("myawesomeapp.com")]

Multiple Domain Check

User: Check availability for myapp.com, myapp.io, and myapp.dev
Assistant: [Uses check_multiple_domains(["myapp.com", "myapp.io", "myapp.dev"])]

Domain Variations

User: Check all major extensions for "brandname"
Assistant: [Uses check_domain_variations("brandname")]

Dependencies

  • fastmcp>=0.1.0 - FastMCP framework
  • python-whois>=0.8.0 - WHOIS lookups
  • dnspython>=2.4.0 - DNS resolution
  • uvicorn>=0.23.0 - HTTP server support

License

MIT - See LICENSE for details.

Contributing

Contributions welcome! Please see CONTRIBUTING.md for guidelines.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

truffle_domain_checker_mcp-1.0.0.tar.gz (5.9 kB view details)

Uploaded Source

File details

Details for the file truffle_domain_checker_mcp-1.0.0.tar.gz.

File metadata

File hashes

Hashes for truffle_domain_checker_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 cdcf4a58bebc4a0a729551c5360af92b0893e3fc9b25b3179cda007f8bfe3b7b
MD5 bbbdc0b25f0ffca46c0a211aafe478d3
BLAKE2b-256 9ecf4365a4f323dbcda02fd562a40cdbe78093281ca7100ecb5d44f3cacac85c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page