mcp-google-ads 1.4.0 → 1.4.2

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "sha": "94b326c",
-  "builtAt": "2026-04-18T17:26:41.136Z",
+  "sha": "baabc65",
+  "builtAt": "2026-04-18T17:46:42.713Z",
   "embeddedSecrets": true
 }

package/dist/doctor-cli.d.ts

@@ -4,9 +4,12 @@ export interface DoctorCheck {
     status: "pass" | "fail" | "warn";
     detail: string;
 }
+export type FetchLatestVersion = () => Promise<string>;
 export interface DoctorOptions {
     configPath?: string;
     credentialsPath?: string;
+    fetchLatestVersion?: FetchLatestVersion;
+    installedVersion?: string;
 }
 export declare function runDoctor(opts?: DoctorOptions): Promise<DoctorCheck[]>;
 export declare function run(argv?: string[]): Promise<number>;

package/dist/doctor-cli.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 import { credentialsFilePath } from "./credentials.js";
 import { resolveDefaultConfigPath } from "./install-cli.js";
 async function runDoctor(opts = {}) {
@@ -69,8 +71,79 @@ async function runDoctor(opts = {}) {
     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"})`
   });
+  checks.push(await checkInstalledIsLatest(opts));
   return checks;
 }
+async function checkInstalledIsLatest(opts) {
+  const installed = opts.installedVersion ?? readInstalledVersion();
+  const fetcher = opts.fetchLatestVersion ?? fetchLatestVersionFromNpm;
+  const name = "installed version is up to date";
+  if (!installed) {
+    return { name, status: "warn", detail: "could not read installed version from package.json" };
+  }
+  let latest;
+  try {
+    latest = await fetcher();
+  } catch (err) {
+    return {
+      name,
+      status: "warn",
+      detail: `could not reach npm registry (${err instanceof Error ? err.message : String(err)}). Installed ${installed}. Skip offline.`
+    };
+  }
+  if (!latest) {
+    return { name, status: "warn", detail: `registry returned no version. Installed ${installed}.` };
+  }
+  if (installed === latest) {
+    return { name, status: "pass", detail: `${installed} (latest on npm)` };
+  }
+  if (semverLt(installed, latest)) {
+    return {
+      name,
+      status: "warn",
+      detail: `installed ${installed}, latest on npm is ${latest}. Upgrade: npx -y mcp-google-ads@latest (and fully quit + reopen Claude Desktop).`
+    };
+  }
+  return { name, status: "pass", detail: `${installed} (ahead of npm latest ${latest}; dev build?)` };
+}
+function readInstalledVersion() {
+  try {
+    const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return typeof pkg.version === "string" ? pkg.version : null;
+  } catch {
+    return null;
+  }
+}
+async function fetchLatestVersionFromNpm() {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 5e3);
+  try {
+    const res = await fetch("https://registry.npmjs.org/mcp-google-ads/latest", {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}`);
+    }
+    const body = await res.json();
+    if (typeof body.version !== "string") {
+      throw new Error("registry response missing version field");
+    }
+    return body.version;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function semverLt(a, b) {
+  const pa = a.split(".").map((x) => parseInt(x, 10) || 0);
+  const pb = b.split(".").map((x) => parseInt(x, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) < (pb[i] ?? 0)) return true;
+    if ((pa[i] ?? 0) > (pb[i] ?? 0)) return false;
+  }
+  return false;
+}
 function checkNodeVersion() {
   const match = process.version.match(/^v(\d+)\./);
   const major = match ? parseInt(match[1], 10) : 0;
@@ -119,7 +192,6 @@ async function run(argv = process.argv.slice(2)) {
   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;

package/dist/index.js

@@ -3,7 +3,7 @@ import { config as dotenvConfig } from "dotenv";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 const __moduleDir = dirname(fileURLToPath(import.meta.url));
-dotenvConfig({ path: join(__moduleDir, "..", ".env") });
+dotenvConfig({ path: join(__moduleDir, "..", ".env"), quiet: true });
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -54,7 +54,7 @@ try {
 } catch {
   console.error(`[build] ${__cliPkg.name}@${__cliPkg.version} (dev mode)`);
 }
-const __minimumSafeVersion = "1.0.5";
+const __minimumSafeVersion = "1.4.1";
 const __semverLt = (a, b) => {
   const pa = a.split(".").map(Number), pb = b.split(".").map(Number);
   for (let i = 0; i < 3; i++) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-google-ads",
   "mcpName": "io.github.mharnett/google-ads",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "MCP server for Google Ads API with MCC support, 41 tools for campaign management, reporting, and optimization. Read-only by default -- mutating tools require GOOGLE_ADS_MCP_WRITE=true. All creates/updates land PAUSED.",
   "main": "dist/index.js",
   "bin": {