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.1.tar.gz (19.0 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.1-py3-none-any.whl (22.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mcp_dnsdumpster-0.1.1.tar.gz
Algorithm Hash digest
SHA256 1162567a19c572ff5e88e357ef3ba110e4a1c24ef67faab50bb984e224db5d8e
MD5 95dc26763d3512010d9626d6a6f2c4e8
BLAKE2b-256 a59c6cfd7675098eadd6c0409d2fed8ce51c8503e95a44326376673c4c5975fa

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_dnsdumpster-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b923a4e39bcefee5b94023dcc4424e331c84c3a8794dff28cf2bd77650e9bde9
MD5 3351f5d6506e9a81935ec04660cd0588
BLAKE2b-256 46dc8098ac0265996e61f6860c31e3df2854fe6ad628549a9ef72af4dfcc7858

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