domain-tools

Domain Tools MCP Server provides a cohesive set of domain analysis tools accessible via the MCP protocol. It combines WHOIS lookups, DNS record queries, and DNS health checks to give you a complete picture of a domain's configuration and status. You can query WHOIS details to retrieve registrar and registration dates, inspect DNS records across common types (A, AAAA, MX, NS, TXT, CNAME, SOA), and run DNS health checks to surface misconfigurations or potential issues. The server supports complete domain analysis workflows through a single tool, enabling you to perform comprehensive checks for monitoring, auditing, or automation tasks. To use it, connect an MCP client to the server and issue tool requests such as whois_lookup, dns_records, dns_health_check, or domain_analysis with the domain parameter, and optional record_types when querying DNS records.

Prerequisites:

• Python 3.13+ installed on the host
• Internet access for DNS/WHOIS queries

1. Clone the repository:

git clone https://github.com/deshabhishek007/domain-tools-mcp-server.git
cd domain-tools-mcp-server

2. (Optional) Create and activate a virtual environment:

python3 -m venv domain-tools-env
source domain-tools-env/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Run the server locally:

python domain_tools_server.py

5. (Optional) Run with executable permissions if needed:

chmod +x domain_tools_server.py
./domain_tools_server.py

6. If deploying with Docker, use the included Dockerfile to containerize and run the server. Build and run the image as described in the Deployment section of the README.

Tips and considerations:

• Ensure there is network access for DNS queries and WHOIS lookups.
• You can customize DNS resolvers or timeout settings via environment variables as described in the README (e.g., DNS_TIMEOUT, DNS_LIFETIME).
• Use an MCP client to connect and issue requests like whois_lookup, dns_records, dns_health_check, and domain_analysis.
• For production deployments, consider adding authentication and rate limiting to prevent abuse.
• If you encounter dependency issues, verify that your Python environment has dnspython and python-whois installed (pip install -r requirements.txt).
• When running behind a firewall, ensure DNS ports (53 UDP/TCP) and outbound WHOIS access are permitted.