@brightdata/cli 0.1.3 → 0.1.4

package/README.md

@@ -11,7 +11,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/%40brightdata%2Fcli"><img src="https://img.shields.io/npm/v/%40brightdata%2Fcli?color=black&label=npm" alt="npm version" /></a>
   <img src="https://img.shields.io/badge/node-%3E%3D20-black" alt="node requirement" />
-  <img src="https://img.shields.io/badge/license-ISC-black" alt="license" />
+  <img src="https://img.shields.io/badge/license-MIT-black" alt="license" />
 </p>
 
 ---
@@ -28,6 +28,7 @@
 | `brightdata zones` | List and inspect your Bright Data proxy zones |
 | `brightdata budget` | View account balance and per-zone cost & bandwidth |
 | `brightdata skill` | Install Bright Data AI agent skills into your coding agent |
+| `brightdata add mcp` | Add the Bright Data MCP server to Claude Code, Cursor, or Codex |
 | `brightdata config` | Manage CLI configuration |
 | `brightdata init` | Interactive setup wizard |
 
@@ -47,6 +48,7 @@
   - [zones](#zones)
   - [budget](#budget)
   - [skill](#skill)
+  - [add mcp](#add-mcp)
   - [config](#config)
   - [login / logout](#login--logout)
 - [Configuration](#configuration)
@@ -105,6 +107,9 @@ brightdata pipelines linkedin_person_profile "https://linkedin.com/in/username"
 
 # 5. Check your account balance
 brightdata budget
+
+# 6. Install the Bright Data MCP server into your coding agent
+brightdata add mcp
 ```
 
 ---
@@ -131,6 +136,8 @@ On first login the CLI checks for required zones (`cli_unlocker`, `cli_browser`)
 brightdata logout
 ```
 
+`brightdata add mcp` uses the API key stored by `brightdata login`. It does not currently read `BRIGHTDATA_API_KEY` or the global `--api-key` flag, so log in first before using it.
+
 ---
 
 ## Commands
@@ -397,6 +404,54 @@ brightdata skill list
 
 ---
 
+### `add mcp`
+
+Write a Bright Data MCP server entry into Claude Code, Cursor, or Codex config files using the API key already stored by `brightdata login`.
+
+```bash
+brightdata add mcp                               # Interactive agent + scope prompts
+brightdata add mcp --agent claude-code --global
+brightdata add mcp --agent claude-code,cursor --project
+brightdata add mcp --agent codex --global
+```
+
+| Flag | Description |
+|---|---|
+| `--agent <agents>` | Comma-separated targets: `claude-code,cursor,codex` |
+| `--global` | Install to the agent's global config file |
+| `--project` | Install to the current project's config file |
+
+**Config targets**
+
+| Agent | Global path | Project path |
+|---|---|---|
+| Claude Code | `~/.claude.json` | `.claude/settings.json` |
+| Cursor | `~/.cursor/mcp.json` | `.cursor/mcp.json` |
+| Codex | `$CODEX_HOME/mcp.json` or `~/.codex/mcp.json` | Not supported |
+
+The command writes the MCP server under `mcpServers["bright-data"]`:
+
+```json
+{
+  "mcpServers": {
+    "bright-data": {
+      "command": "npx",
+      "args": ["@brightdata/mcp"],
+      "env": {
+        "API_TOKEN": "<stored-api-key>"
+      }
+    }
+  }
+}
+```
+
+Behavior notes:
+- Existing config is preserved; only `mcpServers["bright-data"]` is added or replaced.
+- If the target config contains invalid JSON, the CLI warns and offers to overwrite it in interactive mode.
+- In non-interactive mode, pass both `--agent` and the appropriate scope flag to skip prompts.
+
+---
+
 ### `config`
 
 View and manage CLI configuration.

package/dist/__tests__/commands/add-mcp.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=add-mcp.test.d.ts.map

package/dist/__tests__/commands/add-mcp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-mcp.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/commands/add-mcp.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/commands/add-mcp.test.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const vitest_1 = require("vitest");
+const mocks = vitest_1.vi.hoisted(() => ({
+    checkbox: vitest_1.vi.fn(),
+    select: vitest_1.vi.fn(),
+    confirm: vitest_1.vi.fn(),
+    get_api_key: vitest_1.vi.fn(),
+    dim: vitest_1.vi.fn((msg) => msg),
+    green: vitest_1.vi.fn((msg) => msg),
+    red: vitest_1.vi.fn((msg) => msg),
+    warn: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock('@inquirer/prompts', () => ({
+    checkbox: mocks.checkbox,
+    select: mocks.select,
+    confirm: mocks.confirm,
+}));
+vitest_1.vi.mock('../../utils/credentials', () => ({
+    get_api_key: mocks.get_api_key,
+}));
+vitest_1.vi.mock('../../utils/output', () => ({
+    dim: mocks.dim,
+    green: mocks.green,
+    red: mocks.red,
+    warn: mocks.warn,
+}));
+const add_mcp_1 = require("../../commands/add-mcp");
+const get_expected_entry = (api_key) => ({
+    command: 'npx',
+    args: ['@brightdata/mcp'],
+    env: {
+        API_TOKEN: api_key,
+    },
+});
+const mk_tmp_dir = () => fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'brightdata-add-mcp-'));
+const read_json = (file_path) => JSON.parse(fs_1.default.readFileSync(file_path, 'utf8'));
+(0, vitest_1.describe)('commands/add-mcp', () => {
+    let tmp_dir = '';
+    let home_dir = '';
+    let project_dir = '';
+    let codex_home = '';
+    let original_cwd = '';
+    let stdin_tty;
+    let stdout_tty;
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+        tmp_dir = mk_tmp_dir();
+        home_dir = path_1.default.join(tmp_dir, 'home');
+        project_dir = path_1.default.join(tmp_dir, 'project');
+        codex_home = path_1.default.join(tmp_dir, 'codex-home');
+        original_cwd = process.cwd();
+        stdin_tty = Object.getOwnPropertyDescriptor(process.stdin, 'isTTY');
+        stdout_tty = Object.getOwnPropertyDescriptor(process.stdout, 'isTTY');
+        fs_1.default.mkdirSync(home_dir, { recursive: true });
+        fs_1.default.mkdirSync(project_dir, { recursive: true });
+        process.chdir(project_dir);
+        process.env['CODEX_HOME'] = codex_home;
+        vitest_1.vi.spyOn(os_1.default, 'homedir').mockReturnValue(home_dir);
+        Object.defineProperty(process.stdin, 'isTTY', {
+            value: true,
+            configurable: true,
+        });
+        Object.defineProperty(process.stdout, 'isTTY', {
+            value: true,
+            configurable: true,
+        });
+        mocks.get_api_key.mockReturnValue('test_api_key');
+        mocks.checkbox.mockResolvedValue(['claude-code', 'cursor', 'codex']);
+        mocks.select.mockResolvedValue('project');
+        mocks.confirm.mockResolvedValue(true);
+        vitest_1.vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+    });
+    (0, vitest_1.afterEach)(() => {
+        process.chdir(original_cwd);
+        if (stdin_tty)
+            Object.defineProperty(process.stdin, 'isTTY', stdin_tty);
+        if (stdout_tty)
+            Object.defineProperty(process.stdout, 'isTTY', stdout_tty);
+        delete process.env['CODEX_HOME'];
+        vitest_1.vi.restoreAllMocks();
+        if (tmp_dir)
+            fs_1.default.rmSync(tmp_dir, { recursive: true, force: true });
+    });
+    (0, vitest_1.it)('writes selected agent configs in the full interactive flow', async () => {
+        await (0, add_mcp_1.run_add_mcp)();
+        (0, vitest_1.expect)(mocks.checkbox).toHaveBeenCalledOnce();
+        (0, vitest_1.expect)(mocks.select).toHaveBeenCalledOnce();
+        (0, vitest_1.expect)(mocks.confirm).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(read_json(path_1.default.join(project_dir, '.claude', 'settings.json')))
+            .toEqual({
+            mcpServers: {
+                'bright-data': get_expected_entry('test_api_key'),
+            },
+        });
+        (0, vitest_1.expect)(read_json(path_1.default.join(project_dir, '.cursor', 'mcp.json')))
+            .toEqual({
+            mcpServers: {
+                'bright-data': get_expected_entry('test_api_key'),
+            },
+        });
+        (0, vitest_1.expect)(read_json(path_1.default.join(codex_home, 'mcp.json')))
+            .toEqual({
+            mcpServers: {
+                'bright-data': get_expected_entry('test_api_key'),
+            },
+        });
+        (0, vitest_1.expect)(fs_1.default.existsSync(path_1.default.join(home_dir, '.claude.json'))).toBe(false);
+        (0, vitest_1.expect)(fs_1.default.existsSync(path_1.default.join(home_dir, '.cursor', 'mcp.json')))
+            .toBe(false);
+    });
+    (0, vitest_1.it)('warns and overwrites invalid JSON after confirmation', async () => {
+        const cursor_config = path_1.default.join(project_dir, '.cursor', 'mcp.json');
+        fs_1.default.mkdirSync(path_1.default.dirname(cursor_config), { recursive: true });
+        fs_1.default.writeFileSync(cursor_config, '{invalid-json');
+        mocks.checkbox.mockResolvedValue(['cursor']);
+        mocks.select.mockResolvedValue('project');
+        mocks.confirm.mockResolvedValue(true);
+        await (0, add_mcp_1.run_add_mcp)();
+        (0, vitest_1.expect)(mocks.warn).toHaveBeenCalledWith(vitest_1.expect.stringContaining('Invalid JSON in ' + cursor_config));
+        (0, vitest_1.expect)(mocks.confirm).toHaveBeenCalledWith({
+            message: 'Overwrite invalid config at ' + cursor_config + '?',
+            default: false,
+        });
+        (0, vitest_1.expect)(read_json(cursor_config)).toEqual({
+            mcpServers: {
+                'bright-data': get_expected_entry('test_api_key'),
+            },
+        });
+    });
+});
+//# sourceMappingURL=add-mcp.test.js.map

package/dist/__tests__/commands/add-mcp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-mcp.test.js","sourceRoot":"","sources":["../../../src/__tests__/commands/add-mcp.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/utils/mcp-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-config.test.d.ts.map

package/dist/__tests__/utils/mcp-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/utils/mcp-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/utils/mcp-config.test.js

@@ -0,0 +1,154 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const vitest_1 = require("vitest");
+const mcp_config_1 = require("../../utils/mcp-config");
+const get_expected_entry = (api_key) => ({
+    command: 'npx',
+    args: ['@brightdata/mcp'],
+    env: {
+        API_TOKEN: api_key,
+    },
+});
+const mk_tmp_dir = () => fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'brightdata-mcp-config-'));
+(0, vitest_1.describe)('utils/mcp-config', () => {
+    let tmp_dir = '';
+    (0, vitest_1.beforeEach)(() => {
+        tmp_dir = mk_tmp_dir();
+    });
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+        delete process.env['CODEX_HOME'];
+        if (tmp_dir)
+            fs_1.default.rmSync(tmp_dir, { recursive: true, force: true });
+    });
+    (0, vitest_1.it)('creates a new config file when none exists', () => {
+        const file_path = path_1.default.join(tmp_dir, 'mcp.json');
+        (0, mcp_config_1.upsert_mcp_config)(file_path, 'new_key');
+        (0, vitest_1.expect)(JSON.parse(fs_1.default.readFileSync(file_path, 'utf8'))).toEqual({
+            mcpServers: {
+                'bright-data': get_expected_entry('new_key'),
+            },
+        });
+        (0, vitest_1.expect)(fs_1.default.statSync(file_path).mode & 0o777).toBe(0o600);
+    });
+    (0, vitest_1.it)('merges the Bright Data server into an existing config', () => {
+        const file_path = path_1.default.join(tmp_dir, 'mcp.json');
+        fs_1.default.writeFileSync(file_path, JSON.stringify({
+            theme: 'light',
+            mcpServers: {
+                existing: {
+                    command: 'node',
+                },
+            },
+        }, null, 4));
+        (0, mcp_config_1.upsert_mcp_config)(file_path, 'merged_key');
+        (0, vitest_1.expect)(JSON.parse(fs_1.default.readFileSync(file_path, 'utf8'))).toEqual({
+            theme: 'light',
+            mcpServers: {
+                existing: {
+                    command: 'node',
+                },
+                'bright-data': get_expected_entry('merged_key'),
+            },
+        });
+    });
+    (0, vitest_1.it)('overwrites an existing bright-data entry without removing other servers', () => {
+        const file_path = path_1.default.join(tmp_dir, 'mcp.json');
+        fs_1.default.writeFileSync(file_path, JSON.stringify({
+            mcpServers: {
+                'bright-data': {
+                    command: 'old-command',
+                    args: ['old-package'],
+                    env: {
+                        API_TOKEN: 'old_key',
+                        EXTRA: 'value',
+                    },
+                },
+                existing: {
+                    command: 'node',
+                },
+            },
+        }, null, 4));
+        (0, mcp_config_1.upsert_mcp_config)(file_path, 'fresh_key');
+        (0, vitest_1.expect)(JSON.parse(fs_1.default.readFileSync(file_path, 'utf8'))).toEqual({
+            mcpServers: {
+                'bright-data': get_expected_entry('fresh_key'),
+                existing: {
+                    command: 'node',
+                },
+            },
+        });
+    });
+    (0, vitest_1.it)('throws on invalid JSON unless overwrite_invalid is set', () => {
+        const file_path = path_1.default.join(tmp_dir, 'mcp.json');
+        fs_1.default.writeFileSync(file_path, '{invalid-json');
+        (0, vitest_1.expect)(() => (0, mcp_config_1.upsert_mcp_config)(file_path, 'api_key'))
+            .toThrow(mcp_config_1.Invalid_mcp_config_error);
+        (0, mcp_config_1.upsert_mcp_config)(file_path, 'api_key', { overwrite_invalid: true });
+        (0, vitest_1.expect)(JSON.parse(fs_1.default.readFileSync(file_path, 'utf8'))).toEqual({
+            mcpServers: {
+                'bright-data': get_expected_entry('api_key'),
+            },
+        });
+    });
+    (0, vitest_1.it)('writes Claude Code global config to the home directory', () => {
+        const home_dir = path_1.default.join(tmp_dir, 'home');
+        const exists_sync = vitest_1.vi.spyOn(fs_1.default, 'existsSync').mockReturnValue(false);
+        const mkdir_sync = vitest_1.vi.spyOn(fs_1.default, 'mkdirSync')
+            .mockImplementation(() => undefined);
+        const write_file_sync = vitest_1.vi.spyOn(fs_1.default, 'writeFileSync')
+            .mockImplementation(() => undefined);
+        const chmod_sync = vitest_1.vi.spyOn(fs_1.default, 'chmodSync')
+            .mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(os_1.default, 'homedir').mockReturnValue(home_dir);
+        (0, mcp_config_1.write_claude_code_mcp)('api_key', 'global');
+        (0, vitest_1.expect)(exists_sync).toHaveBeenCalled();
+        (0, vitest_1.expect)(mkdir_sync).toHaveBeenCalledWith(home_dir, { recursive: true });
+        (0, vitest_1.expect)(write_file_sync).toHaveBeenCalledWith(path_1.default.join(home_dir, '.claude.json'), vitest_1.expect.any(String), { mode: 0o600 });
+        (0, vitest_1.expect)(chmod_sync).toHaveBeenCalledWith(path_1.default.join(home_dir, '.claude.json'), 0o600);
+    });
+    (0, vitest_1.it)('writes Claude Code project config under the current directory', () => {
+        const project_dir = path_1.default.join(tmp_dir, 'project');
+        const write_file_sync = vitest_1.vi.spyOn(fs_1.default, 'writeFileSync')
+            .mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(fs_1.default, 'existsSync').mockReturnValue(false);
+        vitest_1.vi.spyOn(fs_1.default, 'mkdirSync').mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(fs_1.default, 'chmodSync').mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(process, 'cwd').mockReturnValue(project_dir);
+        (0, mcp_config_1.write_claude_code_mcp)('api_key', 'project');
+        (0, vitest_1.expect)(write_file_sync).toHaveBeenCalledWith(path_1.default.join(project_dir, '.claude', 'settings.json'), vitest_1.expect.any(String), { mode: 0o600 });
+    });
+    (0, vitest_1.it)('writes Cursor config to the correct global and project paths', () => {
+        const home_dir = path_1.default.join(tmp_dir, 'home');
+        const project_dir = path_1.default.join(tmp_dir, 'project');
+        const write_file_sync = vitest_1.vi.spyOn(fs_1.default, 'writeFileSync')
+            .mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(fs_1.default, 'existsSync').mockReturnValue(false);
+        vitest_1.vi.spyOn(fs_1.default, 'mkdirSync').mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(fs_1.default, 'chmodSync').mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(os_1.default, 'homedir').mockReturnValue(home_dir);
+        vitest_1.vi.spyOn(process, 'cwd').mockReturnValue(project_dir);
+        (0, mcp_config_1.write_cursor_mcp)('api_key', 'global');
+        (0, mcp_config_1.write_cursor_mcp)('api_key', 'project');
+        (0, vitest_1.expect)(write_file_sync).toHaveBeenNthCalledWith(1, path_1.default.join(home_dir, '.cursor', 'mcp.json'), vitest_1.expect.any(String), { mode: 0o600 });
+        (0, vitest_1.expect)(write_file_sync).toHaveBeenNthCalledWith(2, path_1.default.join(project_dir, '.cursor', 'mcp.json'), vitest_1.expect.any(String), { mode: 0o600 });
+    });
+    (0, vitest_1.it)('writes Codex config to CODEX_HOME when it is set', () => {
+        const codex_home = path_1.default.join(tmp_dir, 'codex-home');
+        const write_file_sync = vitest_1.vi.spyOn(fs_1.default, 'writeFileSync')
+            .mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(fs_1.default, 'existsSync').mockReturnValue(false);
+        vitest_1.vi.spyOn(fs_1.default, 'mkdirSync').mockImplementation(() => undefined);
+        vitest_1.vi.spyOn(fs_1.default, 'chmodSync').mockImplementation(() => undefined);
+        process.env['CODEX_HOME'] = codex_home;
+        (0, mcp_config_1.write_codex_mcp)('api_key');
+        (0, vitest_1.expect)(write_file_sync).toHaveBeenCalledWith(path_1.default.join(codex_home, 'mcp.json'), vitest_1.expect.any(String), { mode: 0o600 });
+    });
+});
+//# sourceMappingURL=mcp-config.test.js.map

package/dist/__tests__/utils/mcp-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.test.js","sourceRoot":"","sources":["../../../src/__tests__/utils/mcp-config.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/add-mcp.d.ts

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+import type { Mcp_scope, Mcp_write_opts } from '../utils/mcp-config';
+type Mcp_agent = 'claude-code' | 'cursor' | 'codex';
+type Add_mcp_opts = {
+    agent?: string;
+    global?: boolean;
+    project?: boolean;
+};
+type Mcp_writers = {
+    write_claude_code_mcp: (api_key: string, scope: Mcp_scope, opts?: Mcp_write_opts) => void | Promise<void>;
+    write_cursor_mcp: (api_key: string, scope: Mcp_scope, opts?: Mcp_write_opts) => void | Promise<void>;
+    write_codex_mcp: (api_key: string, opts?: Mcp_write_opts) => void | Promise<void>;
+};
+declare const run_add_mcp: (opts?: Add_mcp_opts, writers?: Mcp_writers) => Promise<void>;
+declare const add_mcp_command: Command;
+export { add_mcp_command, run_add_mcp };
+export type { Add_mcp_opts, Mcp_agent, Mcp_writers };
+//# sourceMappingURL=add-mcp.d.ts.map

package/dist/commands/add-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-mcp.d.ts","sourceRoot":"","sources":["../../src/commands/add-mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AASlC,OAAO,KAAK,EAAC,SAAS,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAEnE,KAAK,SAAS,GAAG,aAAa,GAAC,QAAQ,GAAC,OAAO,CAAC;AAChD,KAAK,YAAY,GAAG;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,KAAK,WAAW,GAAG;IACf,qBAAqB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE,cAAc,KACtB,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,gBAAgB,EAAE,CACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE,cAAc,KACtB,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,KACpD,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAyOF,QAAA,MAAM,WAAW,GACb,OAAM,YAAiB,EACvB,UAAS,WAA6B,kBA0CzC,CAAC;AAEF,QAAA,MAAM,eAAe,SAQf,CAAC;AAEP,OAAO,EAAC,eAAe,EAAE,WAAW,EAAC,CAAC;AACtC,YAAY,EAAC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAC,CAAC"}

package/dist/commands/add-mcp.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run_add_mcp = exports.add_mcp_command = void 0;
+const prompts_1 = require("@inquirer/prompts");
+const commander_1 = require("commander");
+const credentials_1 = require("../utils/credentials");
+const output_1 = require("../utils/output");
+const mcp_config_1 = require("../utils/mcp-config");
+const backtick = String.fromCharCode(96);
+const mcp_agent_labels = {
+    'claude-code': 'Claude Code',
+    cursor: 'Cursor',
+    codex: 'Codex',
+};
+const mcp_agents = ['claude-code', 'cursor', 'codex'];
+const default_writers = {
+    write_claude_code_mcp: mcp_config_1.write_claude_code_mcp,
+    write_cursor_mcp: mcp_config_1.write_cursor_mcp,
+    write_codex_mcp: mcp_config_1.write_codex_mcp,
+};
+const format_error = (error) => {
+    if (error instanceof Error)
+        return error.message;
+    return 'Unknown error';
+};
+const format_agent_list = () => mcp_agents.join(', ');
+const is_tty = () => process.stdin.isTTY !== false && process.stdout.isTTY !== false;
+const parse_selected_agents = (agent_flag) => {
+    const selected = Array.from(new Set(agent_flag.split(',')
+        .map(agent => agent.trim().toLowerCase())
+        .filter(Boolean)));
+    if (!selected.length) {
+        process.stderr.write('No agents provided. Use --agent '
+            + format_agent_list() + '\n');
+        process.exitCode = 1;
+        return null;
+    }
+    const invalid = selected.filter(agent => !mcp_agents.includes(agent));
+    if (invalid.length) {
+        process.stderr.write('Unknown agent ' + invalid[0] + '. Supported agents: '
+            + format_agent_list() + '\n');
+        process.exitCode = 1;
+        return null;
+    }
+    return selected;
+};
+const resolve_selected_agents = async (opts) => {
+    if (opts.agent)
+        return parse_selected_agents(opts.agent);
+    if (!is_tty()) {
+        process.stderr.write('Non-interactive MCP installation requires --agent <agents>.\n');
+        process.exitCode = 1;
+        return null;
+    }
+    return await (0, prompts_1.checkbox)({
+        message: 'Which coding agents should Bright Data MCP be added to?',
+        choices: mcp_agents.map(agent => ({
+            name: mcp_agent_labels[agent],
+            value: agent,
+        })),
+        validate: value => {
+            if (value.length)
+                return true;
+            return 'Select at least one coding agent';
+        },
+    });
+};
+const resolve_scope_from_flags = (selected_agents, opts) => {
+    if (opts.global && opts.project) {
+        process.stderr.write('Choose either --global or --project, not both.\n');
+        process.exitCode = 1;
+        return 'error';
+    }
+    if (selected_agents.every(agent => agent == 'codex')) {
+        if (opts.project) {
+            process.stderr.write('Codex only supports global MCP installation.\n');
+            process.exitCode = 1;
+            return 'error';
+        }
+        return 'global';
+    }
+    if (opts.global)
+        return 'global';
+    if (opts.project)
+        return 'project';
+    return 'prompt';
+};
+const resolve_scope = async (selected_agents, opts) => {
+    const scope_from_flags = resolve_scope_from_flags(selected_agents, opts);
+    if (scope_from_flags == 'global' || scope_from_flags == 'project')
+        return scope_from_flags;
+    if (scope_from_flags == 'error')
+        return null;
+    if (!is_tty()) {
+        process.stderr.write('Non-interactive MCP installation requires --global or --project '
+            + 'when targeting Claude Code or Cursor.\n');
+        process.exitCode = 1;
+        return null;
+    }
+    return await (0, prompts_1.select)({
+        message: 'Install globally or for this project?',
+        choices: [
+            {
+                name: 'Global',
+                value: 'global',
+            },
+            {
+                name: 'Project',
+                value: 'project',
+            },
+        ],
+        default: 'global',
+    });
+};
+const write_agent_mcp = async (agent, api_key, scope, writers, opts = {}) => {
+    if (agent == 'claude-code')
+        return writers.write_claude_code_mcp(api_key, scope, opts);
+    if (agent == 'cursor')
+        return writers.write_cursor_mcp(api_key, scope, opts);
+    return writers.write_codex_mcp(api_key, opts);
+};
+const write_agent_with_recovery = async (agent, api_key, scope, writers) => {
+    try {
+        await write_agent_mcp(agent, api_key, scope, writers);
+        return;
+    }
+    catch (error) {
+        if (!(error instanceof mcp_config_1.Invalid_mcp_config_error))
+            throw error;
+        (0, output_1.warn)(error.message);
+        if (!is_tty()) {
+            throw new Error('Fix the invalid JSON manually or rerun with a TTY to '
+                + 'overwrite it.');
+        }
+        const overwrite = await (0, prompts_1.confirm)({
+            message: 'Overwrite invalid config at ' + error.file_path + '?',
+            default: false,
+        });
+        if (!overwrite) {
+            throw new Error('Aborted because ' + error.file_path + ' contains invalid JSON');
+        }
+        await write_agent_mcp(agent, api_key, scope, writers, { overwrite_invalid: true });
+    }
+};
+const print_summary = (selected_agents, success_count, failures) => {
+    process.stderr.write('\n');
+    process.stderr.write((0, output_1.dim)('Summary: ' + selected_agents.length + ' target'
+        + (selected_agents.length == 1 ? '' : 's') + ', ' + success_count
+        + ' succeeded, ' + failures.length + ' failed.\n'));
+    for (const failure of failures) {
+        process.stderr.write((0, output_1.red)('✗ ' + mcp_agent_labels[failure.agent] + ': ' + failure.reason + '\n'));
+    }
+};
+const run_add_mcp = async (opts = {}, writers = default_writers) => {
+    const api_key = (0, credentials_1.get_api_key)();
+    if (api_key == null) {
+        process.stderr.write('Not logged in. Run ' + backtick
+            + 'brightdata login' + backtick + ' first.\n');
+        process.exitCode = 1;
+        return;
+    }
+    const selected_agents = await resolve_selected_agents(opts);
+    if (selected_agents == null)
+        return;
+    const scope = await resolve_scope(selected_agents, opts);
+    if (scope == null)
+        return;
+    const failures = [];
+    let success_count = 0;
+    for (const agent of selected_agents) {
+        try {
+            await write_agent_with_recovery(agent, api_key, scope, writers);
+            success_count++;
+            process.stderr.write((0, output_1.green)('✓ Added Bright Data MCP to '
+                + mcp_agent_labels[agent] + '\n'));
+        }
+        catch (error) {
+            const reason = format_error(error);
+            failures.push({ agent, reason });
+            process.stderr.write((0, output_1.red)('✗ Failed ' + mcp_agent_labels[agent] + ': ' + reason + '\n'));
+            process.exitCode = 1;
+        }
+    }
+    print_summary(selected_agents, success_count, failures);
+};
+exports.run_add_mcp = run_add_mcp;
+const add_mcp_command = new commander_1.Command('mcp')
+    .description('Add Bright Data MCP to Claude Code, Cursor, or Codex')
+    .option('--agent <agents>', 'Comma-separated: claude-code,cursor,codex')
+    .option('--global', 'Install to global config')
+    .option('--project', 'Install to project config')
+    .action(async (opts) => {
+    await run_add_mcp(opts);
+});
+exports.add_mcp_command = add_mcp_command;
+//# sourceMappingURL=add-mcp.js.map

package/dist/commands/add-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-mcp.js","sourceRoot":"","sources":["../../src/commands/add-mcp.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -17,8 +17,12 @@ const init_1 = require("./commands/init");
 const version_1 = require("./commands/version");
 const skill_1 = require("./commands/skill");
 const budget_1 = require("./commands/budget");
+const add_mcp_1 = require("./commands/add-mcp");
 const package_json_1 = __importDefault(require("../package.json"));
 const program = new commander_1.Command();
+const add_command = new commander_1.Command('add')
+    .description('Add Bright Data integrations to supported coding agents')
+    .addCommand(add_mcp_1.add_mcp_command);
 program
     .name('brightdata')
     .description('Command-line interface for Bright Data. Scrape, search, '
@@ -38,5 +42,6 @@ program.addCommand(init_1.init_command);
 program.addCommand(version_1.version_command);
 program.addCommand(skill_1.skill_command);
 program.addCommand(budget_1.budget_command);
+program.addCommand(add_command);
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AACA,yCAAkC;AAClC,4CAA+C;AAC/C,8CAAiD;AACjD,8CAAiD;AACjD,8CAAiD;AACjD,gDAAqD;AACrD,8CAAiD;AACjD,4CAA+C;AAC/C,8CAAiD;AACjD,0CAA6C;AAC7C,gDAAmD;AACnD,4CAA+C;AAC/C,8CAAiD;AACjD,mEAA0C;AAE1C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACR,0DAA0D;MACzD,oEAAoE,CACxE;KACA,OAAO,CAAC,sBAAW,CAAC,OAAO,EAAE,eAAe,CAAC;KAC7C,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;KAC3E,MAAM,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAE/C,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,2BAAiB,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,mBAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,yBAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AAGnC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AACA,yCAAkC;AAClC,4CAA+C;AAC/C,8CAAiD;AACjD,8CAAiD;AACjD,8CAAiD;AACjD,gDAAqD;AACrD,8CAAiD;AACjD,4CAA+C;AAC/C,8CAAiD;AACjD,0CAA6C;AAC7C,gDAAmD;AACnD,4CAA+C;AAC/C,8CAAiD;AACjD,gDAAmD;AACnD,mEAA0C;AAE1C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAC9B,MAAM,WAAW,GAAG,IAAI,mBAAO,CAAC,KAAK,CAAC;KACjC,WAAW,CAAC,yDAAyD,CAAC;KACtE,UAAU,CAAC,yBAAe,CAAC,CAAC;AAEjC,OAAO;KACF,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACR,0DAA0D;MACzD,oEAAoE,CACxE;KACA,OAAO,CAAC,sBAAW,CAAC,OAAO,EAAE,eAAe,CAAC;KAC7C,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;KAC3E,MAAM,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAE/C,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,2BAAiB,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,mBAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,yBAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/utils/mcp-config.d.ts

@@ -0,0 +1,15 @@
+type Mcp_scope = 'global' | 'project';
+type Mcp_write_opts = {
+    overwrite_invalid?: boolean;
+};
+declare class Invalid_mcp_config_error extends Error {
+    file_path: string;
+    constructor(file_path: string, reason: string);
+}
+declare const upsert_mcp_config: (file_path: string, api_key: string, opts?: Mcp_write_opts) => void;
+declare const write_claude_code_mcp: (api_key: string, scope: Mcp_scope, opts?: Mcp_write_opts) => void;
+declare const write_cursor_mcp: (api_key: string, scope: Mcp_scope, opts?: Mcp_write_opts) => void;
+declare const write_codex_mcp: (api_key: string, opts?: Mcp_write_opts) => void;
+export { Invalid_mcp_config_error, upsert_mcp_config, write_claude_code_mcp, write_cursor_mcp, write_codex_mcp, };
+export type { Mcp_scope, Mcp_write_opts };
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/utils/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/utils/mcp-config.ts"],"names":[],"mappings":"AAIA,KAAK,SAAS,GAAG,QAAQ,GAAC,SAAS,CAAC;AACpC,KAAK,cAAc,GAAG;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAGF,cAAM,wBAAyB,SAAQ,KAAK;IACxC,SAAS,EAAE,MAAM,CAAC;gBAEN,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAMhD;AAqCD,QAAA,MAAM,iBAAiB,GACnB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,OAAM,cAAmB,SAsB5B,CAAC;AAEF,QAAA,MAAM,qBAAqB,GACvB,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,OAAM,cAAmB,SAM5B,CAAC;AAEF,QAAA,MAAM,gBAAgB,GAClB,SAAS,MAAM,EACf,OAAO,SAAS,EAChB,OAAM,cAAmB,SAM5B,CAAC;AAEF,QAAA,MAAM,eAAe,GACjB,SAAS,MAAM,EACf,OAAM,cAAmB,SAK5B,CAAC;AAEF,OAAO,EACH,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAClB,CAAC;AACF,YAAY,EAAC,SAAS,EAAE,cAAc,EAAC,CAAC"}

package/dist/utils/mcp-config.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.write_codex_mcp = exports.write_cursor_mcp = exports.write_claude_code_mcp = exports.upsert_mcp_config = exports.Invalid_mcp_config_error = void 0;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+class Invalid_mcp_config_error extends Error {
+    file_path;
+    constructor(file_path, reason) {
+        super('Invalid JSON in ' + file_path + ': ' + reason);
+        this.name = 'Invalid_mcp_config_error';
+        this.file_path = file_path;
+    }
+}
+exports.Invalid_mcp_config_error = Invalid_mcp_config_error;
+const is_plain_object = (value) => typeof value == 'object' && value !== null && !Array.isArray(value);
+const get_bright_data_mcp = (api_key) => ({
+    command: 'npx',
+    args: ['@brightdata/mcp'],
+    env: {
+        API_TOKEN: api_key,
+    },
+});
+const load_json_object = (file_path, opts = {}) => {
+    if (!fs_1.default.existsSync(file_path))
+        return {};
+    const raw = fs_1.default.readFileSync(file_path, 'utf8').trim();
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (!is_plain_object(parsed))
+            throw new Error('Expected top-level JSON object');
+        return parsed;
+    }
+    catch (error) {
+        if (opts.overwrite_invalid)
+            return {};
+        const reason = error instanceof Error ? error.message : 'Unknown error';
+        throw new Invalid_mcp_config_error(file_path, reason);
+    }
+};
+const upsert_mcp_config = (file_path, api_key, opts = {}) => {
+    const current = load_json_object(file_path, opts);
+    const mcp_servers = is_plain_object(current['mcpServers'])
+        ? current['mcpServers']
+        : {};
+    const next = {
+        ...current,
+        mcpServers: {
+            ...mcp_servers,
+            'bright-data': get_bright_data_mcp(api_key),
+        },
+    };
+    const dir = path_1.default.dirname(file_path);
+    if (!fs_1.default.existsSync(dir))
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    fs_1.default.writeFileSync(file_path, JSON.stringify(next, null, 4) + '\n', {
+        mode: 0o600,
+    });
+    fs_1.default.chmodSync(file_path, 0o600);
+};
+exports.upsert_mcp_config = upsert_mcp_config;
+const write_claude_code_mcp = (api_key, scope, opts = {}) => {
+    const file_path = scope == 'project'
+        ? path_1.default.join(process.cwd(), '.claude', 'settings.json')
+        : path_1.default.join(os_1.default.homedir(), '.claude.json');
+    upsert_mcp_config(file_path, api_key, opts);
+};
+exports.write_claude_code_mcp = write_claude_code_mcp;
+const write_cursor_mcp = (api_key, scope, opts = {}) => {
+    const file_path = scope == 'project'
+        ? path_1.default.join(process.cwd(), '.cursor', 'mcp.json')
+        : path_1.default.join(os_1.default.homedir(), '.cursor', 'mcp.json');
+    upsert_mcp_config(file_path, api_key, opts);
+};
+exports.write_cursor_mcp = write_cursor_mcp;
+const write_codex_mcp = (api_key, opts = {}) => {
+    const codex_home = process.env['CODEX_HOME']?.trim()
+        || path_1.default.join(os_1.default.homedir(), '.codex');
+    upsert_mcp_config(path_1.default.join(codex_home, 'mcp.json'), api_key, opts);
+};
+exports.write_codex_mcp = write_codex_mcp;
+//# sourceMappingURL=mcp-config.js.map

package/dist/utils/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../src/utils/mcp-config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@brightdata/cli",
-    "version": "0.1.3",
+    "version": "0.1.4",
     "description": "Command-line interface for Bright Data. Scrape, search, extract structured data, and automate browsers directly from your terminal.",
     "main": "dist/index.js",
     "bin": {