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_ai_domain_checker_mcp-1.0.0.tar.gz (6.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

truffle_ai_domain_checker_mcp-1.0.0-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for truffle_ai_domain_checker_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 64767bc017e0a26d1028b61e653ea84ef51c85aa77ee2df4c71dc34e37d818ee
MD5 336f7baab1e5284a7ba5ae8b67fdc21f
BLAKE2b-256 420e97d3bb66f23ce81bd38d55a9727ffdd9e1fc7860ca8f83a3da65cfb28b7e

See more details on using hashes here.

File details

Details for the file truffle_ai_domain_checker_mcp-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for truffle_ai_domain_checker_mcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6adbb1cbd00ff461849845ef177fd3d837052fbd68f6cb8666d99a382bd54b00
MD5 8e6778b3df254598435000273a87b2f9
BLAKE2b-256 f2af0ab118da2f246239969406ae22019be1f3393d5216df8eda3914e69d2cd5

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