DNSTwist

by burtthecoder

36 stars

1.4k downloads

Not rated

GitHub

About

A Model Context Protocol (MCP) server for dnstwist, a powerful DNS fuzzing tool that helps detect typosquatting, phishing, and corporate espionage.

Details

Author: burtthecoder
Repository: w0h1v/mcp-dnstwist
GitHub stars: 36
Downloads: 1,410
License: MIT License
Categories: Design, Developer Tools, AI, Security, Infrastructure, Frontend, Automation, Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name DNSTwist

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

To install DNStwist for Claude Desktop automatically via Smithery:

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

1. Install Docker:
- macOS: Install Docker Desktop
- Linux: Follow the Docker Engine installation guide

2. Install the server globally via npm:

npm install -g mcp-dnstwist

3. 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

4. Restart Claude Desktop

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

2. Add to your Claude Desktop configuration:

{

  "mcpServers": {

    "dnstwist": {

      "command": "node",

      "args": ["/absolute/path/to/mcp-dnstwist/build/index.js"]

    }

  }

}

`fuzz_domain`

Generate and analyze domain permutations to detect potential typosquatting, phishing, and brand impersonation. Parameters: domain (string, required), nameservers (string, optional), threads (number, optional), format (string, optional), registered_only (boolean, optional), mxcheck (boolean, optional), ssdeep (boolean, optional), banners (boolean, optional)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "dnstwist": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

DNStwist MCP Server

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: - macOS: Install Docker Desktop - Linux: Follow the Docker Engine installation guide

2. Install the server globally via npm:

npm install -g mcp-dnstwist

3. 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

4. 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

2. Add to your Claude Desktop configuration:

{

  "mcpServers": {

    "dnstwist": {

      "command": "node",

      "args": ["/absolute/path/to/mcp-dnstwist/build/index.js"]

    }

  }

}

Features

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

fuzz_domain

Claude Desktop / Cursor

Linux

Macos

Windows

DNStwist MCP Server

⚠️ Warning

Requirements

Quick Start

Installing via Smithery

Installing Manually

Alternative Setup (From Source)

Features

Tools

Domain Fuzzing Tool

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`fuzz_domain`