@aligulzar729/google-ads-mcp 0.3.0 → 0.4.0

package/README.md

@@ -34,11 +34,13 @@ AI:   Created "Summer Sale" (PAUSED). It won't serve until you enable it.
 - [Configuration](#configuration) (and [all environment variables](#all-environment-variables))
 - [Hosted, multi-user](#hosted-multi-user) (and [LibreChat on the same host](#librechat-on-the-same-host-no-public-url))
 - [Tools](#tools)
+- [Coverage](#coverage)
 - [Big reports and pagination](#big-reports-and-pagination)
 - [Scheduled and unattended use](#scheduled-and-unattended-use)
 - [Troubleshooting](#troubleshooting)
 - [Notes](#notes)
 - [Acknowledgments](#acknowledgments)
+- [Disclaimer](#disclaimer)
 - [License](#license)
 - [Contributing](#contributing)
 
@@ -441,6 +443,14 @@ Seven tools, each takes an `action`:
 
 A few things worth knowing: ROAS is computed as conversion value over cost. Average Position is gone (Google removed it), so use `impression_share`. Performance Max has no ad-level reporting, so use `gaql` on its asset groups.
 
+## Coverage
+
+| | |
+|---|---|
+| Google Ads API version | v24.1 (via [`google-ads-api`](https://github.com/Opteo/google-ads-api), Opteo) |
+| Coverage model | Curated actions for the common workflows, plus raw GAQL over every non-sensitive report resource. Not a 1:1 mapping of the ~100 API services. |
+| Write safety | Preview-first, yes/ok confirmation, PAUSED creates, durable audit log (see [Money and safety](#money-and-safety)). |
+
 ## Big reports and pagination
 
 Reports are bounded per response and paged without hitting Google again:
@@ -477,7 +487,7 @@ Reporting is read-only and retried, so it's reliable for cron and scheduled jobs
 
 ## Notes
 
-- The underlying client, `google-ads-api` (Opteo), is the community Node library for the advertiser API; Google doesn't ship an official one. It targets API v23. The high-level query and mutate calls used here are version-agnostic, but check method signatures if you upgrade the library.
+- The underlying client, `google-ads-api` (Opteo), is the community Node library for the advertiser API; Google doesn't ship an official one. It targets API v24.1. The high-level query and mutate calls used here are version-agnostic, but check method signatures if you upgrade the library.
 - Error messages and tool text are in English.
 - See [SECURITY.md](SECURITY.md) for disclosure, residual risk, and key-compromise playbook. See [CHANGELOG.md](CHANGELOG.md) for release notes.
 
@@ -485,6 +495,10 @@ Reporting is read-only and retried, so it's reliable for cron and scheduled jobs
 
 This project is built on [`google-ads-api`](https://github.com/Opteo/google-ads-api), the community Node client for the Google Ads API maintained by the team at [Opteo](https://opteo.com). Google ships no official Node library for the advertiser API, and Opteo's package fills that gap with a well-typed, carefully maintained interface that handles the hard parts (OAuth, GAQL, mutates, and the Google Ads protobufs) so this server does not have to. A sincere thank you to the Opteo maintainers and contributors: this MCP server stands on their work.
 
+## Disclaimer
+
+This is an unofficial Google Ads API integration. It is not affiliated with, endorsed by, or supported by Google. "Google Ads" is a trademark of Google LLC. You are responsible for your account and any spend; use it within Google's API Terms of Service.
+
 ## License
 
 MIT

package/dist/index.js

@@ -4253,7 +4253,7 @@ function registerOAuthRoutes(app, broker) {
 
 // src/app.ts
 async function startHttp(config, deps) {
-  const { ads, audit, logger, store } = deps;
+  const { ads, audit, logger, store, db } = deps;
   const pageCache = new PageCache();
   const oauthLimiter = new RateLimiter(60, 6e4);
   const mcpLimiter = new RateLimiter(120, 6e4);
@@ -4284,6 +4284,68 @@ async function startHttp(config, deps) {
     return remote || "unknown";
   };
   app.get("/healthz", (c) => c.json({ status: "ok", mode: "http" }));
+  const SYNC_TABLES = ["oauth_clients", "oauth_sessions", "oauth_tokens", "audit"];
+  const syncKey = process.env.INTERNAL_SYNC_KEY;
+  const syncAuth = (c) => {
+    if (!syncKey) return false;
+    const auth = c.req.header("authorization") ?? "";
+    const token = auth.startsWith("Bearer ") ? auth.slice(7).trim() : "";
+    return token === syncKey;
+  };
+  app.get("/internal/sync", (c) => {
+    if (!syncAuth(c)) return c.json({ error: "unauthorized" }, 401);
+    if (c.req.query("rev") !== void 0) {
+      const r = db.prepare(
+        `SELECT
+           (SELECT COUNT(*) FROM oauth_clients)                     AS c,
+           (SELECT COUNT(*) FROM oauth_sessions)                    AS s,
+           (SELECT COALESCE(MAX(last_used_ts), 0) FROM oauth_sessions) AS slu,
+           (SELECT COUNT(*) FROM oauth_tokens)                      AS t,
+           (SELECT COALESCE(MAX(id), 0) FROM audit)                 AS a`
+      ).get();
+      return c.json({ rev: `${r.c}:${r.s}:${r.slu}:${r.t}:${r.a}`, maxAuditId: r.a });
+    }
+    const auditSince = Number(c.req.query("auditSince") ?? 0) || 0;
+    const maxAuditId = db.prepare("SELECT COALESCE(MAX(id), 0) AS a FROM audit").get().a;
+    const tables = {
+      oauth_clients: db.prepare("SELECT * FROM oauth_clients").all(),
+      oauth_sessions: db.prepare("SELECT * FROM oauth_sessions").all(),
+      oauth_tokens: db.prepare("SELECT * FROM oauth_tokens").all(),
+      audit: db.prepare("SELECT * FROM audit WHERE id > ?").all(auditSince)
+    };
+    return c.json({ tables, maxAuditId });
+  });
+  app.post("/internal/sync", async (c) => {
+    if (!syncAuth(c)) return c.json({ error: "unauthorized" }, 401);
+    const body = await c.req.json().catch(() => null);
+    if (!body?.tables || typeof body.tables !== "object") {
+      return c.json({ error: "expected { tables: { ... } }" }, 400);
+    }
+    db.exec("BEGIN");
+    try {
+      for (const t of SYNC_TABLES) {
+        db.prepare(`DELETE FROM ${t}`).run();
+        const rows = body.tables[t] ?? [];
+        for (const row of rows) {
+          const cols = Object.keys(row);
+          const placeholders = cols.map(() => "?").join(", ");
+          db.prepare(`INSERT INTO ${t} (${cols.join(", ")}) VALUES (${placeholders})`).run(...cols.map((k) => row[k]));
+        }
+      }
+      db.exec("COMMIT");
+    } catch (e) {
+      db.exec("ROLLBACK");
+      logger.error("sync", "internal sync import failed", { error: e instanceof Error ? e.message : String(e) });
+      return c.json({ error: "sync failed" }, 500);
+    }
+    logger.info("sync", "internal sync import complete", {
+      clients: body.tables.oauth_clients?.length ?? 0,
+      sessions: body.tables.oauth_sessions?.length ?? 0,
+      tokens: body.tables.oauth_tokens?.length ?? 0,
+      audit: body.tables.audit?.length ?? 0
+    });
+    return c.json({ ok: true });
+  });
   app.use("/register", async (c, next) => {
     if (!oauthLimiter.allow(`reg:${clientIp(c)}`)) return c.json({ error: "rate_limit", message: "Too many registration requests. Retry later." }, 429);
     return next();
@@ -4469,7 +4531,7 @@ async function main() {
   const db = openDb(config.auditDbPath);
   const audit = new Audit(db, logger);
   const store = new OAuthStore(db, loadEncKey(config.tokenEncKey));
-  const running = await startHttp(config, { ads, audit, logger, store });
+  const running = await startHttp(config, { ads, audit, logger, store, db });
   const shutdown = (sig) => {
     logger.info("main", `received ${sig}, shutting down`);
     const hard = setTimeout(() => process.exit(1), 8e3);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligulzar729/google-ads-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Manage Google Ads from Claude, Codex, LibreChat, or any MCP client. Natural-language reporting plus guarded campaign, keyword, and Performance Max operations.",
   "type": "module",
   "bin": {