DNStwist MCP Server

Warning

• Only analyze domains you own or have permission to test

• Respect rate limits and DNS server policies

• Use responsibly and ethically

• Be aware that some DNS servers may rate-limit or block automated queries

• Consider the impact on DNS infrastructure when running large scans

Requirements

• Node.js (v18 or later)

• Docker

• macOS, Linux, or Windows with Docker Desktop installed

Quick Start

Installing via Smithery

Installing Manually

1. Install Docker:

2. Install the server globally via npm:

1. Add to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Restart Claude Desktop

Alternative Setup (From Source)

1. Clone and build:

1. Add to your Claude Desktop configuration:

Features

• Domain Fuzzing: Generate domain permutations using various algorithms

• Registration Check: Verify if permutated domains are registered

• DNS Analysis: Check A, AAAA, MX, and NS records

• Web Presence: Capture HTTP banner information

• WHOIS Data: Retrieve registration dates and registrar information

• Phishing Detection: Generate fuzzy hashes of web pages

• Configurable: Custom DNS servers and parallel processing

• Multiple Formats: Support for json, csv, and list output formats

Tools

Domain Fuzzing Tool

• Name: fuzz_domain

• Description: Generate and analyze domain permutations to detect potential typosquatting, phishing, and brand impersonation

• Parameters:

Troubleshooting

Docker Issues

1. Verify Docker is installed and running:

1. Check Docker permissions:

Common Issues

1. DNS resolution problems:

2. Performance issues:

3. After fixing any issues:

Error Messages

• "Docker is not installed or not running": Install Docker and start the Docker daemon

• "Failed to parse dnstwist output": Check if the domain is valid and the format is correct

• "Error executing dnstwist": Check Docker logs and ensure proper permissions

• "DNS server not responding": Verify DNS server accessibility and try alternative servers

Contributing

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

DNStwist MCP Server

Warning

• Only analyze domains you own or have permission to test

• Respect rate limits and DNS server policies

• Use responsibly and ethically

• Be aware that some DNS servers may rate-limit or block automated queries

• Consider the impact on DNS infrastructure when running large scans

Requirements

• Node.js (v18 or later)

• Docker

• macOS, Linux, or Windows with Docker Desktop installed

Quick Start

Installing via Smithery

Installing Manually

1. Install Docker:

2. Install the server globally via npm:

1. Add to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Restart Claude Desktop

Alternative Setup (From Source)

1. Clone and build:

1. Add to your Claude Desktop configuration:

Features

• Domain Fuzzing: Generate domain permutations using various algorithms

• Registration Check: Verify if permutated domains are registered

• DNS Analysis: Check A, AAAA, MX, and NS records

• Web Presence: Capture HTTP banner information

• WHOIS Data: Retrieve registration dates and registrar information

• Phishing Detection: Generate fuzzy hashes of web pages

• Configurable: Custom DNS servers and parallel processing

• Multiple Formats: Support for json, csv, and list output formats

Tools

Domain Fuzzing Tool

• Name: fuzz_domain

• Description: Generate and analyze domain permutations to detect potential typosquatting, phishing, and brand impersonation

• Parameters:

Troubleshooting

Docker Issues

1. Verify Docker is installed and running:

1. Check Docker permissions:

Common Issues

1. DNS resolution problems:

2. Performance issues:

3. After fixing any issues:

Error Messages

• "Docker is not installed or not running": Install Docker and start the Docker daemon

• "Failed to parse dnstwist output": Check if the domain is valid and the format is correct

• "Error executing dnstwist": Check Docker logs and ensure proper permissions

• "DNS server not responding": Verify DNS server accessibility and try alternative servers

Contributing

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License