MCP Dnsdumpster

🚀 DNSDumpster - MCP Server

This project enables querying DNS records of domains via an AI assistant and provides detailed domain information.

🚀 Quick Start

The DNSDumpster - MCP Server allows you to query DNS records of domains using an AI assistant and obtain various detailed information about the domains.

✨ Features

• Query DNS records of domains through an AI assistant.
• Retrieve the following detailed information:
  • A records (with associated IP and ASN information).
  • CNAME records.
  • MX records.
  • TXT records.
  • NS records.
  • Available banner information.
• Support pagination (for Plus accounts).
• Implement rate limiting and caching.

📦 Installation

# Install from PyPI
uv pip install mcp-dnsdumpster

# Or install from source code
git clone https://github.com/yourusername/mcp-dnsdumpster.git
cd mcp-dnsdumpster
uv pip install -e .

📚 Documentation

Claude Desktop Configuration

Add the following to your Claude Desktop configuration file (~/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 Examples

Basic Usage

1. Set your API key:

export DNSDUMPSTER_API_KEY=your_api_key_here

2. Run the server:

# Use uvx (recommended)
uvx mcp-dnsdumpster

# Or if installed from source code
uv run server.py

Example Prompts

• "Show all subdomains of example.com."
• "Tell me what the mail servers of microsoft.com are."
• "Talk about the DNS infrastructure of twitter.com."

🔧 Technical Details

• Requires Python 3.10+.
• Use uv for dependency management.
• Built with MCP SDK 1.4+.

📄 License

This project is licensed under the MIT license.