DNStwist MCP Server

1# DNStwist MCP Server
2[![smithery badge](https://smithery.ai/badge/@burtthecoder/mcp-dnstwist)](https://smithery.ai/server/@burtthecoder/mcp-dnstwist)
3 
4A Model Context Protocol (MCP) server for [dnstwist](https://github.com/elceef/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](https://claude.ai).
5 
6<a href="https://glama.ai/mcp/servers/it7izu3ufb"><img width="380" height="200" src="https://glama.ai/mcp/servers/it7izu3ufb/badge" alt="mcp-dnstwist MCP server" /></a>
7 
8 
9## ⚠️ Warning
10 
11This tool is designed for legitimate security research purposes. Please:
12- Only analyze domains you own or have permission to test
13- Respect rate limits and DNS server policies
14- Use responsibly and ethically
15- Be aware that some DNS servers may rate-limit or block automated queries
16- Consider the impact on DNS infrastructure when running large scans
17 
18## Requirements
19 
20- Node.js (v18 or later)
21- Docker
22- macOS, Linux, or Windows with Docker Desktop installed
23 
24## Quick Start
25 
26### Installing via Smithery
27 
28To install DNStwist for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@burtthecoder/mcp-dnstwist):
29 
30```bash
31npx -y @smithery/cli install @burtthecoder/mcp-dnstwist --client claude
32```
33 
34### Installing Manually
351. Install Docker:
36   - macOS: Install [Docker Desktop](https://www.docker.com/products/docker-desktop)
37   - Linux: Follow the [Docker Engine installation guide](https://docs.docker.com/engine/install/)
38 
392. Install the server globally via npm:
40```bash
41npm install -g mcp-dnstwist
42```
43 
443. Add to your Claude Desktop configuration file:
45```json
46{
47  "mcpServers": {
48    "dnstwist": {
49      "command": "mcp-dnstwist"
50    }
51  }
52}
53```
54 
55Configuration file location:
56- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
57- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
58 
594. Restart Claude Desktop
60 
61## Alternative Setup (From Source)
62 
63If you prefer to run from source or need to modify the code:
64 
651. Clone and build:
66```bash
67git clone <repository_url>
68cd mcp-dnstwist
69npm install
70npm run build
71```
72 
732. Add to your Claude Desktop configuration:
74```json
75{
76  "mcpServers": {
77    "dnstwist": {
78      "command": "node",
79      "args": ["/absolute/path/to/mcp-dnstwist/build/index.js"]
80    }
81  }
82}
83```
84 
85## Features
86 
87- **Domain Fuzzing**: Generate domain permutations using various algorithms
88- **Registration Check**: Verify if permutated domains are registered
89- **DNS Analysis**: Check A, AAAA, MX, and NS records
90- **Web Presence**: Capture HTTP banner information
91- **WHOIS Data**: Retrieve registration dates and registrar information
92- **Phishing Detection**: Generate fuzzy hashes of web pages
93- **Configurable**: Custom DNS servers and parallel processing
94- **Multiple Formats**: Support for json, csv, and list output formats
95 
96## Tools
97 
98### Domain Fuzzing Tool
99- Name: `fuzz_domain`
100- Description: Generate and analyze domain permutations to detect potential typosquatting, phishing, and brand impersonation
101- Parameters:
102  * `domain` (required): Domain name to analyze (e.g., example.com)
103  * `nameservers` (optional, default: "1.1.1.1"): Comma-separated list of DNS servers
104  * `threads` (optional, default: 50): Number of threads for parallel processing
105  * `format` (optional, default: "json"): Output format (json, csv, list)
106  * `registered_only` (optional, default: true): Show only registered domains
107  * `mxcheck` (optional, default: true): Check for MX records
108  * `ssdeep` (optional, default: false): Generate fuzzy hashes of web pages
109  * `banners` (optional, default: true): Capture HTTP banner information
110 
111Example:
112```json
113{
114  "domain": "example.com",
115  "nameservers": "1.1.1.1,8.8.8.8",
116  "threads": 50,
117  "format": "json",
118  "registered_only": true,
119  "mxcheck": true,
120  "banners": true
121}
122```
123 
124## Troubleshooting
125 
126### Docker Issues
127 
1281. Verify Docker is installed and running:
129```bash
130docker --version
131docker ps
132```
133 
1342. Check Docker permissions:
135   - Ensure your user has permissions to run Docker commands
136   - On Linux, add your user to the docker group: `sudo usermod -aG docker $USER`
137 
138### Common Issues
139 
1401. DNS resolution problems:
141   - Verify DNS servers are accessible
142   - Try alternative DNS servers (e.g., 8.8.8.8)
143   - Check for rate limiting or blocking
144 
1452. Performance issues:
146   - Adjust thread count based on system capabilities
147   - Consider network bandwidth and latency
148   - Monitor DNS server response times
149 
1503. After fixing any issues:
151   - Save the configuration file
152   - Restart Claude Desktop
153 
154## Error Messages
155 
156- "Docker is not installed or not running": Install Docker and start the Docker daemon
157- "Failed to parse dnstwist output": Check if the domain is valid and the format is correct
158- "Error executing dnstwist": Check Docker logs and ensure proper permissions
159- "DNS server not responding": Verify DNS server accessibility and try alternative servers
160 
161## Contributing
162 
1631. Fork the repository
1642. Create a feature branch (`git checkout -b feature/amazing-feature`)
1653. Commit your changes (`git commit -m 'Add amazing feature'`)
1664. Push to the branch (`git push origin feature/amazing-feature`)
1675. Open a Pull Request
168 
169## License
170 
171This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
172