`reverse_dns`

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

Find the hostname for an IP address via reverse DNS lookup. Returns the PTR record if available.

Parameters

Name	Type	Required	Description
`ip`	string	yes	IPv4 address to reverse-lookup (e.g., “8.8.8.8”)

Example call

Arguments

{
  "ip": "8.8.8.8"
}

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":"reverse_dns","arguments":{"ip":"8.8.8.8"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('reverse_dns', {
  "ip": "8.8.8.8"
});

Response shape

Always returns: ip, reverse_name, status, hostnames, primary_hostname

Field	Type	Description
`ip`	string	IPv4 address that was queried
`reverse_name`	string	Reverse DNS name in .in-addr.arpa format
`status`	string	DNS status code name (NOERROR, NXDOMAIN, etc.)
`hostnames`	array	List of hostnames found via PTR record
`primary_hostname`	string \| null	Primary hostname from first PTR record or null

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "IPv4 address that was queried"
    },
    "reverse_name": {
      "type": "string",
      "description": "Reverse DNS name in .in-addr.arpa format"
    },
    "status": {
      "type": "string",
      "description": "DNS status code name (NOERROR, NXDOMAIN, etc.)"
    },
    "hostnames": {
      "type": "array",
      "description": "List of hostnames found via PTR record",
      "items": {
        "type": "string"
      }
    },
    "primary_hostname": {
      "type": [
        "string",
        "null"
      ],
      "description": "Primary hostname from first PTR record or null"
    }
  },
  "required": [
    "ip",
    "reverse_name",
    "status",
    "hostnames",
    "primary_hostname"
  ]
}

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.

reverse_dns