DNSDumpster -

You run a DNSDumpster MCP Server to let AI-assisted tools query DNS records and related data through a simple, configurable endpoint. This server exposes DNS information such as A, CNAME, MX, TXT, and NS records, plus banner data when available, enabling rich DNS reconnaissance via natural language prompts while handling rate limits and caching.

How to use

You interact with the DNSDumpster MCP Server through an MCP client. First, provide your API key to enable access to DNSDumpster data. Start the server using your preferred MCP runtime, then ask questions like showing subdomains, identifying mail servers, or mapping out a domain’s DNS structure. The server handles querying the DNS records you request and returns structured results that you can use in your workflows.

Typical usage patterns include:

• Ask for all subdomains of a domain to understand its surface area.
• Retrieve specific DNS records for a domain, such as A, MX, or NS records.
• Request banner information when available to gain additional context about a host.
• Generate a domain map if your plan supports that feature.

How to install

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

Prerequisites you need before installing:
- Python 3.10 or newer
- An MCP runtime environment (such as uvx) to run the server
- Git for cloning the source repository (optional if using PyPI)
Then choose one of the installation paths above: install from PyPI or install from source.

Run the server using the MCP runtime:
- Using uvx (recommended)
  - uvx mcp-dnsdumpster
- If installed from source (alternative)
  - uv run server.py

Optionally, configure your environment with your API key before starting the server.

Configuration and usage notes

Configure your MCP client to point to the DNSDumpster MCP Server. The server requires an API key to access DNSDumpster data. Set the API key in your environment and ensure the key is available to the runtime that launches the server. Example environment variable name: DNSDUMPSTER_API_KEY.

Claude Desktop integration can be added to streamline usage. Add the following configuration to your Claude Desktop client so the MCP server is loaded automatically:

```json
{
  "mcpServers": {
    "dnsdumpster": {
      "command": "uvx",
      "args": ["mcp-dnsdumpster"],
      "env": {
        "DNSDUMPSTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Place this JSON in the Claude Desktop config path appropriate for your OS (macOS or Windows).

## Notes on usage and capabilities

The DNSDumpster MCP Server supports querying a range of DNS records and related data. Available data types include A, CNAME, MX, TXT, NS records, as well as banner information when available. Some plans offer pagination for large results and the ability to generate a domain map. The server includes rate limiting and caching to optimize repeated queries.

## Available tools

### query\_dns\_records

Query DNS records for a domain and return a structured set of results including A, CNAME, MX, TXT, and NS records.

### fetch\_a\_records

Retrieve A records for a domain, including associated IPs and ASN information if available.

### fetch\_cname\_records

Retrieve CNAME records for a domain.

### fetch\_mx\_records

Retrieve MX records for a domain.

### fetch\_txt\_records

Retrieve TXT records for a domain.

### fetch\_ns\_records

Retrieve NS records for a domain.

### banner\_info

Retrieve banner information for hosts when available.

### paginate\_results

Handle pagination for large result sets on supported plans.

### domain\_map

Generate a visual or data map of a domain’s DNS structure on supported plans.