Skip to main content

DNSDumpster MCP Server for querying DNS information

Project description

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

PyPI version

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

  1. Set your API key:
export DNSDUMPSTER_API_KEY=your_api_key_here
  1. 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_dnsdumpster-0.1.3.tar.gz (18.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_dnsdumpster-0.1.3-py3-none-any.whl (22.1 kB view details)

Uploaded Python 3

File details

Details for the file mcp_dnsdumpster-0.1.3.tar.gz.

File metadata

  • Download URL: mcp_dnsdumpster-0.1.3.tar.gz
  • Upload date:
  • Size: 18.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.5

File hashes

Hashes for mcp_dnsdumpster-0.1.3.tar.gz
Algorithm Hash digest
SHA256 0f58adb6f4f911f913031fceb02a5318a7ade97181462a57b8ee3b30d0f55e03
MD5 d279df12e5202a026398ff91f6758449
BLAKE2b-256 bdcb0eb7f2a6ea1cc11dda5831d7b38942e81d4c5b56d545ade3451ea1fd482a

See more details on using hashes here.

File details

Details for the file mcp_dnsdumpster-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_dnsdumpster-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5fe476a1b95200199075b9a15e02307de249fee3df7f67f89208218a60f4a740
MD5 94735c8fca95307f9f99c97ac4729a2c
BLAKE2b-256 7ea4d5b7677afc2ce6cf45a42c476395d27813ad2dd90deaf9044ed5876be0db

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page