Skip to main content

MCP Server for checking domain name availability using WHOIS and DNS via stdio.

Project description

FastDomainCheck MCP Server (Python)

This is a domain availability check server implemented using Python and the Model Context Protocol (MCP). It provides MCP Tools to check if single or multiple domain names are already registered.

Features

  • Bulk domain registration status checking
  • Dual verification using WHOIS and DNS
  • Support for IDN (Internationalized Domain Names)
  • Concise output format
  • Built-in input validation and error handling

Tool Documentation

check_domains

Check registration status for multiple domain names.

Input Format

{
  "domains": ["example.com", "test.com"]
}

Parameters:

  • domains: Array of strings containing domain names to check
    • Maximum length of 255 characters per domain
    • Maximum 50 domains per request
    • No empty domain names allowed

Output Format

{
  "results": {
    "example.com": {
      "registered": true
    },
    "test.com": {
      "registered": false
    }
  }
}

Response Fields:

  • results: Object with domain names as keys and check results as values
    • registered: Boolean
      • true: Domain is registered
      • false: Domain is available

Error Handling

The tool will return an error in the following cases:

  1. Empty domains list
  2. More than 50 domains in request
  3. Empty domain name
  4. Domain name exceeding 255 characters
  5. Result serialization failure

Error Response Format:

{
  "error": "Error: domains list cannot be empty"
}

Usage Examples

Check multiple domains:

Request

{
  "domains": ["example.com", "test123456.com"]
}

Response

{
  "results": {
    "example.com": {
      "registered": true
    },
    "test123456.com": {
      "registered": false
    }
  }
}

MCP Server Settings

Configuring FastDomainCheck MCP in Claude Deskto

Modify your claude-desktop-config.json file as shown below

{
  "mcpServers": {
    "fastdomaincheck": {
      "command": "uvx",
      "args": [
        "fastdomaincheck-mcp-server"
      ]
    }
  }
}

Go Version Reference

go version

Contributing

Feel free to open issues or submit pull requests.

License

MIT License (You should add a LICENSE file, typically containing the MIT license text)

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

fastdomaincheck_mcp_server-0.1.11.tar.gz (7.7 kB view details)

Uploaded Source

Built Distribution

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

fastdomaincheck_mcp_server-0.1.11-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file fastdomaincheck_mcp_server-0.1.11.tar.gz.

File metadata

File hashes

Hashes for fastdomaincheck_mcp_server-0.1.11.tar.gz
Algorithm Hash digest
SHA256 5251a4a3fb18e8f97c06b0b1803b85e609dd4d46e04d67aedd35991d56ae10f1
MD5 b0bda9187526d14ded95e3446b8f0dab
BLAKE2b-256 09e61d78d9f9418b28d9d92365dc15ad6acaeeb9da5d3c638ad3b3c2c713ebda

See more details on using hashes here.

File details

Details for the file fastdomaincheck_mcp_server-0.1.11-py3-none-any.whl.

File metadata

File hashes

Hashes for fastdomaincheck_mcp_server-0.1.11-py3-none-any.whl
Algorithm Hash digest
SHA256 f09ec2dc883687b804a92f8b5f8bc5d83af7a18585aac1dc325352dfd82211d6
MD5 7800ad892ae6fd244f7e1e0a9840a1e9
BLAKE2b-256 4fb33ea6ab25329e64d816bc65a592d96fe16d70bf7b894f8b644ff5bf208b41

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