DNSDumpster - MCP Server

By MaxWeeden GitHub

Overview

what is DNSDumpster - MCP Server?

DNSDumpster - MCP Server is a Model Context Protocol (MCP) server designed to interact with the DNSDumpster API, allowing AI assistants to perform detailed DNS reconnaissance through natural language requests.

how to use DNSDumpster - MCP Server?

To use the server, install it via PyPI or from the source, set your API key, and run the server using the recommended command. You can then query DNS records using natural language prompts.

key features of DNSDumpster - MCP Server?

Query domain DNS records through AI assistants
Retrieve detailed information about A, CNAME, MX, TXT, and NS records
Support for pagination and domain map generation (Plus accounts)
Rate limiting and caching

use cases of DNSDumpster - MCP Server?

Querying subdomains for a given domain
Retrieving mail server information for domains
Generating visual maps of domain structures

FAQ from DNSDumpster - MCP Server?

What programming language is used?

The server is built with Python 3.10+.

How do I install the server?

You can install it from PyPI using pip install mcp-dnsdumpster or clone the repository from GitHub.

Is there support for pagination?

Yes, pagination is supported for Plus accounts.

Content

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)
Support for domain map generation (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"
"Generate a visual map of Facebook's domain structure"

Development

Python 3.10+
Uses uv for dependency management
Built with MCP SDK 1.4+

License

MIT

No tools information available.

No content found.