what is mcp-dnsdumpster?
mcp-dnsdumpster is an MCP server that interacts with the DNSDumpster API, allowing AI assistants to perform detailed DNS reconnaissance through natural language requests.
how to use mcp-dnsdumpster?
To use mcp-dnsdumpster, install the package via PyPI or from source, set your API key, and run the server. You can then query DNS records using natural language prompts.
key features of mcp-dnsdumpster?
- Query domain DNS records through AI assistants
- Retrieve detailed information about A, CNAME, MX, TXT, NS records, and Banner information
- Support for pagination and domain map generation (Plus accounts)
- Rate limiting and caching
use cases of mcp-dnsdumpster?
- Performing DNS reconnaissance for cybersecurity assessments
- Analyzing domain structures for research purposes
- Automating DNS queries in AI-driven applications
FAQ from mcp-dnsdumpster?
- What types of DNS records can I query?
You can query A, CNAME, MX, TXT, NS records, and Banner information.
- Is there a limit on the number of queries?
Yes, there are rate limits in place, especially for Plus accounts.
- How do I install mcp-dnsdumpster?
You can install it via PyPI using
pip install mcp-dnsdumpster
or clone the repository from GitHub.
DNSDumpster - MCP Server
A Model Context Protocol (MCP) server for interacting with the DNSDumpster API, enabling AI assistants to perform detailed DNS reconnaissance through natural language requests.
Features
- Query domain DNS records through AI assistants
- Retrieve detailed information about:
- A records (with associated IP and ASN information)
- CNAME records
- MX records
- TXT records
- NS records
- Banner information where available
- Support for pagination (Plus accounts)
- Rate limiting and caching
Installation
# Install from PyPI
uv pip install mcp-dnsdumpster
# Or from source
git clone https://github.com/yourusername/mcp-dnsdumpster.git
cd mcp-dnsdumpster
uv pip install -e .
Claude Desktop Configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json
on macOS or %AppData%\Claude\claude_desktop_config.json
on Windows):
{
"mcpServers": {
"dnsdumpster": {
"command": "uvx",
"args": ["mcp-dnsdumpster"],
"env": {
"DNSDUMPSTER_API_KEY": "your_api_key_here"
}
}
}
}
Usage
- Set your API key:
export DNSDUMPSTER_API_KEY=your_api_key_here
- Run the server:
# Using uvx (recommended)
uvx mcp-dnsdumpster
# Or if installed from source
uv run server.py
Example Prompts
- "Show me all subdomains for example.com"
- "What are the mail servers for microsoft.com?"
- "Tell me about the DNS infrastructure for twitter.com"
Development
- Python 3.10+
- Uses
uv
for dependency management - Built with MCP SDK 1.4+
License
MIT