DNSDumpster MCP Server

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