do-remote -template

This MCP server is a remote implementation that exposes a domain availability checker. It combines WHOIS lookups with DNS resolution to determine whether a domain is likely available, and supports batch processing for checking multiple domains concurrently. The server is built with the FastMCP framework to provide asynchronous, scalable operations suitable for MCP-compatible clients (such as Claude Desktop, Cursor, Windsurf, and others). To use it, deploy the remote MCP server and point your MCP client to the /mcp endpoint on your deployed URL, as documented in the README. The typical workflow is to submit a domain or a list of domains and receive structured availability information that includes WHOIS status, DNS resolvability, and detailed results.

You can run the server locally for development and testing by executing the python domain-checker.py script (with a configured Python virtual environment) or deploy it to a remote host (e.g., DigitalOcean App Platform) and connect to the provided remote MCP URL. When using the remote deployment, configure your MCP client to reference the https://your-app-name.ondigitalocean.app/mcp endpoint and include a descriptive label for the domain-checker service in your client configuration.

Prerequisites:

• Python 3.8 or higher
• pip (comes with Python 3.8+)
• Internet access to install dependencies

Setup (local development):

1. Clone the repository

git clone https://github.com/ajot/domain-checker-mcp-server.git
cd domain-checker-mcp-server

2. Create and activate a virtual environment (recommended)

python -m venv venv
# macOS/Linux
source venv/bin/activate
# Windows
venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Run the server locally

python domain-checker.py

Deployment (DigitalOcean App Platform or other remote host):

1. Push your code to a Git repository (GitHub, GitLab, etc.).
2. Create a new app on your hosting platform and configure the environment to use Python.
3. Set the run command to something like:
   • python domain-checker.py
4. Ensure PORT is exported in the environment (e.g., PORT=8080) and that the app is accessible at the /mcp endpoint for MCP clients.
5. Use the remote MCP URL in your client configuration as shown in the README.

Tips and considerations:

• Ensure your Python virtual environment is active when developing locally to avoid package conflicts.
• The server is designed for remote deployment; in Local development, use the local-domain-checker.py variant if present for simpler host/port configuration.
• When deploying, set PORT to 8080 (as shown in the deployment guide) and configure the host/platform to expose that port.
• If you encounter WHOIS or DNS timeout issues, consider adding retry logic or adjusting timeouts in your environment; rate limits may apply to WHOIS lookups.
• This template focuses on domain availability checks via WHOIS and DNS; customize or extend the domain-checker.py script to add additional analyses if needed.