`reverse_dns`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/reverse_dns for the schema, then POST the same URL with its arguments for the data.

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