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