mcp-dnsdumpster

DNSDumpster MCP Server provides an interface to query DNS records and related information via the MCP protocol. It exposes DNS data such as A, CNAME, MX, TXT, and NS records, along with banner information when available, and supports pagination for Plus accounts along with rate limiting and caching to optimize queries. To use it, first obtain an API key for DNSDumpster and configure it in the environment so the MCP server can authenticate with the external service. Once running, you can interact with the server through your MCP-enabled assistant by asking natural language questions like: 'Show me all subdomains for example.com' or 'What are the mail servers for example.com?'. The server translates these requests into DNSDumpster API calls and returns structured results that your assistant can present to users.

Prerequisites:

• Python 3.10+
• pip (Python package installer)
• uv (dependency and environment management for Python) installed via the project's workflow

Installation steps (preferred method – from PyPI):

1. Install via uv from PyPI:

   uv pip install mcp-dnsdumpster

2. Run the server using uvx (recommended) if you have the CLI installed:

   uvx mcp-dnsdumpster

Alternative: install from source

1. Clone the repository:

   git clone https://github.com/yourusername/mcp-dnsdumpster.git cd mcp-dnsdumpster

2. Install in editable mode:

   uv pip install -e .

3. Run the server (from source) using uv:

   uv run server.py

Notes:

• Ensure you have a DNSDumpster API key and set it in the environment before starting the server.
• The server expects the DNSDumpster API to be accessible and may rate-limit requests depending on your account.

Tips and common considerations:

• Environment variable: DNSDUMPSTER_API_KEY must be set to a valid DNSDumpster API key for the MCP server to function.
• When configuring in Claude Desktop or similar clients, include the env key alongside the command to ensure the key is available to the process.
• The server supports pagination for Plus accounts; ensure you handle multi-page results in your UI if your prompts request large datasets.
• If you encounter authentication or network issues, verify the API key scope and network access to the DNSDumpster API, and check for rate limiting in your client.
• You can customize how results are displayed by shaping the MCP SDK responses within your agent or UI layer; the MCP server returns structured data suitable for downstream formatting.