mcp-google-ads 1.2.4 → 1.3.0

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "sha": "ce9ba28",
-  "builtAt": "2026-04-17T21:01:16.463Z",
+  "sha": "a2cf43a",
+  "builtAt": "2026-04-17T21:13:12.209Z",
   "embeddedSecrets": true
 }

package/dist/campaignBuilder.js

@@ -19,6 +19,14 @@ function buildCampaignCreatePayload(input) {
     status: enums.CampaignStatus.PAUSED,
     advertising_channel_type: channelEnum
   };
+  if (channelType === "DEMAND_GEN") {
+    campaign.network_settings = {
+      target_google_search: false,
+      target_search_network: false,
+      target_content_network: false,
+      target_partner_search_network: false
+    };
+  }
   if (input.start_date) campaign.start_date = input.start_date;
   if (input.end_date) campaign.end_date = input.end_date;
   switch (strategy) {

package/dist/doctor-cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+export interface DoctorCheck {
+    name: string;
+    status: "pass" | "fail" | "warn";
+    detail: string;
+}
+export interface DoctorOptions {
+    configPath?: string;
+    credentialsPath?: string;
+}
+export declare function runDoctor(opts?: DoctorOptions): Promise<DoctorCheck[]>;
+export declare function run(argv?: string[]): Promise<number>;

package/dist/doctor-cli.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from "fs";
+import { credentialsFilePath } from "./credentials.js";
+import { resolveDefaultConfigPath } from "./install-cli.js";
+async function runDoctor(opts = {}) {
+  const cfgPath = opts.configPath ?? resolveDefaultConfigPath();
+  const credsPath = opts.credentialsPath ?? credentialsFilePath;
+  const checks = [];
+  checks.push(checkNodeVersion());
+  const cfgExists = existsSync(cfgPath);
+  checks.push({
+    name: "claude_desktop_config exists",
+    status: cfgExists ? "pass" : "fail",
+    detail: cfgExists ? cfgPath : `Not found at ${cfgPath}. Run: npx mcp-google-ads-install`
+  });
+  let cfg = null;
+  let cfgParseOk = false;
+  if (cfgExists) {
+    try {
+      cfg = JSON.parse(readFileSync(cfgPath, "utf8") || "{}");
+      cfgParseOk = true;
+    } catch (err) {
+      cfgParseOk = false;
+    }
+    checks.push({
+      name: "claude_desktop_config is valid JSON",
+      status: cfgParseOk ? "pass" : "fail",
+      detail: cfgParseOk ? "parsed ok" : `${cfgPath} is not valid JSON. Fix syntax or delete the file and re-run mcp-google-ads-install.`
+    });
+  } else {
+    checks.push({
+      name: "claude_desktop_config is valid JSON",
+      status: "fail",
+      detail: "config file missing \u2014 cannot check JSON validity"
+    });
+  }
+  const mcpServers = cfgParseOk && cfg && typeof cfg === "object" ? cfg.mcpServers ?? {} : {};
+  const registered = Boolean(mcpServers["google-ads"]);
+  checks.push({
+    name: "google-ads registered in claude_desktop_config",
+    status: registered ? "pass" : "fail",
+    detail: registered ? "entry present under mcpServers.google-ads" : "not registered. Run: npx mcp-google-ads-install"
+  });
+  const credsExist = existsSync(credsPath);
+  checks.push({
+    name: "credentials file exists",
+    status: credsExist ? "pass" : "fail",
+    detail: credsExist ? credsPath : `Not found at ${credsPath}. Run: npx mcp-google-ads-auth`
+  });
+  let creds = {};
+  if (credsExist) {
+    try {
+      creds = JSON.parse(readFileSync(credsPath, "utf8"));
+    } catch {
+    }
+  }
+  const hasRefresh = typeof creds.refresh_token === "string" && creds.refresh_token.length > 0;
+  const hasCustomerId = typeof creds.customer_id === "string" && creds.customer_id.length > 0;
+  checks.push({
+    name: "credentials file has refresh_token and customer_id",
+    status: hasRefresh && hasCustomerId ? "pass" : credsExist ? "fail" : "warn",
+    detail: credsExist ? hasRefresh && hasCustomerId ? "both fields present" : "missing required fields. Re-run: npx mcp-google-ads-auth" : "credentials file missing \u2014 cannot check"
+  });
+  const customerId = typeof creds.customer_id === "string" ? creds.customer_id : "";
+  const mccId = typeof creds.mcc_customer_id === "string" ? creds.mcc_customer_id : "";
+  const isMccTerminal = customerId.length > 0 && customerId === mccId;
+  checks.push({
+    name: "customer_id is a leaf account, not an MCC",
+    status: !hasCustomerId ? "warn" : isMccTerminal ? "warn" : "pass",
+    detail: !hasCustomerId ? "customer_id missing \u2014 cannot check" : isMccTerminal ? `customer_id (${customerId}) equals mcc_customer_id \u2014 this is a Manager account. Most tools need a leaf. Re-run: npx mcp-google-ads-auth and pick a client under the MCC.` : `leaf account (customer_id=${customerId}${mccId ? `, under MCC ${mccId}` : ", direct access"})`
+  });
+  return checks;
+}
+function checkNodeVersion() {
+  const match = process.version.match(/^v(\d+)\./);
+  const major = match ? parseInt(match[1], 10) : 0;
+  return {
+    name: "node version >= 18",
+    status: major >= 18 ? "pass" : "fail",
+    detail: major >= 18 ? process.version : `${process.version} is too old. Install Node 18+ from https://nodejs.org/`
+  };
+}
+function renderChecks(checks) {
+  const icon = (s) => s === "pass" ? "\u2713" : s === "warn" ? "\u26A0" : "\u2717";
+  const lines = ["", "mcp-google-ads \u2014 diagnostic", ""];
+  for (const c of checks) {
+    lines.push(`  ${icon(c.status)} ${c.name}`);
+    lines.push(`      ${c.detail}`);
+  }
+  const failed = checks.filter((c) => c.status === "fail").length;
+  const warned = checks.filter((c) => c.status === "warn").length;
+  lines.push("");
+  if (failed === 0 && warned === 0) {
+    lines.push("All checks passed. If Claude Desktop still shows the MCP as disconnected,");
+    lines.push("fully quit Claude Desktop (Cmd+Q) and reopen it.");
+  } else {
+    lines.push(`${failed} failure${failed === 1 ? "" : "s"}, ${warned} warning${warned === 1 ? "" : "s"}. See details above.`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function parseArgs(argv) {
+  const out = { help: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--help" || a === "-h") out.help = true;
+    else if (a === "--config" && argv[i + 1]) out.configPath = argv[++i];
+    else if (a === "--credentials" && argv[i + 1]) out.credentialsPath = argv[++i];
+  }
+  return out;
+}
+async function run(argv = process.argv.slice(2)) {
+  const args = parseArgs(argv);
+  if (args.help) {
+    process.stderr.write("mcp-google-ads-doctor \u2014 diagnose Claude Desktop + Google Ads MCP setup\n");
+    return 0;
+  }
+  const checks = await runDoctor(args);
+  process.stdout.write(renderChecks(checks));
+  return checks.some((c) => c.status === "fail") ? 1 : 0;
+}
+import { fileURLToPath } from "url";
+import { realpathSync } from "fs";
+function isMainModule() {
+  if (!process.argv[1]) return false;
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+if (isMainModule()) {
+  run().then((code) => process.exit(code)).catch((err) => {
+    process.stderr.write(`
+\u274C ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  });
+}
+export {
+  run,
+  runDoctor
+};
+//# sourceMappingURL=doctor-cli.js.map

package/dist/install-cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+interface InstallOptions {
+    configPath?: string;
+    customerId?: string;
+}
+export declare function resolveDefaultConfigPath(): string;
+export declare function installIntoConfig(opts?: InstallOptions): {
+    path: string;
+    existed: boolean;
+};
+export declare function run(argv?: string[]): Promise<void>;
+export {};

package/dist/install-cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir, platform } from "os";
+import { dirname, join } from "path";
+function resolveDefaultConfigPath() {
+  const home = homedir();
+  switch (platform()) {
+    case "darwin":
+      return join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    case "win32":
+      return join(process.env.APPDATA || join(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+    default:
+      return join(home, ".config", "Claude", "claude_desktop_config.json");
+  }
+}
+function installIntoConfig(opts = {}) {
+  const configPath = opts.configPath ?? resolveDefaultConfigPath();
+  const existed = existsSync(configPath);
+  let config = {};
+  if (existed) {
+    const raw = readFileSync(configPath, "utf8");
+    if (raw.trim().length > 0) {
+      try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+          config = parsed;
+        }
+      } catch {
+        throw new Error(
+          `Claude Desktop config at ${configPath} is not valid JSON. Refusing to overwrite. Open the file, fix the syntax (or delete it to start fresh), and re-run.`
+        );
+      }
+    }
+  } else {
+    mkdirSync(dirname(configPath), { recursive: true });
+  }
+  const normalizedCustomerId = opts.customerId?.replace(/-/g, "");
+  const entry = {
+    command: "npx",
+    args: ["-y", "mcp-google-ads@latest"]
+  };
+  if (normalizedCustomerId) {
+    entry.env = { GOOGLE_ADS_CUSTOMER_ID: normalizedCustomerId };
+  }
+  const nextConfig = {
+    ...config,
+    mcpServers: {
+      ...config.mcpServers ?? {},
+      "google-ads": entry
+    }
+  };
+  writeFileSync(configPath, JSON.stringify(nextConfig, null, 2) + "\n", { mode: 420 });
+  return { path: configPath, existed };
+}
+function parseArgs(argv) {
+  const out = { help: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--help" || a === "-h") out.help = true;
+    else if (a === "--customer-id" && argv[i + 1]) out.customerId = argv[++i];
+    else if (a === "--config" && argv[i + 1]) out.configPath = argv[++i];
+  }
+  return out;
+}
+function printHelp() {
+  process.stderr.write(
+    [
+      "mcp-google-ads-install  \u2014  add mcp-google-ads to Claude Desktop config",
+      "",
+      "Usage:",
+      "  npx mcp-google-ads-install",
+      "  npx mcp-google-ads-install --customer-id 745-851-7309",
+      "",
+      "Options:",
+      "  --customer-id <id>   Pin the customer ID in the config (skips auth picker later)",
+      "  --config <path>      Override the default Claude Desktop config path",
+      "  -h, --help           Show this help",
+      "",
+      `Default config path: ${resolveDefaultConfigPath()}`,
+      ""
+    ].join("\n")
+  );
+}
+async function run(argv = process.argv.slice(2)) {
+  const args = parseArgs(argv);
+  if (args.help) {
+    printHelp();
+    return;
+  }
+  const result = installIntoConfig(args);
+  process.stdout.write(
+    [
+      "",
+      `\u2713 ${result.existed ? "Updated" : "Created"}: ${result.path}`,
+      "",
+      "Next steps:",
+      "  1. Fully quit Claude Desktop (Cmd+Q on macOS, not just close the window).",
+      "  2. Reopen Claude Desktop.",
+      "  3. If you haven't authenticated yet, run: npx mcp-google-ads-auth",
+      ""
+    ].join("\n")
+  );
+}
+import { fileURLToPath } from "url";
+import { realpathSync } from "fs";
+function isMainModule() {
+  if (!process.argv[1]) return false;
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+if (isMainModule()) {
+  run().catch((err) => {
+    process.stderr.write(`
+\u274C ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  });
+}
+export {
+  installIntoConfig,
+  resolveDefaultConfigPath,
+  run
+};
+//# sourceMappingURL=install-cli.js.map

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "mcp-google-ads",
   "mcpName": "io.github.mharnett/google-ads",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "MCP server for Google Ads API with MCC support, 36 tools for campaign management, reporting, and optimization -- now includes Demand Gen campaign creation end-to-end. Safe by default -- all changes created PAUSED.",
   "main": "dist/index.js",
   "bin": {
     "mcp-google-ads": "dist/index.js",
-    "mcp-google-ads-auth": "dist/auth-cli.js"
+    "mcp-google-ads-auth": "dist/auth-cli.js",
+    "mcp-google-ads-install": "dist/install-cli.js",
+    "mcp-google-ads-doctor": "dist/doctor-cli.js"
   },
   "types": "dist/index.d.ts",
   "type": "module",
@@ -14,6 +16,18 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./auth-cli": {
+      "import": "./dist/auth-cli.js",
+      "types": "./dist/auth-cli.d.ts"
+    },
+    "./install-cli": {
+      "import": "./dist/install-cli.js",
+      "types": "./dist/install-cli.d.ts"
+    },
+    "./doctor-cli": {
+      "import": "./dist/doctor-cli.js",
+      "types": "./dist/doctor-cli.d.ts"
     }
   },
   "files": [