@rb2b/rb2b-apis-mcp 1.1.1 → 1.1.3

package/README.md

@@ -8,6 +8,7 @@ Resolve IP addresses to companies, look up LinkedIn profiles from emails, find c
 
 ## Requirements
 
+- **An MCP-compatible AI client** — [Claude Desktop](https://claude.ai/download) or [Claude Code](https://claude.ai/code) must be installed before setting up this server
 - Node.js 18+
 - An [RB2B APIs](https://ui.api.rb2b.com) account and API key. Don't have an account? Get your first 100 credits for just $9.
 
@@ -15,19 +16,36 @@ Resolve IP addresses to companies, look up LinkedIn profiles from emails, find c
 
 ## Quick Start
 
-### 1. Initialize
+### 1. Install Claude Desktop or Claude Code
 
-Run the setup wizard to configure your API key:
+This server requires an MCP-compatible client. Install one first:
+
+- **[Claude Desktop](https://claude.ai/download)** — the Claude desktop app for macOS and Windows
+- **[Claude Code](https://claude.ai/code)** — the Claude CLI for developers
+
+### 2. Run the setup wizard
 
 ```bash
 npx @rb2b/rb2b-apis-mcp init
 ```
 
-This will prompt for your RB2B API key, validate it against the API, and store it securely in `~/.rb2b/config.json` (permissions: `600`).
+This will:
+- Prompt for your RB2B API key and validate it
+- Store it securely in `~/.rb2b/config.json` (permissions: `600`)
+- Automatically register the server with Claude Code and Claude Desktop if detected
+
+That's it. No manual config editing needed in most cases.
+
+### Manual registration (if needed)
 
-### 2. Add to Claude Desktop
+If auto-registration didn't run or you're using a different MCP client:
 
-Edit your Claude Desktop config file:
+**Claude Code:**
+```bash
+claude mcp add rb2b -- npx @rb2b/rb2b-apis-mcp
+```
+
+**Claude Desktop** — edit your config file:
 
 - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
@@ -45,12 +63,6 @@ Edit your Claude Desktop config file:
 
 Restart Claude Desktop after saving.
 
-### 3. Add to Claude Code
-
-```bash
-claude mcp add rb2b -- npx @rb2b/rb2b-apis-mcp
-```
-
 ---
 
 ## Tools

package/dist/init.js

@@ -1,10 +1,61 @@
 #!/usr/bin/env node
 import { createInterface } from "readline";
+import { spawnSync } from "child_process";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { homedir, platform } from "os";
+import { join } from "path";
 import { BASE_URL, loadConfig, saveConfig } from "./config.js";
 const rl = createInterface({ input: process.stdin, output: process.stdout });
 function prompt(question) {
     return new Promise((resolve) => rl.question(question, resolve));
 }
+function registerClaudeCode() {
+    // Check if the claude CLI is available.
+    const check = spawnSync("claude", ["mcp", "list"], { encoding: "utf-8" });
+    if (check.error || check.status !== 0)
+        return;
+    // Skip if already registered.
+    if (check.stdout?.includes("rb2b")) {
+        console.log("Claude Code: already registered.");
+        return;
+    }
+    const result = spawnSync("claude", ["mcp", "add", "rb2b", "--", "npx", "@rb2b/rb2b-apis-mcp"], { encoding: "utf-8" });
+    if (result.error || result.status !== 0) {
+        console.log("Claude Code: could not auto-register. Run manually:");
+        console.log("  claude mcp add rb2b -- npx @rb2b/rb2b-apis-mcp");
+    }
+    else {
+        console.log("Claude Code: registered successfully.");
+    }
+}
+function registerClaudeDesktop() {
+    const configPath = platform() === "win32"
+        ? join(process.env.APPDATA ?? homedir(), "Claude", "claude_desktop_config.json")
+        : join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    if (!existsSync(configPath))
+        return;
+    let config = {};
+    try {
+        config = JSON.parse(readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return;
+    }
+    const mcpServers = (config.mcpServers ?? {});
+    if (mcpServers.rb2b) {
+        console.log("Claude Desktop: already registered.");
+        return;
+    }
+    mcpServers.rb2b = { command: "npx", args: ["@rb2b/rb2b-apis-mcp"] };
+    config.mcpServers = mcpServers;
+    try {
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        console.log("Claude Desktop: registered successfully. Restart Claude Desktop to apply.");
+    }
+    catch {
+        console.log("Claude Desktop: could not auto-register. Add manually to:", configPath);
+    }
+}
 async function main() {
     const existing = loadConfig();
     if (existing) {
@@ -16,15 +67,23 @@ async function main() {
         console.log("RB2B MCP Server — Initial Setup");
         console.log("=================================\n");
     }
-    const apiKey = await prompt("Enter your RB2B API key: ");
-    if (!apiKey.trim()) {
+    const input = await prompt(existing
+        ? "Enter a new RB2B API key (or press Enter to keep the existing one): "
+        : "Enter your RB2B API key: ");
+    if (!input.trim()) {
+        if (existing) {
+            console.log("\nKeeping existing API key. No changes made.");
+            rl.close();
+            process.exit(0);
+        }
         console.error("Error: API key cannot be empty.");
         process.exit(1);
     }
+    const apiKey = input.trim();
     console.log("\nValidating API key...");
     try {
         const res = await fetch(`${BASE_URL}/credits`, {
-            headers: { "Api-Key": apiKey.trim() },
+            headers: { "Api-Key": apiKey },
         });
         if (!res.ok) {
             const text = await res.text().catch(() => res.statusText);
@@ -34,17 +93,11 @@ async function main() {
         const data = await res.json();
         console.log("\nAPI key valid!");
         console.log("Credits info:", JSON.stringify(data, null, 2));
-        saveConfig({ apiKey: apiKey.trim() });
+        saveConfig({ apiKey });
         console.log("\nConfiguration saved to ~/.rb2b/config.json");
-        console.log("\nYou can now add the MCP server to your Claude config:\n");
-        console.log(JSON.stringify({
-            mcpServers: {
-                rb2b: {
-                    command: "npx",
-                    args: ["@rb2b/rb2b-apis-mcp"],
-                },
-            },
-        }, null, 2));
+        console.log("\nRegistering with MCP clients...");
+        registerClaudeCode();
+        registerClaudeDesktop();
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rb2b/rb2b-apis-mcp",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "MCP server exposing RB2B API tools for identity resolution and enrichment",
   "type": "module",
   "main": "dist/server.js",