`dns_lookup`

Pack: dns · Endpoint: https://gateway.pipeworx.io/dns/mcp

Look up a specific DNS record type for a domain. Specify record type (e.g., ‘A’, ‘MX’, ‘TXT’, ‘CNAME’). Returns records with TTLs and data values.

Parameters

Name	Type	Required	Description
`domain`	string	yes	Domain name to look up (e.g., “example.com”, “mail.google.com”)
`type`	string	no	DNS record type to query (e.g., “A”, “AAAA”, “MX”, “NS”, “TXT”, “CNAME”, “SOA”). Defaults to “A”.

Example call

Arguments

{
  "domain": "example.com"
}

curl

curl -X POST https://gateway.pipeworx.io/dns/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"dns_lookup","arguments":{"domain":"example.com"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('dns_lookup', {
  "domain": "example.com"
});

More examples

{
  "domain": "mail.google.com",
  "type": "MX"
}

Response shape

Always returns: domain, type, status, records, record_count

Field	Type	Description
`domain`	string	Domain name that was queried
`type`	string	DNS record type that was queried
`status`	string	DNS status code name (NOERROR, NXDOMAIN, etc.)
`records`	array	Array of DNS records found
`record_count`	number	Number of records returned

Full JSON Schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain name that was queried"
    },
    "type": {
      "type": "string",
      "description": "DNS record type that was queried"
    },
    "status": {
      "type": "string",
      "description": "DNS status code name (NOERROR, NXDOMAIN, etc.)"
    },
    "records": {
      "type": "array",
      "description": "Array of DNS records found",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Full domain name of the record"
          },
          "type": {
            "type": "string",
            "description": "DNS record type (A, AAAA, MX, etc.)"
          },
          "ttl_seconds": {
            "type": "number",
            "description": "Time-to-live in seconds"
          },
          "value": {
            "type": "string",
            "description": "Record data value"
          }
        },
        "required": [
          "name",
          "type",
          "ttl_seconds",
          "value"
        ]
      }
    },
    "record_count": {
      "type": "number",
      "description": "Number of records returned"
    }
  },
  "required": [
    "domain",
    "type",
    "status",
    "records",
    "record_count"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "dns": {
      "url": "https://gateway.pipeworx.io/dns/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

dns_lookup