# 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)
```bash
uvx --from git+https://github.com/truffle-ai/mcp-servers --subdirectory src/domain-checker truffle-domain-checker-mcp
```
### Using uv
```bash
uv add git+https://github.com/truffle-ai/mcp-servers --subdirectory src/domain-checker
```
### From source
```bash
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`:
```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:
```yaml
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](../../LICENSE) for details.
## Contributing
Contributions welcome! Please see [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines.
Raw data
{
"_id": null,
"home_page": null,
"name": "truffle-ai-domain-checker-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "domain, mcp, saiki, truffle-ai, whois",
"author": null,
"author_email": "Truffle AI <founders@trytruffle.ai>",
"download_url": "https://files.pythonhosted.org/packages/23/d4/27e2b7cc2992f65e2ebf1c44b4cccc460f9e02b828d59e3adbbd3af0fd71/truffle_ai_domain_checker_mcp-1.0.1.tar.gz",
"platform": null,
"description": "# Truffle Domain Checker MCP Server\n\nA Model Context Protocol (MCP) server that provides domain availability checking capabilities. Perfect for product name research and brand validation.\n\n## Features\n\n- **Single Domain Check**: Check availability of a specific domain\n- **Batch Domain Check**: Check multiple domains simultaneously \n- **Domain Variations**: Check a base name across multiple TLDs\n- **Dual Verification**: Uses both WHOIS lookups and DNS resolution\n- **Async Operations**: Non-blocking concurrent domain checks\n\n## Installation\n\n### Using uvx (recommended)\n\n```bash\nuvx --from git+https://github.com/truffle-ai/mcp-servers --subdirectory src/domain-checker truffle-domain-checker-mcp\n```\n\n### Using uv\n\n```bash\nuv add git+https://github.com/truffle-ai/mcp-servers --subdirectory src/domain-checker\n```\n\n### From source\n\n```bash\ngit clone https://github.com/truffle-ai/mcp-servers.git\ncd mcp-servers/src/domain-checker\nuv sync\nuv run truffle-domain-checker-mcp\n```\n\n## Usage\n\nThe server provides three main tools:\n\n### check_domain(domain: str)\nCheck if a single domain is available for registration.\n\n### check_multiple_domains(domains: List[str])\nCheck availability for multiple domains at once. Great for comparing product name options.\n\n### check_domain_variations(base_name: str, extensions: List[str] = None)\nCheck a base name across multiple TLD extensions (.com, .net, .org, .io, .app, .dev, .tech by default).\n\n## Domain Status Indicators\n\n- \u2705 **LIKELY AVAILABLE**: Domain appears to be unregistered\n- \u274c **NOT AVAILABLE**: Domain is registered and in use\n- \u2753 **UNCLEAR**: Mixed signals, manual verification recommended\n\n## Configuration with MCP Clients\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"domain-checker\": {\n \"command\": \"uvx\",\n \"args\": [\n \"--from\",\n \"git+https://github.com/truffle-ai/mcp-servers\",\n \"--subdirectory\",\n \"src/domain-checker\", \n \"truffle-domain-checker-mcp\"\n ],\n \"env\": {\n \"MCP_TRANSPORT\": \"stdio\"\n }\n }\n }\n}\n```\n\n### Saiki\n\nAdd to your Saiki configuration:\n\n```yaml\nmcp_servers:\n - name: domain-checker\n command: uvx\n args:\n - --from\n - git+https://github.com/truffle-ai/mcp-servers\n - --subdirectory\n - src/domain-checker\n - truffle-domain-checker-mcp\n env:\n MCP_TRANSPORT: stdio\n```\n\n## Examples\n\n### Single Domain Check\n```\nUser: Is myawesomeapp.com available?\nAssistant: [Uses check_domain(\"myawesomeapp.com\")]\n```\n\n### Multiple Domain Check \n```\nUser: Check availability for myapp.com, myapp.io, and myapp.dev\nAssistant: [Uses check_multiple_domains([\"myapp.com\", \"myapp.io\", \"myapp.dev\"])]\n```\n\n### Domain Variations\n```\nUser: Check all major extensions for \"brandname\"\nAssistant: [Uses check_domain_variations(\"brandname\")]\n```\n\n## Dependencies\n\n- `fastmcp>=0.1.0` - FastMCP framework\n- `python-whois>=0.8.0` - WHOIS lookups\n- `dnspython>=2.4.0` - DNS resolution\n- `uvicorn>=0.23.0` - HTTP server support\n\n## License\n\nMIT - See [LICENSE](../../LICENSE) for details.\n\n## Contributing\n\nContributions welcome! Please see [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines.",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for checking domain name availability",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/truffle-ai/mcp-servers",
"Issues": "https://github.com/truffle-ai/mcp-servers/issues",
"Repository": "https://github.com/truffle-ai/mcp-servers"
},
"split_keywords": [
"domain",
" mcp",
" saiki",
" truffle-ai",
" whois"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "56e3c7f3da0479a71cd90409d7f6302f3812e183eb5c8a8ffb4caa42a46cb082",
"md5": "fb2a9281fd7cf7f660c4baeadb9358cf",
"sha256": "ded09a61d506d1e062798ed0f79f1b48a3137a0d63f9d554f9257dd0feec7f91"
},
"downloads": -1,
"filename": "truffle_ai_domain_checker_mcp-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fb2a9281fd7cf7f660c4baeadb9358cf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 11141,
"upload_time": "2025-07-22T14:33:57",
"upload_time_iso_8601": "2025-07-22T14:33:57.736670Z",
"url": "https://files.pythonhosted.org/packages/56/e3/c7f3da0479a71cd90409d7f6302f3812e183eb5c8a8ffb4caa42a46cb082/truffle_ai_domain_checker_mcp-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "23d427e2b7cc2992f65e2ebf1c44b4cccc460f9e02b828d59e3adbbd3af0fd71",
"md5": "bedd897e1c35d73807bc8fed6b52e83e",
"sha256": "8528e9e61d2a85346eb23c2e0e533b0068a0f14ddf212dc7be1dd2cbf71dc67d"
},
"downloads": -1,
"filename": "truffle_ai_domain_checker_mcp-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "bedd897e1c35d73807bc8fed6b52e83e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 6001,
"upload_time": "2025-07-22T14:33:59",
"upload_time_iso_8601": "2025-07-22T14:33:59.073117Z",
"url": "https://files.pythonhosted.org/packages/23/d4/27e2b7cc2992f65e2ebf1c44b4cccc460f9e02b828d59e3adbbd3af0fd71/truffle_ai_domain_checker_mcp-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-22 14:33:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "truffle-ai",
"github_project": "mcp-servers",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "truffle-ai-domain-checker-mcp"
}
JSON
