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)
  • 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

  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"
  • "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

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.2.tar.gz (19.1 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.2-py3-none-any.whl (22.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mcp_dnsdumpster-0.1.2.tar.gz
Algorithm Hash digest
SHA256 a4383a01ee0581e623d39f08fd1e870e02b0a8ecc7b233595dd902771b207493
MD5 dc790e244e58a380a2ae9a359e89a149
BLAKE2b-256 0fcb7a8e2a99dc8046b7aeb85c96c3832b9cd3ac78eb760c89eea273088124a6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_dnsdumpster-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 7ef28999581521f02ceb398f372fd75dbdd1daa6d8cb12317eb6c21e54dd061c
MD5 b47462059f4362bddc783004b8b96827
BLAKE2b-256 a84decfaf18abaac8aa28d2f60efb5d874dbee35d976a1f0390aabfdd24fb23c

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