@cyanheads/whois-mcp-server 0.1.1

package/dist/services/rdap/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @fileoverview RDAP service domain types — raw upstream shapes and normalized outputs.
+ * @module services/rdap/types
+ */
+/** vCard array as returned by RDAP (RFC 6350 format) */
+export type VCard = [string, unknown][];
+/** Raw RDAP entity object */
+export interface RdapEntity {
+    entities?: RdapEntity[];
+    handle?: string;
+    objectClassName?: string;
+    publicIds?: Array<{
+        type: string;
+        identifier: string;
+    }>;
+    roles?: string[];
+    vcardArray?: ['vcard', VCard];
+}
+/** Raw RDAP event object */
+export interface RdapEvent {
+    eventAction: string;
+    eventDate: string;
+}
+/** Raw RDAP nameserver object */
+export interface RdapNameserver {
+    ldhName?: string;
+    unicodeName?: string;
+}
+/** Raw RDAP link object */
+export interface RdapLink {
+    href?: string;
+    rel?: string;
+    type?: string;
+}
+/** Raw RDAP domain response */
+export interface RdapDomainRaw {
+    entities?: RdapEntity[];
+    events?: RdapEvent[];
+    handle?: string;
+    ldhName?: string;
+    links?: RdapLink[];
+    nameservers?: RdapNameserver[];
+    objectClassName?: string;
+    port43?: string;
+    remarks?: Array<{
+        description: string[];
+    }>;
+    secureDNS?: {
+        delegationSigned?: boolean;
+        zoneSigned?: boolean;
+    };
+    status?: string[];
+    unicodeName?: string;
+}
+/** Raw RDAP IP network response */
+export interface RdapIpNetworkRaw {
+    cidr0_cidrs?: Array<{
+        v4prefix?: string;
+        v6prefix?: string;
+        length?: number;
+    }>;
+    country?: string;
+    endAddress?: string;
+    entities?: RdapEntity[];
+    events?: RdapEvent[];
+    handle?: string;
+    ipVersion?: string;
+    links?: RdapLink[];
+    name?: string;
+    objectClassName?: string;
+    parentHandle?: string;
+    startAddress?: string;
+    type?: string;
+}
+/** Raw RDAP autnum (ASN) response */
+export interface RdapAutnumRaw {
+    country?: string;
+    endAutnum?: number;
+    entities?: RdapEntity[];
+    events?: RdapEvent[];
+    handle?: string;
+    links?: RdapLink[];
+    name?: string;
+    objectClassName?: string;
+    startAutnum?: number;
+    type?: string;
+}
+/** IANA Bootstrap JSON format */
+export interface IanaBootstrap {
+    publication: string;
+    services: Array<[string[], string[]]>;
+    version: string;
+}
+/** Normalized domain registration record */
+export interface NormalizedDomain {
+    created_date?: string;
+    dnssec_signed: boolean;
+    domain: string;
+    expiry_date?: string;
+    handle?: string;
+    nameservers: string[];
+    rdap_coverage: boolean;
+    rdap_last_updated?: string;
+    registrant_org?: string;
+    registrant_redacted: boolean;
+    registrar?: string;
+    registrar_iana_id?: string;
+    status: string[];
+    updated_date?: string;
+}
+/** Normalized IP network record */
+export interface NormalizedIpNetwork {
+    abuse_email?: string;
+    cidr?: string;
+    country?: string;
+    end_address?: string;
+    handle?: string;
+    ip: string;
+    ip_version?: string;
+    name?: string;
+    org_name?: string;
+    /** Reverse DNS hostname, null when PTR lookup fails or returns nothing. */
+    ptr: string | null;
+    rdap_source?: string;
+    start_address?: string;
+    type?: string;
+}
+/** Normalized ASN record */
+export interface NormalizedAsn {
+    asn: string;
+    country?: string;
+    end_autnum?: number;
+    handle?: string;
+    name?: string;
+    org_name?: string;
+    rir?: string;
+    start_autnum?: number;
+    type?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/rdap/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/rdap/types.ts"],"names":[],"mappings":"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"}

package/dist/services/rdap/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview RDAP service domain types — raw upstream shapes and normalized outputs.
+ * @module services/rdap/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/rdap/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/rdap/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@cyanheads/whois-mcp-server",
+  "version": "0.1.1",
+  "mcpName": "io.github.cyanheads/whois-mcp-server",
+  "description": "Look up domain registration, check availability, fetch DNS records, and resolve IPs and ASNs via RDAP and DNS-over-HTTPS via MCP. STDIO or Streamable HTTP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "whois-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write .",
+    "format:unsafe": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/whois-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "release:github": "bun run scripts/release-github.ts",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "whois",
+    "rdap",
+    "dns",
+    "domain",
+    "ip",
+    "asn",
+    "dns-over-https",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "typescript",
+    "bun",
+    "stdio",
+    "streamable-http",
+    "ai-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/whois-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cyanheads/whois-mcp-server/issues"
+  },
+  "homepage": "https://github.com/cyanheads/whois-mcp-server#readme",
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/whois-mcp-server#readme)",
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/cyanheads"
+    },
+    {
+      "type": "buy_me_a_coffee",
+      "url": "https://www.buymeacoffee.com/cyanheads"
+    }
+  ],
+  "license": "Apache-2.0",
+  "packageManager": "bun@1.3.11",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.9.21",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@types/node": "^25.9.1",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}

package/server.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/whois-mcp-server",
+  "description": "Domain registration, availability, DNS records, and IP/ASN resolution via RDAP and DNS-over-HTTPS.",
+  "repository": {
+    "url": "https://github.com/cyanheads/whois-mcp-server",
+    "source": "github"
+  },
+  "version": "0.1.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/whois-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.1",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:stdio"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        },
+        {
+          "name": "RDAP_TIMEOUT_MS",
+          "description": "HTTP timeout for RDAP requests in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "5000"
+        },
+        {
+          "name": "DOH_TIMEOUT_MS",
+          "description": "HTTP timeout for DNS-over-HTTPS requests in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3000"
+        },
+        {
+          "name": "RDAP_MAX_RETRIES",
+          "description": "Max retry attempts on transient RDAP failures.",
+          "format": "string",
+          "isRequired": false,
+          "default": "2"
+        },
+        {
+          "name": "DOH_MAX_RETRIES",
+          "description": "Max retry attempts on transient DNS-over-HTTPS failures.",
+          "format": "string",
+          "isRequired": false,
+          "default": "2"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/whois-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.1",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:http"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_PUBLIC_URL",
+          "description": "Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).",
+          "format": "string",
+          "isRequired": false
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        },
+        {
+          "name": "RDAP_TIMEOUT_MS",
+          "description": "HTTP timeout for RDAP requests in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "5000"
+        },
+        {
+          "name": "DOH_TIMEOUT_MS",
+          "description": "HTTP timeout for DNS-over-HTTPS requests in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3000"
+        },
+        {
+          "name": "RDAP_MAX_RETRIES",
+          "description": "Max retry attempts on transient RDAP failures.",
+          "format": "string",
+          "isRequired": false,
+          "default": "2"
+        },
+        {
+          "name": "DOH_MAX_RETRIES",
+          "description": "Max retry attempts on transient DNS-over-HTTPS failures.",
+          "format": "string",
+          "isRequired": false,
+          "default": "2"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}