WolfTech DNS MCP Server

WolfTech DNS MCP Server

An MCP (Model Context Protocol) server that provides DNS lookup and email authentication diagnostic tools. Built for use with Claude Desktop, Claude Code, and any MCP-compatible client.

Tools

| Tool | Description | |------|-------------| | dns_lookup | Look up any DNS record type (A, AAAA, MX, TXT, CNAME, NS, SOA, PTR, SRV, CAA) | | spf_check | Retrieve and validate SPF records with recursive DNS lookup counting (10-lookup limit) | | mx_check | List MX records with priority ordering and resolved IP addresses | | dmarc_check | Parse DMARC records (policy, alignment, reporting addresses) | | dkim_check | Look up DKIM records by selector (handles CNAME delegation) | | reverse_dns | PTR lookup with forward/reverse consistency verification | | domain_health | Comprehensive email DNS audit with health score (A, AAAA, NS, MX, SPF, DMARC) |

All tools accept an optional dns_server parameter (default 8.8.8.8) for querying specific resolvers or checking propagation.

Requirements

• Python 3.13+
• uv

Installation

Claude Code

Add to .claude/.mcp.json:

{
  "mcpServers": {
    "wolftech-dns": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/wolftech-dns-mcp",
        "--with", "fastmcp",
        "--with", "dnspython",
        "fastmcp", "run",
        "/path/to/wolftech-dns-mcp/server.py"
      ]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "wolftech-dns": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/wolftech-dns-mcp",
        "--with", "fastmcp",
        "--with", "dnspython",
        "fastmcp", "run",
        "/path/to/wolftech-dns-mcp/server.py"
      ]
    }
  }
}

Replace /path/to/wolftech-dns-mcp with the actual path to the cloned repository.

Usage Examples

Once configured, the tools are available to Claude as MCP tools:

• "Look up the A records for example.com" - uses dns_lookup
• "Check the SPF record for mydomain.com" - uses spf_check
• "Run a full email DNS health check on mydomain.com" - uses domain_health
• "Check if selector1 DKIM is set up for mydomain.com" - uses dkim_check
• "Do a reverse DNS lookup on 74.140.194.162" - uses reverse_dns
• "Check MX records for mydomain.com using Cloudflare DNS" - uses mx_check with dns_server: "1.1.1.1"

Stack

• FastMCP - MCP server framework
• dnspython - DNS toolkit for Python
• Transport: stdio