buzzdealer-ai 0.0.0-stage → 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 buzzdealer-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# buzzdealer-ai
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Connect your AI assistant or coding agent to [Buzz Dealer AI](https://buzzdealer.ai): the **Press Room** for PR and press release distribution through newswires, PR distribution packages and news sites, and the **Reputation Agent** for how Google and AI assistants describe you and your company.
+
+The server is remote: `https://mcp.buzzdealer.ai/mcp` (streamable HTTP, OAuth sign-in, or a personal API key as `Authorization: Bearer <key>`). This package only helps you add it, and gives you a small typed client for the read endpoints of the REST API. No runtime dependencies. Node 18 or later.
+
+## CLI
+
+```
+npx buzzdealer-ai connect            # print the connect steps for every client
+npx buzzdealer-ai add claude-code    # print, then run: claude mcp add --transport http buzzdealer-ai https://mcp.buzzdealer.ai/mcp
+npx buzzdealer-ai add cursor         # add the server to ~/.cursor/mcp.json
+npx buzzdealer-ai add vscode         # add the server to .vscode/mcp.json in this folder
+npx buzzdealer-ai help
+```
+
+- `add cursor` and `add vscode` create the file if it is missing, keep every other server and setting, and print what they changed.
+- `--dry-run` prints what would change or run, and changes nothing.
+- `--file <path>` uses another config file.
+- `add claude-code` always prints the command before it runs it, and runs it only when `claude` is on your PATH.
+
+After adding the server, sign in when your client asks. Step by step for every client: https://buzzdealer.ai/connect
+
+## Client
+
+```ts
+import { BuzzDealerClient, BuzzDealerApiError } from "buzzdealer-ai";
+
+const bd = new BuzzDealerClient({ apiKey: process.env.BUZZDEALER_API_KEY! });
+
+const account = await bd.getAccount();
+const { results } = await bd.findPublications({ product_type: "pr_package", region: "UK", limit: 5 });
+const one = await bd.getPublication(results[0].id);
+const scores = await bd.getAiVisibilityScores(["northwind.example"]);
+
+try {
+  await bd.request("GET", "/v1/orders");
+} catch (e) {
+  if (e instanceof BuzzDealerApiError) console.error(e.status, e.code, e.message, e.nextStep);
+}
+```
+
+| Method | Endpoint |
+| --- | --- |
+| `getAccount({ brand_id? })` | `GET /v1/account` |
+| `findPublications(params)` | `GET /v1/publications` |
+| `getPublication(itemId)` | `GET /v1/publications/{item_id}` |
+| `getAiVisibilityScores(domains)` | `POST /v1/ai-visibility-scores` (reads only) |
+| `request(method, path, { query, body })` | any endpoint |
+
+Options: `apiKey` (required; the account owner creates keys in the dashboard under Connections), `baseUrl` (default `https://api.buzzdealer.ai`), `fetch` (default: the global fetch).
+
+The typed methods only read. Orders go through `quote_order` and `place_order` (or `POST /v1/quotes` and `POST /v1/orders`): quote first, wait for the person's yes to the total, then order with `confirm: true`. Orders use the account's existing balance; agents cannot pay.
+
+Full API: https://buzzdealer.ai/docs and https://buzzdealer.ai/openapi.json
+
+## Licence
+
+MIT. The Buzz Dealer AI service has its own terms: https://buzzdealer.ai/terms

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { run } from "./run.js";
+process.exitCode = run(process.argv.slice(2));

package/dist/client.d.ts

@@ -0,0 +1,111 @@
+/** The error body of the REST API: every error has a code, a message and the next step. */
+export interface ApiErrorBody {
+    error: string;
+    message: string;
+    next_step?: string;
+    [key: string]: unknown;
+}
+/** Thrown for any answer that is not 2xx. `code` is the API's machine-readable `error` field. */
+export declare class BuzzDealerApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly nextStep: string | undefined;
+    readonly body: ApiErrorBody | undefined;
+    constructor(status: number, body: ApiErrorBody | undefined, fallbackMessage?: string);
+}
+export type Goal = "reputation" | "seo" | "ai_visibility" | "mentions";
+export type ProductType = "site" | "pr_package" | "bundle" | "program" | "service";
+/** Query of GET /v1/publications. */
+export interface FindPublicationsParams {
+    product_type?: ProductType;
+    category?: string;
+    region?: string;
+    /** ISO 639-1 code (en, es) or English name (English). */
+    language?: string;
+    /** Highest price per item, in US cents. */
+    max_price_cents?: number;
+    dofollow?: boolean;
+    /** Lowest DR (Ahrefs), 0 to 100. */
+    min_dr?: number;
+    query?: string;
+    /** 1 to 50; the API's default is 10. */
+    limit?: number;
+    goal?: Goal;
+    /** A goal mix, for example { ai_visibility: 60, seo: 40 }. Sent as ai_visibility:60,seo:40. */
+    goal_weights?: Partial<Record<Goal, number>>;
+}
+/** A catalog item. Key fields only; the API may send more. */
+export interface Publication {
+    id: string;
+    product_type: ProductType;
+    name: string;
+    domain?: string | null;
+    category?: string | null;
+    region?: string | null;
+    languages?: string[];
+    price_cents: number | null;
+    price?: string | null;
+    currency: "USD";
+    ai_score?: number | null;
+    tier?: string | null;
+    dr?: number;
+    dofollow?: boolean | null;
+    min_word_count?: number | null;
+    max_word_count?: number | null;
+    max_links?: number | null;
+    [key: string]: unknown;
+}
+export interface FindPublicationsResult {
+    total: number;
+    results: Publication[];
+    [key: string]: unknown;
+}
+export interface PublicationResult {
+    item: Publication;
+    [key: string]: unknown;
+}
+export interface AiVisibilityScore {
+    domain: string;
+    rated: boolean;
+    ai_score?: number | null;
+    tier?: string | null;
+    [key: string]: unknown;
+}
+export interface AiVisibilityScoresResult {
+    results: AiVisibilityScore[];
+    [key: string]: unknown;
+}
+/** GET /v1/account: balance, budget frame, pending approvals. The shape is open. */
+export type Account = Record<string, unknown>;
+export interface BuzzDealerClientOptions {
+    /** A personal API key from the dashboard (Connections). */
+    apiKey: string;
+    /** Defaults to https://api.buzzdealer.ai */
+    baseUrl?: string;
+    /** Defaults to the global fetch (Node 18+). Pass your own for tests or proxies. */
+    fetch?: typeof fetch;
+}
+export interface RequestOptions {
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+/** A thin typed client for the read endpoints of the Buzz Dealer AI REST API. */
+export declare class BuzzDealerClient {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor(options: BuzzDealerClientOptions);
+    /** Any endpoint. `path` starts with /v1. Throws BuzzDealerApiError on a non-2xx answer. */
+    request<T = unknown>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    /** GET /v1/account */
+    getAccount(params?: {
+        brand_id?: string;
+    }): Promise<Account>;
+    /** GET /v1/publications */
+    findPublications(params?: FindPublicationsParams): Promise<FindPublicationsResult>;
+    /** GET /v1/publications/{item_id} */
+    getPublication(itemId: string): Promise<PublicationResult>;
+    /** POST /v1/ai-visibility-scores: reads only (a POST because it takes a list of domains). */
+    getAiVisibilityScores(domains: string[]): Promise<AiVisibilityScoresResult>;
+}

package/dist/client.js

@@ -0,0 +1,86 @@
+import { API_BASE_URL } from "./constants.js";
+/** Thrown for any answer that is not 2xx. `code` is the API's machine-readable `error` field. */
+export class BuzzDealerApiError extends Error {
+    status;
+    code;
+    nextStep;
+    body;
+    constructor(status, body, fallbackMessage) {
+        super(body?.message ?? fallbackMessage ?? `Request failed with status ${status}`);
+        this.name = "BuzzDealerApiError";
+        this.status = status;
+        this.code = body?.error ?? "http_error";
+        this.nextStep = body?.next_step;
+        this.body = body;
+    }
+}
+/** A thin typed client for the read endpoints of the Buzz Dealer AI REST API. */
+export class BuzzDealerClient {
+    baseUrl;
+    apiKey;
+    fetchImpl;
+    constructor(options) {
+        if (!options || typeof options.apiKey !== "string" || options.apiKey.trim() === "") {
+            throw new TypeError("BuzzDealerClient needs an apiKey (create one in the dashboard under Connections).");
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? API_BASE_URL).replace(/\/+$/, "");
+        const f = options.fetch ?? globalThis.fetch;
+        if (!f)
+            throw new TypeError("No fetch available: use Node 18 or later, or pass options.fetch.");
+        this.fetchImpl = f;
+    }
+    /** Any endpoint. `path` starts with /v1. Throws BuzzDealerApiError on a non-2xx answer. */
+    async request(method, path, options = {}) {
+        const url = new URL(this.baseUrl + (path.startsWith("/") ? path : `/${path}`));
+        for (const [k, v] of Object.entries(options.query ?? {})) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+        const headers = { accept: "application/json", authorization: `Bearer ${this.apiKey}`, ...options.headers };
+        let body;
+        if (options.body !== undefined) {
+            headers["content-type"] = "application/json";
+            body = JSON.stringify(options.body);
+        }
+        const res = await this.fetchImpl(url.toString(), { method, headers, body });
+        const text = await res.text();
+        let data;
+        try {
+            data = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            data = undefined;
+        }
+        if (!res.ok) {
+            const b = data;
+            const errBody = b && typeof b === "object" && typeof b.error === "string" ? b : undefined;
+            throw new BuzzDealerApiError(res.status, errBody, text ? text.slice(0, 200) : undefined);
+        }
+        return data;
+    }
+    /** GET /v1/account */
+    getAccount(params = {}) {
+        return this.request("GET", "/v1/account", { query: { brand_id: params.brand_id } });
+    }
+    /** GET /v1/publications */
+    findPublications(params = {}) {
+        const { goal_weights, ...rest } = params;
+        const query = { ...rest };
+        if (goal_weights) {
+            query.goal_weights = Object.entries(goal_weights)
+                .filter(([, w]) => w !== undefined)
+                .map(([g, w]) => `${g}:${w}`)
+                .join(",");
+        }
+        return this.request("GET", "/v1/publications", { query });
+    }
+    /** GET /v1/publications/{item_id} */
+    getPublication(itemId) {
+        return this.request("GET", `/v1/publications/${encodeURIComponent(itemId)}`);
+    }
+    /** POST /v1/ai-visibility-scores: reads only (a POST because it takes a list of domains). */
+    getAiVisibilityScores(domains) {
+        return this.request("POST", "/v1/ai-visibility-scores", { body: { domains } });
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+export type Client = "cursor" | "vscode";
+/** Cursor keeps servers under "mcpServers"; VS Code under "servers" with a "type". */
+export declare function serverKey(client: Client): "mcpServers" | "servers";
+export declare function serverEntry(client: Client): Record<string, string>;
+/** ~/.cursor/mcp.json, or <cwd>/.vscode/mcp.json */
+export declare function defaultConfigPath(client: Client, cwd?: string, home?: string): string;
+export type MergeAction = "added" | "updated" | "unchanged";
+export interface MergeResult {
+    action: MergeAction;
+    config: Record<string, unknown>;
+    previous: unknown;
+}
+/** Puts the server into a parsed config, keeping every other server and key. Pure. */
+export declare function mergeServer(existing: unknown, client: Client): MergeResult;
+export interface AddResult extends MergeResult {
+    path: string;
+    created: boolean;
+    written: boolean;
+}
+/** Reads the file (if any), merges the server and writes it back unless dryRun. */
+export declare function addToConfigFile(client: Client, path: string, dryRun?: boolean): AddResult;

package/dist/config.js

@@ -0,0 +1,57 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { MCP_URL, SERVER_NAME } from "./constants.js";
+/** Cursor keeps servers under "mcpServers"; VS Code under "servers" with a "type". */
+export function serverKey(client) {
+    return client === "cursor" ? "mcpServers" : "servers";
+}
+export function serverEntry(client) {
+    return client === "cursor" ? { url: MCP_URL } : { type: "http", url: MCP_URL };
+}
+/** ~/.cursor/mcp.json, or <cwd>/.vscode/mcp.json */
+export function defaultConfigPath(client, cwd = process.cwd(), home = homedir()) {
+    return client === "cursor" ? join(home, ".cursor", "mcp.json") : join(cwd, ".vscode", "mcp.json");
+}
+/** Puts the server into a parsed config, keeping every other server and key. Pure. */
+export function mergeServer(existing, client) {
+    if (existing !== undefined && (typeof existing !== "object" || existing === null || Array.isArray(existing))) {
+        throw new Error("The config file is not a JSON object.");
+    }
+    const config = { ...(existing ?? {}) };
+    const key = serverKey(client);
+    const current = config[key];
+    if (current !== undefined && (typeof current !== "object" || current === null || Array.isArray(current))) {
+        throw new Error(`"${key}" in the config file is not an object.`);
+    }
+    const servers = { ...(current ?? {}) };
+    const previous = servers[SERVER_NAME];
+    // Keep any extra fields the person set on our entry (for example headers), and set type and url.
+    const next = previous && typeof previous === "object" && !Array.isArray(previous) ? { ...previous, ...serverEntry(client) } : serverEntry(client);
+    servers[SERVER_NAME] = next;
+    const action = previous === undefined ? "added" : JSON.stringify(next) === JSON.stringify(previous) ? "unchanged" : "updated";
+    return { action, config: { ...config, [key]: servers }, previous };
+}
+/** Reads the file (if any), merges the server and writes it back unless dryRun. */
+export function addToConfigFile(client, path, dryRun = false) {
+    const exists = existsSync(path);
+    let parsed;
+    if (exists) {
+        const raw = readFileSync(path, "utf8");
+        if (raw.trim() !== "") {
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                throw new Error(`${path} is not plain JSON (it may have comments). Nothing was changed; add the server by hand.`);
+            }
+        }
+    }
+    const result = mergeServer(parsed, client);
+    const write = !dryRun && result.action !== "unchanged";
+    if (write) {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(result.config, null, 2) + "\n", "utf8");
+    }
+    return { ...result, path, created: !exists, written: write };
+}

package/dist/constants.d.ts

@@ -0,0 +1,13 @@
+/** The name every config uses for the server. */
+export declare const SERVER_NAME = "buzzdealer-ai";
+/** The remote MCP server (streamable HTTP; OAuth, or a personal API key as a Bearer token). */
+export declare const MCP_URL = "https://mcp.buzzdealer.ai/mcp";
+/** The REST API host. Paths start with /v1. */
+export declare const API_BASE_URL = "https://api.buzzdealer.ai";
+export declare const CONNECT_URL = "https://buzzdealer.ai/connect";
+export declare const AGENTS_URL = "https://buzzdealer.ai/agents";
+export declare const DOCS_URL = "https://buzzdealer.ai/docs";
+export declare const OPENAPI_URL = "https://buzzdealer.ai/openapi.json";
+/** The Claude Code command, as an argument list (no shell). */
+export declare const CLAUDE_CODE_ARGS: readonly ["mcp", "add", "--transport", "http", "buzzdealer-ai", "https://mcp.buzzdealer.ai/mcp"];
+export declare const CLAUDE_CODE_COMMAND: string;

package/dist/constants.js

@@ -0,0 +1,13 @@
+/** The name every config uses for the server. */
+export const SERVER_NAME = "buzzdealer-ai";
+/** The remote MCP server (streamable HTTP; OAuth, or a personal API key as a Bearer token). */
+export const MCP_URL = "https://mcp.buzzdealer.ai/mcp";
+/** The REST API host. Paths start with /v1. */
+export const API_BASE_URL = "https://api.buzzdealer.ai";
+export const CONNECT_URL = "https://buzzdealer.ai/connect";
+export const AGENTS_URL = "https://buzzdealer.ai/agents";
+export const DOCS_URL = "https://buzzdealer.ai/docs";
+export const OPENAPI_URL = "https://buzzdealer.ai/openapi.json";
+/** The Claude Code command, as an argument list (no shell). */
+export const CLAUDE_CODE_ARGS = ["mcp", "add", "--transport", "http", SERVER_NAME, MCP_URL];
+export const CLAUDE_CODE_COMMAND = `claude ${CLAUDE_CODE_ARGS.join(" ")}`;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { BuzzDealerClient, BuzzDealerApiError, type ApiErrorBody, type Account, type AiVisibilityScore, type AiVisibilityScoresResult, type BuzzDealerClientOptions, type FindPublicationsParams, type FindPublicationsResult, type Goal, type ProductType, type Publication, type PublicationResult, type RequestOptions, } from "./client.js";
+export { addToConfigFile, defaultConfigPath, mergeServer, serverEntry, serverKey, type AddResult, type Client, type MergeAction, type MergeResult } from "./config.js";
+export * from "./constants.js";
+export { run, type CliIO } from "./run.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { BuzzDealerClient, BuzzDealerApiError, } from "./client.js";
+export { addToConfigFile, defaultConfigPath, mergeServer, serverEntry, serverKey } from "./config.js";
+export * from "./constants.js";
+export { run } from "./run.js";

package/dist/run.d.ts

@@ -0,0 +1,12 @@
+export interface CliIO {
+    log: (line: string) => void;
+    error: (line: string) => void;
+    cwd: string;
+    home: string;
+    /** Finds an executable on PATH; returns its path or undefined. */
+    which: (cmd: string) => string | undefined;
+    /** Runs a command and returns its exit code. */
+    exec: (cmd: string, args: readonly string[]) => number;
+}
+/** The CLI. Returns the exit code. */
+export declare function run(argv: readonly string[], io?: CliIO): number;

package/dist/run.js

@@ -0,0 +1,133 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, join } from "node:path";
+import { addToConfigFile, defaultConfigPath } from "./config.js";
+import { AGENTS_URL, CLAUDE_CODE_ARGS, CLAUDE_CODE_COMMAND, CONNECT_URL, DOCS_URL, MCP_URL, SERVER_NAME } from "./constants.js";
+function whichOnPath(cmd) {
+    const exts = process.platform === "win32" ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";") : [""];
+    for (const dir of (process.env.PATH ?? "").split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            const p = join(dir, cmd + ext);
+            if (existsSync(p))
+                return p;
+        }
+    }
+    return undefined;
+}
+const defaultIO = {
+    log: (l) => console.log(l),
+    error: (l) => console.error(l),
+    cwd: process.cwd(),
+    home: homedir(),
+    which: whichOnPath,
+    exec: (cmd, args) => spawnSync(cmd, [...args], { stdio: "inherit", shell: process.platform === "win32" }).status ?? 1,
+};
+const HELP = `buzzdealer-ai: connect your AI assistant to Buzz Dealer AI (${MCP_URL})
+
+Usage:
+  npx buzzdealer-ai connect                 Print the connect steps
+  npx buzzdealer-ai add claude-code         Print, then run: ${CLAUDE_CODE_COMMAND}
+  npx buzzdealer-ai add cursor              Add the server to ~/.cursor/mcp.json
+  npx buzzdealer-ai add vscode              Add the server to .vscode/mcp.json in this folder
+  npx buzzdealer-ai help                    This help
+
+Options:
+  --dry-run        Print what would change or run, and change nothing
+  --file <path>    For add cursor or add vscode: use this config file instead
+
+Docs: ${CONNECT_URL}`;
+function connectText() {
+    return `Buzz Dealer AI: Press Room (PR and press release distribution) and Reputation Agent.
+
+MCP server: ${MCP_URL} (streamable HTTP)
+Sign-in:    OAuth in your client, or a personal API key as "Authorization: Bearer <key>"
+            (the account owner creates keys in the Buzz Dealer AI dashboard under Connections)
+
+Claude Code:
+  ${CLAUDE_CODE_COMMAND}
+  then type /mcp and sign in
+Cursor:
+  npx buzzdealer-ai add cursor
+VS Code:
+  npx buzzdealer-ai add vscode
+Claude, ChatGPT, Gemini and others:
+  add a custom connector with the address ${MCP_URL}
+
+Step by step for every client: ${CONNECT_URL}
+For AI agents: ${AGENTS_URL}
+Docs: ${DOCS_URL}
+
+Before anything that spends credits, your assistant quotes first and waits for your yes to the total.`;
+}
+function addConfig(client, file, dryRun, io) {
+    const path = file ?? defaultConfigPath(client, io.cwd, io.home);
+    let r;
+    try {
+        r = addToConfigFile(client, path, dryRun);
+    }
+    catch (e) {
+        io.error(`Error: ${e.message}`);
+        return 1;
+    }
+    const entry = JSON.stringify(r.config[client === "cursor" ? "mcpServers" : "servers"][SERVER_NAME]);
+    if (r.action === "unchanged") {
+        io.log(`${path} already has "${SERVER_NAME}" set to ${MCP_URL}. Nothing changed.`);
+        return 0;
+    }
+    io.log(r.action === "added"
+        ? `${dryRun ? "Would add" : "Added"} "${SERVER_NAME}": ${entry}`
+        : `${dryRun ? "Would update" : "Updated"} "${SERVER_NAME}" from ${JSON.stringify(r.previous)} to ${entry}`);
+    if (r.created)
+        io.log(`${dryRun ? "Would create" : "Created"} ${path}`);
+    else
+        io.log(`${dryRun ? "Would change" : "Changed"} ${path}; other servers and settings were kept.`);
+    if (!dryRun)
+        io.log(client === "cursor" ? "Restart Cursor or reload its MCP settings, then sign in when asked." : "In VS Code, start the server from mcp.json and sign in when asked.");
+    return 0;
+}
+/** The CLI. Returns the exit code. */
+export function run(argv, io = defaultIO) {
+    const args = [...argv];
+    const dryRun = args.includes("--dry-run");
+    const fileAt = args.indexOf("--file");
+    const file = fileAt >= 0 ? args[fileAt + 1] : undefined;
+    if (fileAt >= 0 && !file) {
+        io.error("Error: --file needs a path.");
+        return 1;
+    }
+    const words = args.filter((a, i) => !a.startsWith("--") && !(fileAt >= 0 && i === fileAt + 1));
+    const [cmd, target] = words;
+    if (!cmd || cmd === "help" || args.includes("--help") || args.includes("-h")) {
+        io.log(HELP);
+        return 0;
+    }
+    if (cmd === "connect") {
+        io.log(connectText());
+        return 0;
+    }
+    if (cmd === "add") {
+        if (target === "claude-code" || target === "claude") {
+            io.log(`Command: ${CLAUDE_CODE_COMMAND}`);
+            if (dryRun)
+                return 0;
+            if (!io.which("claude")) {
+                io.log("Claude Code (claude) was not found on PATH. Run the command above once it is installed.");
+                return 0;
+            }
+            io.log("Running it now...");
+            const code = io.exec("claude", CLAUDE_CODE_ARGS);
+            if (code === 0)
+                io.log("Done. In Claude Code, type /mcp and sign in.");
+            return code;
+        }
+        if (target === "cursor" || target === "vscode")
+            return addConfig(target, file, dryRun, io);
+        io.error(`Unknown client "${target ?? ""}". Use claude-code, cursor or vscode.`);
+        return 1;
+    }
+    io.error(`Unknown command "${cmd}".\n\n${HELP}`);
+    return 1;
+}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "buzzdealer-ai",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.3.0",
+  "description": "Connect AI assistants and coding agents to the Buzz Dealer AI MCP server (Press Room and Reputation Agent), plus a small typed client for its REST API.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Buzz Dealer <support@buzzdealer.ai> (https://buzzdealer.ai)",
+  "homepage": "https://buzzdealer.ai/connect",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/buzzdealer-ai/mcp.git",
+    "directory": "packages/npm"
+  },
+  "bugs": {
+    "url": "https://github.com/buzzdealer-ai/mcp/issues",
+    "email": "support@buzzdealer.ai"
+  },
+  "keywords": [
+    "buzzdealer-ai",
+    "mcp",
+    "model-context-protocol",
+    "press-release",
+    "pr-distribution",
+    "newswire",
+    "press-room",
+    "reputation",
+    "ai-visibility",
+    "claude-code",
+    "cursor",
+    "vscode"
+  ],
+  "bin": {
+    "buzzdealer-ai": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test test/client.test.mjs test/cli.test.mjs",
+    "prepublishOnly": "npm run build && node --test test/client.test.mjs test/cli.test.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "typescript": "^5.9.3"
+  }
+}