@robotdomainsearch/mcp 0.1.0

package/README.md

@@ -0,0 +1,95 @@
+# @robotdomainsearch/mcp
+
+[RobotDomainSearch](https://robotdomainsearch.com) MCP Server — domain intelligence for AI agents.
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI applications (Claude Desktop, Cursor, Windsurf, etc.) access to domain name tools: availability checks, WHOIS lookups, DNS intelligence, aftermarket listings, ENS resolution, and more.
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "robotdomainsearch": {
+      "command": "npx",
+      "args": ["-y", "@robotdomainsearch/mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to your Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "robotdomainsearch": {
+      "command": "npx",
+      "args": ["-y", "@robotdomainsearch/mcp"]
+    }
+  }
+}
+```
+
+### Global Install
+
+```bash
+npm install -g @robotdomainsearch/mcp
+```
+
+Then run directly:
+
+```bash
+robotdomainsearch-mcp
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `check_domain` | Check domain name availability via RDAP |
+| `whois_lookup` | Full WHOIS/RDAP information for a domain |
+| `domain_intel` | Comprehensive domain intelligence report |
+| `search_aftermarket` | Search aftermarket domain listings |
+| `search_auctions` | Search live domain auctions |
+| `resolve_ens` | Resolve ENS (.eth) names to addresses |
+| `list_tlds` | Browse available TLDs by category |
+| `check_presence` | Check name availability across platforms |
+
+## How It Works
+
+This npm package wraps a prebuilt Go binary. During `npm install`, the correct binary for your platform is downloaded from [GitHub Releases](https://github.com/erickuhn19/RobotDomainSearch-API/releases).
+
+### Supported Platforms
+
+| OS | Architecture |
+|----|-------------|
+| macOS | Apple Silicon (arm64) |
+| macOS | Intel (x64) |
+| Linux | arm64 |
+| Linux | x64 |
+
+## Configuration
+
+The MCP server connects to the public RobotDomainSearch API by default. No API key required.
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `RDS_API_URL` | `https://api.robotdomainsearch.com` | API base URL |
+| `RDS_ENS_URL` | `https://ens.robotdomainsearch.com` | ENS service URL |
+
+## Links
+
+- **Website:** [robotdomainsearch.com](https://robotdomainsearch.com)
+- **MCP Page:** [robotdomainsearch.com/mcp](https://robotdomainsearch.com/mcp/)
+- **API Docs:** [robotdomainsearch.com/docs](https://robotdomainsearch.com/docs/)
+- **GitHub:** [erickuhn19/RobotDomainSearch-API](https://github.com/erickuhn19/RobotDomainSearch-API)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+// Thin wrapper that spawns the Go-built MCP server binary.
+// The binary is downloaded during `npm install` by install.js.
+
+const { spawn } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const binName =
+  process.platform === "win32"
+    ? "robotdomainsearch-mcp.exe"
+    : "robotdomainsearch-mcp";
+const binPath = path.join(__dirname, "bin", binName);
+
+if (!fs.existsSync(binPath)) {
+  console.error(
+    "Error: robotdomainsearch-mcp binary not found at",
+    binPath,
+    "\nRun `npm install` or `node install.js` to download it."
+  );
+  process.exit(1);
+}
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("error", (err) => {
+  console.error("Failed to start robotdomainsearch-mcp:", err.message);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    // Remove our listeners so the re-raised signal triggers default
+    // termination behavior instead of re-entering the handler.
+    for (const s of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+      process.removeAllListeners(s);
+    }
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});
+
+// Forward termination signals to the child process
+for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(sig, () => child.kill(sig));
+}

package/install.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+// postinstall script — downloads the correct platform-specific Go binary
+// from GitHub Releases and places it in ./bin/
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const REPO = "erickuhn19/RobotDomainSearch-API";
+const BIN_DIR = path.join(__dirname, "bin");
+const BIN_NAME = "robotdomainsearch-mcp";
+
+// Map Node.js platform/arch to Go build target names
+const PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+};
+
+const ARCH_MAP = {
+  arm64: "arm64",
+  x64: "amd64",
+};
+
+function getPlatformKey() {
+  const platform = PLATFORM_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+
+  if (!platform || !arch) {
+    console.error(
+      `Unsupported platform: ${process.platform}/${process.arch}\n` +
+        "Supported: macOS (arm64, x64), Linux (arm64, x64)"
+    );
+    process.exit(1);
+  }
+
+  return `${platform}_${arch}`;
+}
+
+function getVersion() {
+  const pkg = JSON.parse(
+    fs.readFileSync(path.join(__dirname, "package.json"), "utf8")
+  );
+  return pkg.version;
+}
+
+function httpsGet(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { "User-Agent": "robotdomainsearch-mcp-npm" } }, (res) => {
+        // Follow redirects
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          return httpsGet(res.headers.location).then(resolve, reject);
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+          res.resume();
+          return;
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+        res.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function main() {
+  const platformKey = getPlatformKey();
+  const version = getVersion();
+  const tag = `mcp-v${version}`;
+
+  // Binary archive name matches the GitHub Release asset pattern
+  const archiveName = `robotdomainsearch-mcp_${platformKey}.tar.gz`;
+  const downloadUrl = `https://github.com/${REPO}/releases/download/${tag}/${archiveName}`;
+
+  console.log(`Downloading ${BIN_NAME} ${version} for ${platformKey}...`);
+  console.log(`URL: ${downloadUrl}`);
+
+  // Ensure bin directory exists
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+
+  const archivePath = path.join(BIN_DIR, archiveName);
+
+  try {
+    const data = await httpsGet(downloadUrl);
+    fs.writeFileSync(archivePath, data);
+
+    // Extract the binary from the tarball
+    execSync(`tar -xzf "${archiveName}" -C .`, { cwd: BIN_DIR });
+
+    // Clean up archive
+    fs.unlinkSync(archivePath);
+
+    // Make binary executable
+    const binPath = path.join(BIN_DIR, BIN_NAME);
+    if (fs.existsSync(binPath)) {
+      fs.chmodSync(binPath, 0o755);
+      console.log(`✓ Installed ${BIN_NAME} to ${binPath}`);
+    } else {
+      throw new Error(`Binary not found after extraction at ${binPath}`);
+    }
+  } catch (err) {
+    console.error(`\nFailed to download ${BIN_NAME}:\n  ${err.message}`);
+    console.error(
+      `\nThis may mean the release "${tag}" hasn't been published yet.` +
+        "\nYou can build from source: go build -o cmd/mcp/npm/bin/robotdomainsearch-mcp ./cmd/mcp/"
+    );
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@robotdomainsearch/mcp",
+  "version": "0.1.0",
+  "description": "RobotDomainSearch MCP Server — domain intelligence for AI agents",
+  "bin": {
+    "robotdomainsearch-mcp": "./index.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "domain",
+    "whois",
+    "dns",
+    "rdap",
+    "ai",
+    "robotdomainsearch",
+    "claude",
+    "cursor"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/erickuhn19/RobotDomainSearch-API"
+  },
+  "homepage": "https://robotdomainsearch.com/mcp/",
+  "bugs": {
+    "url": "https://github.com/erickuhn19/RobotDomainSearch-API/issues"
+  },
+  "files": [
+    "index.js",
+    "install.js",
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ]
+}