Skip to main content
Glama
WolfTech DNS MCP Server

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.

Related MCP server: mailX tools

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

Available Tools

7 tools
dkim_checkA

Look up a DKIM record for a domain using a specific selector.

  • domain: The domain to check (e.g. "example.com")

  • selector: The DKIM selector (e.g. "selector1", "selector2", "google", "default")

  • dns_server: DNS server to query (default "8.8.8.8")

Inputs: domain (required), selector (required), dns_server. Returns: result

dmarc_checkA

Look up and parse the DMARC record for a domain.

  • domain: The domain to check (e.g. "example.com")

  • dns_server: DNS server to query (default "8.8.8.8")

Inputs: domain (required), dns_server. Returns: result

dns_lookupA

Look up any DNS record type for a given domain.

  • domain: The domain to query (e.g. "example.com")

  • record_type: One of: A, AAAA, MX, TXT, CNAME, NS, SOA, PTR, SRV, CAA

  • dns_server: DNS server to query (default "8.8.8.8"). Common: "1.1.1.1" (Cloudflare), "9.9.9.9" (Quad9)

Inputs: domain (required), record_type (required), dns_server. Returns: result

domain_healthA

Run a comprehensive check on a domain's email-related DNS configuration. Checks A, AAAA, NS, MX, SPF, DMARC, and provides an overall health assessment.

  • domain: The domain to check (e.g. "example.com")

  • dns_server: DNS server to query (default "8.8.8.8")

Inputs: domain (required), dns_server. Returns: result

mx_checkA

Look up MX records for a domain with priority ordering and resolved IP addresses.

  • domain: The domain to check (e.g. "example.com")

  • dns_server: DNS server to query (default "8.8.8.8")

Inputs: domain (required), dns_server. Returns: result

reverse_dnsA

Perform a reverse DNS lookup on an IP address.

  • ip_address: IPv4 or IPv6 address (e.g. "74.140.194.162")

  • dns_server: DNS server to query (default "8.8.8.8")

Inputs: ip_address (required), dns_server. Returns: result

spf_checkA

Retrieve and validate the SPF record for a domain. Checks syntax, counts DNS lookups (warns if approaching or exceeding the 10-lookup limit), and identifies common errors.

  • domain: The domain to check (e.g. "example.com")

  • dns_server: DNS server to query (default "8.8.8.8")

Inputs: domain (required), dns_server. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct DNS resource or check: generic lookup, SPF, MX, DMARC, DKIM, reverse DNS, and aggregate health. No two tools overlap in purpose.

    Naming Consistency4/5

    All names are lowercase snake_case and readable, but they mix patterns: 'dns_lookup' and 'reverse_dns' use different structures than the '_check' suffix used by most email validation tools. Minor inconsistency, still predictable.

    Tool Count5/5

    Seven tools is well-scoped for a DNS/email diagnostic server. Each tool addresses a specific need, and the count feels appropriately focused without bloat or thinness.

    Completeness5/5

    The set covers generic DNS lookups, core email authentication records (SPF, MX, DMARC, DKIM), reverse DNS, and an aggregate health check. It provides a complete read-only diagnostic workflow with no obvious gaps.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol tool that provides DNS querying capabilities for various record types (A, AAAA, MX, TXT, CNAME, NS, etc.) through a standardized MCP interface.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for email deliverability: validate SPF/DKIM/DMARC/BIMI, check blacklists, test SMTP/IMAP, look up DNS, and generate ready-to-deploy records for any major email provider. Ships with two one-click prompts (audit-deliverability, setup-dns). Public, no auth.
      17
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for IntoDNS.ai providing 36 free tools for DNS, DMARC, SPF, DKIM, BIMI, DNSSEC, MTA-STS, FCrDNS, blacklist and email security checks. Citation-grade report snapshots with content hashes. No API key required.
      45
      156 npm
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes 19 professional DNS diagnostic tools from the iDig API, enabling AI clients to perform DNS lookups, email security audits, DNSSEC validation, propagation checks, and more through natural language.
      -