# WhoisFreaks — Pipedream Connect

> Best Source For Domain WHOIS Database and API.

- API slug: `whoisfreaks` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Developer Tools
- Website: https://whoisfreaks.com/
- This page (HTML): https://pipedream.com/apps/whoisfreaks
- Tools: 13 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: whoisfreaks`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "whoisfreaks",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Bulk DNS Domain Lookup:
const result = await mcp.callTool({
  name: "whoisfreaks-bulk-dns-domain-lookup",
  arguments: {
    domainNames: ["Domain Names"],
    ipAddresses: ["IP Addresses"],
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a WhoisFreaks endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.whoisfreaks.com/v1.0/whois

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkud2hvaXNmcmVha3MuY29tL3YxLjAvd2hvaXM?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "whoisfreaks-bulk-dns-domain-lookup",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    whoisfreaks: { authProvisionId: "apn_xxxxxxx" },
    domainNames: ["Domain Names"],
    ipAddresses: ["IP Addresses"],
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (13)

### `whoisfreaks-bulk-dns-domain-lookup` — Bulk DNS Domain Lookup (Read-only)

Retrieve DNS records (A, AAAA, MX, NS, CNAME, TXT, PTR, SPF, DKIM, DMARC, SRV, SOA) for up to 100 domains or IP addresses in a single request. Use this action for bulk DNS auditing, infrastructure mapping, or automated monitoring. Accepts domain names and/or IP addresses; returns JSON or XML…

Full schema: https://pipedream.com/apps/whoisfreaks/actions/bulk-dns-domain-lookup.md

### `whoisfreaks-bulk-ip-geolocation-lookup` — Bulk IP Geolocation Lookup (Read-only)

Retrieve geolocation details (country, city, ASN, ISP, coordinates) for up to 100 IP addresses in a single request. Accepts comma-separated IPv4 or IPv6 addresses and returns JSON or XML output. Use this action for bulk network analysis, fraud detection, or audience geo-enrichment. See the…

Full schema: https://pipedream.com/apps/whoisfreaks/actions/bulk-ip-geolocation-lookup.md

### `whoisfreaks-bulk-ip-reputation-lookup` — Bulk IP Reputation Lookup (Read-only)

Score up to 100 IPv4 or IPv6 addresses against real-time threat data in a single request. Returns composite threat score, VPN/proxy/Tor/bot classification, blacklist status, and ASN/ISP details for each IP. Accepts comma-separated IP addresses; returns JSON or XML output. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/bulk-ip-reputation-lookup.md

### `whoisfreaks-bulk-whois-lookup` — Bulk Whois Lookup (Read-only)

Retrieve WHOIS registration data (registrant, registrar, name servers, email, phone, address, ASN, history) for up to 100 domains in a single request. Accepts comma-separated domain names across 1000+ TLDs; returns JSON or XML output. Use this action for bulk domain research, lead enrichment, or…

Full schema: https://pipedream.com/apps/whoisfreaks/actions/bulk-whois-lookup.md

### `whoisfreaks-domain-availability-lookup` — Domain Availability Lookup (Read-only)

Check if a domain name is available for registration. For example you can check whoisfreaks.com. This action supports responses in both JSON and XML format. Always use sug=false to get the response. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/domain-availability-lookup.md

### `whoisfreaks-domain-lookup` — Domain Lookup (Read-only)

Retrieve details about a domain name. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/domain-lookup.md

### `whoisfreaks-domain-reputation-lookup` — Domain Reputation Lookup (Read-only)

Check the reputation and security status of a domain — including whether it is associated with malware, phishing campaigns, or other malicious activity. Use this action for threat intelligence workflows, email security checks, or domain risk scoring. Returns JSON output. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/domain-reputation-lookup.md

### `whoisfreaks-ip-geolocation-lookup` — IP Geolocation Lookup (Read-only)

Retrieve geolocation details (country, city, region, ASN, ISP, coordinates) for a single IP address. Supports both IPv4 and IPv6 addresses. Use this action to enrich events with location data, perform fraud detection, or geo-target users. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/ip-geolocation-lookup.md

### `whoisfreaks-ip-lookup` — IP Lookup (Read-only)

Retrieve information about an IP address. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/ip-lookup.md

### `whoisfreaks-ip-reputation-lookup` — IP Reputation Lookup (Read-only)

Score a single IPv4 or IPv6 address against real-time threat data. Returns a composite threat score (0-100), VPN/proxy/Tor/bot classification, provider names with confidence scores, district-level geolocation, and ASN/ISP details. Use this action for threat intelligence, access control, or fraud…

Full schema: https://pipedream.com/apps/whoisfreaks/actions/ip-reputation-lookup.md

### `whoisfreaks-reverse-lookup` — Reverse Lookup (Read-only)

Retrieve details about a domain by keyword, email, registrant name or company. Must enter one and only one of keyword, email, owner, or company. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/reverse-lookup.md

### `whoisfreaks-ssl-lookup` — SSL Lookup (Read-only)

Retrieve details about a domain's SSL certificate (e.g. google.com). Note that this action accepts JSON or XML format values, always requests the full certificate chain (chain=true), and suppresses the raw OpenSSL response (sslRaw=false) for cleaner outputs. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/ssl-lookup.md

### `whoisfreaks-sub-domain-lookup` — Subdomain Lookup (Read-only)

Discover subdomains for a given domain using passive DNS data from 6.3B+ indexed hostnames. Returns active, inactive, and historical subdomain records. Use this action for attack surface mapping, security audits, or competitor research. Returns JSON or XML output. See the documentation

Full schema: https://pipedream.com/apps/whoisfreaks/actions/sub-domain-lookup.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt