Dnstwist
    Dnstwist

    Dnstwist

    MCP server for dnstwist, a powerful DNS fuzzing tool that helps detect typosquatting, phishing, and corporate espionage.

    4.3

    GitHub Stats

    Stars

    29

    Forks

    5

    Release Date

    4/10/2025

    about 2 months ago

    Detailed Description

    dnstwist mcp server

    smithery badge

    a model context protocol (mcp) server for dnstwist, a powerful dns fuzzing tool that helps detect typosquatting, phishing, and corporate espionage. this server provides tools for analyzing domain permutations and identifying potentially malicious domains. it is designed to integrate seamlessly with mcp-compatible applications like claude desktop.

    ⚠️ warning

    this tool is designed for legitimate security research purposes. please:

    • 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

    to install dnstwist for claude desktop automatically via smithery:

    npx -y @smithery/cli install @burtthecoder/mcp-dnstwist --client claude
    

    installing manually

    1. install docker:

    2. install the server globally via npm:

    npm install -g mcp-dnstwist
    
    1. add to your claude desktop configuration file:
    {
      "mcpservers": {
        "dnstwist": {
          "command": "mcp-dnstwist"
        }
      }
    }
    

    configuration file location:

    • macos: ~/library/application support/claude/claude_desktop_config.json
    • windows: %appdata%\claude\claude_desktop_config.json
    1. restart claude desktop

    alternative setup (from source)

    if you prefer to run from source or need to modify the code:

    1. clone and build:
    git clone <repository_url>
    cd mcp-dnstwist
    npm install
    npm run build
    
    1. add to your claude desktop configuration:
    {
      "mcpservers": {
        "dnstwist": {
          "command": "node",
          "args": ["/absolute/path/to/mcp-dnstwist/build/index.js"]
        }
      }
    }
    

    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:
      • domain (required): domain name to analyze (e.g., example.com)
      • nameservers (optional, default: "1.1.1.1"): comma-separated list of dns servers
      • threads (optional, default: 50): number of threads for parallel processing
      • format (optional, default: "json"): output format (json, csv, list)
      • registered_only (optional, default: true): show only registered domains
      • mxcheck (optional, default: true): check for mx records
      • ssdeep (optional, default: false): generate fuzzy hashes of web pages
      • banners (optional, default: true): capture http banner information

    example:

    {
      "domain": "example.com",
      "nameservers": "1.1.1.1,8.8.8.8",
      "threads": 50,
      "format": "json",
      "registered_only": true,
      "mxcheck": true,
      "banners": true
    }
    

    troubleshooting

    docker issues

    1. verify docker is installed and running:
    docker --version
    docker ps
    
    1. check docker permissions:
      • ensure your user has permissions to run docker commands
      • on linux, add your user to the docker group: sudo usermod -ag docker $user

    common issues

    1. dns resolution problems:

      • verify dns servers are accessible
      • try alternative dns servers (e.g., 8.8.8.8)
      • check for rate limiting or blocking
    2. performance issues:

      • adjust thread count based on system capabilities
      • consider network bandwidth and latency
      • monitor dns server response times
    3. after fixing any issues:

      • save the configuration file
      • restart claude desktop

    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

    this project is licensed under the mit license - see the license file for details.

    Star History

    Star History

    Dec 19Mar 9Mar 22Mar 31Apr 9Apr 19May 18Jun 12Jul 608162432
    Powered by MSeeP Analytics

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.