mobile-growth-mcp 2.0.6 → 2.1.2

package/dist/index.js

@@ -116,9 +116,9 @@ async function getRemotePrompt(apiKey2, name, args) {
   return resp.result?.messages ?? [];
 }
 function registerFetchedPrompts(server2, apiKey2, prompts) {
-  for (const prompt of prompts) {
+  for (const prompt2 of prompts) {
     const zodShape = {};
-    for (const arg of prompt.arguments) {
+    for (const arg of prompt2.arguments) {
       let field = z.string().describe(arg.description);
       if (!arg.required) {
         field = field.optional();
@@ -126,13 +126,13 @@ function registerFetchedPrompts(server2, apiKey2, prompts) {
       zodShape[arg.name] = field;
     }
     server2.prompt(
-      prompt.name,
-      prompt.description,
+      prompt2.name,
+      prompt2.description,
       zodShape,
       async (args) => {
         const messages = await getRemotePrompt(
           apiKey2,
-          prompt.name,
+          prompt2.name,
           args
         );
         return {
@@ -160,7 +160,7 @@ function getMetaAccessToken() {
   const token = process.env.META_ACCESS_TOKEN;
   if (!token) {
     throw new Error(
-      "Missing META_ACCESS_TOKEN environment variable. Provide a Meta Marketing API access token to use Meta tools."
+      'Missing META_ACCESS_TOKEN. To fix, add it to your MCP config:\n  \u2022 Claude Code / Cursor: add "META_ACCESS_TOKEN": "..." to the "env" block in .mcp.json\n  \u2022 Claude Desktop: add "META_ACCESS_TOKEN": "..." to the "env" block in claude_desktop_config.json\n  \u2022 CLI: add META_ACCESS_TOKEN=... to a .env file in your working directory\nThen restart your MCP client.'
     );
   }
   return token;
@@ -819,6 +819,216 @@ ${text}`;
   );
 }
 
+// src/tools/google-campaigns.ts
+import { z as z7 } from "zod";
+
+// src/google/oauth.ts
+var TOKEN_URL = "https://oauth2.googleapis.com/token";
+var EXPIRY_SAFETY_MARGIN_MS = 6e4;
+function createGoogleAdsAuth(config) {
+  let cached;
+  async function refreshAccessToken() {
+    const body = new URLSearchParams({
+      grant_type: "refresh_token",
+      client_id: config.clientId,
+      client_secret: config.clientSecret,
+      refresh_token: config.refreshToken
+    });
+    const response = await fetch(TOKEN_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body: body.toString()
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `Google OAuth token refresh failed (${response.status}): ${text}. Your refresh token may be expired \u2014 run \`npx mobile-growth-mcp auth google\` to re-authorize.`
+      );
+    }
+    const data = await response.json();
+    return {
+      accessToken: data.access_token,
+      expiresAt: Date.now() + data.expires_in * 1e3 - EXPIRY_SAFETY_MARGIN_MS
+    };
+  }
+  async function getAccessToken() {
+    if (!cached || Date.now() >= cached.expiresAt) {
+      cached = await refreshAccessToken();
+    }
+    return cached.accessToken;
+  }
+  async function getHeaders(customerId) {
+    const token = await getAccessToken();
+    const headers = {
+      Authorization: `Bearer ${token}`,
+      "developer-token": config.developerToken
+    };
+    if (config.loginCustomerId) {
+      headers["login-customer-id"] = config.loginCustomerId.replace(/-/g, "");
+    }
+    return headers;
+  }
+  return { getAccessToken, getHeaders };
+}
+
+// src/google/client.ts
+var API_VERSION = "v19";
+var BASE_URL = `https://googleads.googleapis.com/${API_VERSION}`;
+var authSingleton;
+function getGoogleAdsAuth() {
+  if (authSingleton) return authSingleton;
+  const developerToken = process.env.GOOGLE_ADS_DEVELOPER_TOKEN;
+  const clientId = process.env.GOOGLE_ADS_CLIENT_ID;
+  const clientSecret = process.env.GOOGLE_ADS_CLIENT_SECRET;
+  const refreshToken = process.env.GOOGLE_ADS_REFRESH_TOKEN;
+  const loginCustomerId = process.env.GOOGLE_ADS_LOGIN_CUSTOMER_ID;
+  if (!developerToken || !clientId || !clientSecret || !refreshToken) {
+    throw new Error(
+      'Google Ads is not configured. To fix:\n  1. Run `npx mobile-growth-mcp auth google` to set up credentials (saves to .env)\n  2. Or add GOOGLE_ADS_* vars to the "env" block in your MCP config (.mcp.json or claude_desktop_config.json)\nThen restart your MCP client.'
+    );
+  }
+  const config = {
+    developerToken,
+    clientId,
+    clientSecret,
+    refreshToken,
+    loginCustomerId
+  };
+  authSingleton = createGoogleAdsAuth(config);
+  return authSingleton;
+}
+function normalizeCustomerId(customerId) {
+  return customerId.replace(/-/g, "");
+}
+function isGoogleAdsError(body) {
+  return typeof body === "object" && body !== null && "error" in body && typeof body.error?.message === "string";
+}
+function formatGoogleAdsError(err) {
+  const code = err.code;
+  if (code === 401) {
+    return "Authentication error: Your Google Ads credentials are invalid or expired. Run `npx mobile-growth-mcp auth google` to re-authorize.";
+  }
+  if (code === 403) {
+    return `Permission denied: ${err.message}. Check that your developer token is approved and the account ID is correct.`;
+  }
+  if (code === 429) {
+    return `Rate limit hit: ${err.message}. Wait a few minutes before retrying.`;
+  }
+  if (code === 400 && err.details?.length) {
+    const gaqlErrors = err.details.flatMap((d) => d.errors ?? []).map((e) => e.message).join("; ");
+    if (gaqlErrors) {
+      return `Invalid query: ${gaqlErrors}`;
+    }
+  }
+  return `Google Ads API error (${code}): ${err.message}`;
+}
+async function googleAdsQuery(customerId, query) {
+  const auth = getGoogleAdsAuth();
+  const normalizedId = normalizeCustomerId(customerId);
+  const headers = await auth.getHeaders(normalizedId);
+  const url = `${BASE_URL}/customers/${normalizedId}/googleAds:searchStream`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      ...headers,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ query })
+  });
+  const body = await response.json();
+  if (!response.ok) {
+    if (isGoogleAdsError(body)) {
+      throw new Error(formatGoogleAdsError(body.error));
+    }
+    throw new Error(
+      `Google Ads API returned ${response.status}: ${JSON.stringify(body)}`
+    );
+  }
+  if (Array.isArray(body)) {
+    return body;
+  }
+  return [body];
+}
+
+// src/tools/google-campaigns.ts
+function registerGetGoogleAdsCampaigns(server2) {
+  server2.tool(
+    "get_google_ads_campaigns",
+    "List campaigns from a Google Ads account with key metrics. Requires Google Ads credentials \u2014 run `npx mobile-growth-mcp auth google` to set up.",
+    {
+      customer_id: z7.string().describe("Google Ads customer ID (e.g. 123-456-7890 or 1234567890)"),
+      status: z7.enum(["ENABLED", "PAUSED", "REMOVED"]).optional().describe("Filter by campaign status. Default: ENABLED"),
+      limit: z7.number().min(1).max(1e3).optional().describe("Max campaigns to return (default 50)")
+    },
+    async ({ customer_id, status: status2, limit }) => {
+      try {
+        const statusFilter = status2 ?? "ENABLED";
+        const rowLimit = limit ?? 50;
+        const query = `
+          SELECT
+            campaign.id,
+            campaign.name,
+            campaign.status,
+            campaign.advertising_channel_type,
+            campaign.bidding_strategy_type,
+            metrics.impressions,
+            metrics.clicks,
+            metrics.cost_micros,
+            metrics.conversions,
+            metrics.ctr,
+            metrics.average_cpc
+          FROM campaign
+          WHERE campaign.status = '${statusFilter}'
+            AND segments.date DURING LAST_7_DAYS
+          ORDER BY metrics.cost_micros DESC
+          LIMIT ${rowLimit}
+        `;
+        const chunks = await googleAdsQuery(customer_id, query);
+        const rows = chunks.flatMap((c) => c.results ?? []);
+        if (rows.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No ${statusFilter.toLowerCase()} campaigns found for customer ${customer_id} in the last 7 days.`
+              }
+            ]
+          };
+        }
+        let text = `Found ${rows.length} ${statusFilter.toLowerCase()} campaigns (last 7 days):
+
+`;
+        for (const row of rows) {
+          const c = row.campaign;
+          const m = row.metrics;
+          if (!c) continue;
+          const cost = m?.costMicros ? `$${(parseInt(m.costMicros) / 1e6).toFixed(2)}` : "$0.00";
+          const impressions = m?.impressions ?? "0";
+          const clicks = m?.clicks ?? "0";
+          const conversions = m?.conversions !== void 0 ? m.conversions.toFixed(1) : "0";
+          const ctr = m?.ctr !== void 0 ? `${(m.ctr * 100).toFixed(2)}%` : "\u2014";
+          const avgCpc = m?.averageCpc ? `$${(parseInt(m.averageCpc) / 1e6).toFixed(2)}` : "\u2014";
+          text += `- **${c.name}** (${c.id})
+  Status: ${c.status}` + (c.advertisingChannelType ? ` | Channel: ${c.advertisingChannelType}` : "") + (c.biddingStrategyType ? ` | Bidding: ${c.biddingStrategyType}` : "") + `
+  Spend: ${cost} | Impr: ${impressions} | Clicks: ${clicks} | CTR: ${ctr} | Avg CPC: ${avgCpc} | Conv: ${conversions}
+`;
+        }
+        return { content: [{ type: "text", text }] };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error: ${err instanceof Error ? err.message : String(err)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/tools/connection-status.ts
 function registerConnectionStatus(server2, status2) {
   server2.tool(
@@ -859,9 +1069,40 @@ function registerConnectionStatus(server2, status2) {
           "",
           "### How to fix",
           "Provide your Meta access token using one of these methods:",
-          "1. CLI argument: add `--meta-token=...` to the args array",
-          '2. Environment variable: add `"META_ACCESS_TOKEN": "..."` to the env block',
-          "3. `.env` file: add `META_ACCESS_TOKEN=...` to your `.env` file"
+          '1. MCP config: add `"META_ACCESS_TOKEN": "..."` to the `"env"` block in `.mcp.json` (Claude Code/Cursor) or `claude_desktop_config.json` (Claude Desktop)',
+          "2. CLI argument: add `--meta-token=...` to the args array",
+          "3. `.env` file: add `META_ACCESS_TOKEN=...` to a `.env` file in your working directory",
+          "",
+          "Then restart your MCP client."
+        );
+      }
+      lines.push("");
+      if (status2.google.configured) {
+        lines.push(
+          "## Google Ads API: Configured",
+          "- Google Ads tools are available and ready to use"
+        );
+      } else {
+        lines.push(
+          "## Google Ads API: Not Configured",
+          "- Google Ads tools will return an error when called",
+          `- Missing: ${status2.google.missing.join(", ")}`,
+          "",
+          "### How to fix",
+          "Option 1 \u2014 Interactive setup (recommended):",
+          "```",
+          "npx mobile-growth-mcp auth google",
+          "```",
+          "This walks you through developer token, OAuth credentials, and authorization. Saves to `.env`.",
+          "",
+          'Option 2 \u2014 Add credentials manually to the `"env"` block in your MCP config:',
+          "- `GOOGLE_ADS_DEVELOPER_TOKEN`",
+          "- `GOOGLE_ADS_CLIENT_ID`",
+          "- `GOOGLE_ADS_CLIENT_SECRET`",
+          "- `GOOGLE_ADS_REFRESH_TOKEN`",
+          "- `GOOGLE_ADS_LOGIN_CUSTOMER_ID` (optional, for MCC accounts)",
+          "",
+          "Then restart your MCP client."
         );
       }
       return {
@@ -983,6 +1224,19 @@ function registerVocabularyResource(server2) {
 // src/resources/instructions.ts
 var INSTRUCTIONS = `# Mobile Growth MCP \u2014 Knowledge Base + Meta Ad Tools
 
+## Welcome
+
+You're connected to the Mobile Growth knowledge base \u2014 curated expert insights on mobile advertising, campaign optimization, and subscription app growth.
+
+**The knowledge base is always on.** Use \`search_insights\` freely \u2014 before making recommendations, when diagnosing issues, or exploring strategies. The more specific your query, the better the results.
+
+Quick examples:
+- "subscription app creative fatigue signals"
+- "Meta CBO vs ABO tradeoffs for subscription apps"
+- "iOS attribution strategies post-ATT"
+
+If you can't find what you need, call \`submit_feedback\` to report the gap \u2014 it helps us improve the knowledge base.
+
 ## What This Is
 A curated knowledge base of mobile advertising insights + direct Meta Marketing API integration. Query expert knowledge, pull live campaign data, and run pre-built reports \u2014 all from your LLM.
 
@@ -1004,6 +1258,12 @@ Browse all insights with optional filtering. Returns titles and metadata.
 Fetch the full content of a specific insight by ID or slug.
 - **id** (required): Numeric ID or string slug (e.g. "mb-li-001")
 
+### submit_feedback
+Report a gap in the knowledge base or a missing capability. Helps improve the product.
+- **category** (required): missing_knowledge, missing_feature, search_quality, or other
+- **summary** (required): What was needed but not available (anonymized \u2014 no account IDs or tokens)
+- **search_queries_tried** (optional): Search queries that returned poor/no results
+
 ## Meta Marketing API Tools
 
 **Requires META_ACCESS_TOKEN env var** \u2014 without it, these tools return a clear error. Knowledge base tools work with just API_KEY.
@@ -1047,6 +1307,16 @@ Built-in report: detect creative fatigue via frequency, CTR decline, CPA trends.
 - **frequency_critical** (optional): default 5
 - **ctr_decline_threshold** (optional): default 30%
 
+## Google Ads Tools
+
+**Requires Google Ads credentials** \u2014 run \`npx mobile-growth-mcp auth google\` to set up interactively. This walks you through developer token, OAuth app, and authorization. Credentials are saved to \`.env\` and never leave the user's machine.
+
+### get_google_ads_campaigns
+List campaigns from a Google Ads account with key metrics (last 7 days).
+- **customer_id** (required): Google Ads customer ID (e.g. "123-456-7890")
+- **status** (optional): Filter by status \u2014 ENABLED, PAUSED, or REMOVED (default: ENABLED)
+- **limit** (optional): Max campaigns to return (default 50)
+
 ## Reports (MCP Prompts)
 
 Pre-built analysis workflows. Select a prompt and provide your ad_account_id to run:
@@ -1069,6 +1339,15 @@ Pre-built analysis workflows. Select a prompt and provide your ad_account_id to
 ### vocabulary://tags
 Lists all topic tags, applies_to tags, and platforms with counts.
 
+## Presenting Results
+
+When your response draws on knowledge base results, **always attribute visibly** so the user knows the value came from the curated KB, not your general training data:
+
+- **Tell the user** the information comes from the Mobile Growth knowledge base (e.g. "According to the Mobile Growth KB\u2026" or "The knowledge base recommends\u2026")
+- **Cite source author + slug** for key claims (e.g. "\u2026(source: Eric Seufert, \`mb-li-001\`)")
+- **When multiple insights support a recommendation**, mention the count (e.g. "3 insights in the KB agree that\u2026")
+- **Distinguish KB-sourced advice from your own reasoning** \u2014 if you're adding your own analysis on top of KB results, make that clear (e.g. "The KB covers X; based on that, my suggestion is Y")
+
 ## Tips
 - Start with \`list_insights\` to see what's in the knowledge base
 - Use \`search_insights\` to find specific advice grounded in expert knowledge
@@ -1101,6 +1380,16 @@ function buildStatusSection(status2) {
       "  - Fix: provide your token via `--meta-token=...` CLI arg, `META_ACCESS_TOKEN` env var, or `.env` file"
     );
   }
+  if (status2.google.configured) {
+    lines.push("- **Google Ads API**: Configured");
+  } else {
+    lines.push(
+      "- **Google Ads API**: Not configured \u2014 Google Ads tools will return errors"
+    );
+    lines.push(
+      "  - Fix: run `npx mobile-growth-mcp auth google` to set up credentials"
+    );
+  }
   return lines.join("\n");
 }
 function registerInstructionsResource(server2, status2) {
@@ -1180,12 +1469,316 @@ function resolveApiKey() {
 function resolveMetaToken() {
   return resolve("META_ACCESS_TOKEN", "meta-token");
 }
+function resolveGoogleAdsConfig() {
+  const devToken = resolve("GOOGLE_ADS_DEVELOPER_TOKEN", "google-dev-token");
+  const clientId = resolve("GOOGLE_ADS_CLIENT_ID", "google-client-id");
+  const clientSecret = resolve("GOOGLE_ADS_CLIENT_SECRET", "google-client-secret");
+  const refreshToken = resolve("GOOGLE_ADS_REFRESH_TOKEN", "google-refresh-token");
+  const loginCustomerId = resolve("GOOGLE_ADS_LOGIN_CUSTOMER_ID", "google-login-customer-id");
+  const required = [
+    { name: "GOOGLE_ADS_DEVELOPER_TOKEN", result: devToken },
+    { name: "GOOGLE_ADS_CLIENT_ID", result: clientId },
+    { name: "GOOGLE_ADS_CLIENT_SECRET", result: clientSecret },
+    { name: "GOOGLE_ADS_REFRESH_TOKEN", result: refreshToken }
+  ];
+  const missing = required.filter((r) => !r.result.value).map((r) => r.name);
+  const sources = {};
+  for (const r of required) {
+    sources[r.name] = r.result.source;
+  }
+  sources["GOOGLE_ADS_LOGIN_CUSTOMER_ID"] = loginCustomerId.source;
+  return {
+    configured: missing.length === 0,
+    missing,
+    sources,
+    developerToken: devToken.value,
+    clientId: clientId.value,
+    clientSecret: clientSecret.value,
+    refreshToken: refreshToken.value,
+    loginCustomerId: loginCustomerId.value
+  };
+}
+
+// src/google/auth.ts
+import { createInterface } from "readline";
+import { createServer } from "http";
+import { exec } from "child_process";
+import { readFileSync as readFileSync2, appendFileSync, writeFileSync } from "fs";
+import { join as join2 } from "path";
+var OAUTH_PORT = 8549;
+var REDIRECT_URI = `http://localhost:${OAUTH_PORT}/callback`;
+var AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth";
+var TOKEN_URL2 = "https://oauth2.googleapis.com/token";
+var SCOPE = "https://www.googleapis.com/auth/adwords";
+async function maybeRunAuthCommand() {
+  const args = process.argv.slice(2);
+  if (args[0] !== "auth" || args[1] !== "google") return;
+  await runGoogleAuthFlow();
+  process.exit(0);
+}
+function prompt(rl, question) {
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => resolve2(answer.trim()));
+  });
+}
+function openBrowser(url) {
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? `open "${url}"` : platform === "win32" ? `start "" "${url}"` : `xdg-open "${url}"`;
+  exec(cmd, (err) => {
+    if (err) {
+      console.error(`  Could not open browser automatically.`);
+      console.error(`  Open this URL manually:
+  ${url}`);
+    }
+  });
+}
+function getDotEnvPath() {
+  return join2(process.cwd(), ".env");
+}
+function readExistingEnv() {
+  try {
+    const content = readFileSync2(getDotEnvPath(), "utf-8");
+    const vars = {};
+    for (const line of content.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const eq = trimmed.indexOf("=");
+      if (eq === -1) continue;
+      vars[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim();
+    }
+    return vars;
+  } catch {
+    return {};
+  }
+}
+function saveToEnv(vars) {
+  const envPath = getDotEnvPath();
+  const existing = readExistingEnv();
+  const overwritten = [];
+  for (const key of Object.keys(vars)) {
+    if (existing[key]) {
+      overwritten.push(key);
+    }
+  }
+  if (overwritten.length > 0) {
+    console.log(`
+  Overwriting existing keys: ${overwritten.join(", ")}`);
+    let content;
+    try {
+      content = readFileSync2(envPath, "utf-8");
+    } catch {
+      content = "";
+    }
+    const lines = content.split("\n");
+    const updated = /* @__PURE__ */ new Set();
+    for (let i = 0; i < lines.length; i++) {
+      const trimmed = lines[i].trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const eq = trimmed.indexOf("=");
+      if (eq === -1) continue;
+      const key = trimmed.slice(0, eq).trim();
+      if (key in vars) {
+        lines[i] = `${key}=${vars[key]}`;
+        updated.add(key);
+      }
+    }
+    for (const [key, value] of Object.entries(vars)) {
+      if (!updated.has(key)) {
+        lines.push(`${key}=${value}`);
+      }
+    }
+    writeFileSync(envPath, lines.join("\n"));
+  } else {
+    const block = Object.entries(vars).map(([k, v]) => `${k}=${v}`).join("\n");
+    let prefix = "\n";
+    try {
+      const existing2 = readFileSync2(envPath, "utf-8");
+      if (existing2.length > 0 && !existing2.endsWith("\n")) {
+        prefix = "\n\n";
+      } else if (existing2.endsWith("\n")) {
+        prefix = "";
+      }
+    } catch {
+      prefix = "";
+    }
+    appendFileSync(envPath, `${prefix}${block}
+`);
+  }
+}
+async function waitForOAuthCallback(clientId, clientSecret) {
+  return new Promise((resolve2, reject) => {
+    const server2 = createServer(
+      async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://localhost:${OAUTH_PORT}`);
+        if (url.pathname !== "/callback") {
+          res.writeHead(404);
+          res.end("Not found");
+          return;
+        }
+        const code = url.searchParams.get("code");
+        const error = url.searchParams.get("error");
+        if (error) {
+          res.writeHead(200, { "Content-Type": "text/html" });
+          res.end(
+            "<html><body><h2>Authorization failed</h2><p>You can close this tab.</p></body></html>"
+          );
+          server2.close();
+          reject(new Error(`OAuth authorization denied: ${error}`));
+          return;
+        }
+        if (!code) {
+          res.writeHead(400, { "Content-Type": "text/html" });
+          res.end(
+            "<html><body><h2>Missing authorization code</h2></body></html>"
+          );
+          return;
+        }
+        try {
+          const tokenBody = new URLSearchParams({
+            code,
+            client_id: clientId,
+            client_secret: clientSecret,
+            redirect_uri: REDIRECT_URI,
+            grant_type: "authorization_code"
+          });
+          const tokenRes = await fetch(TOKEN_URL2, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: tokenBody.toString()
+          });
+          if (!tokenRes.ok) {
+            const text = await tokenRes.text();
+            throw new Error(`Token exchange failed (${tokenRes.status}): ${text}`);
+          }
+          const tokenData = await tokenRes.json();
+          if (!tokenData.refresh_token) {
+            throw new Error(
+              "No refresh token received. Make sure prompt=consent is set and try again."
+            );
+          }
+          res.writeHead(200, { "Content-Type": "text/html" });
+          res.end(
+            "<html><body><h2>Success!</h2><p>You can close this tab and return to the terminal.</p></body></html>"
+          );
+          server2.close();
+          resolve2({ refreshToken: tokenData.refresh_token });
+        } catch (err) {
+          res.writeHead(500, { "Content-Type": "text/html" });
+          res.end(
+            "<html><body><h2>Token exchange failed</h2><p>Check the terminal for details.</p></body></html>"
+          );
+          server2.close();
+          reject(err);
+        }
+      }
+    );
+    server2.listen(OAUTH_PORT, () => {
+    });
+    server2.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        reject(
+          new Error(
+            `Port ${OAUTH_PORT} is already in use. Close the process using it and try again.`
+          )
+        );
+      } else {
+        reject(err);
+      }
+    });
+  });
+}
+async function runGoogleAuthFlow() {
+  console.log("\nGoogle Ads Setup");
+  console.log("================\n");
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    console.log("Step 1: Developer token");
+    console.log("  (Found in Google Ads \u2192 Tools \u2192 API Center)\n");
+    const developerToken = await prompt(rl, "  Developer token: ");
+    if (!developerToken) {
+      console.error("\n  Developer token is required.");
+      return;
+    }
+    const loginCustomerId = await prompt(
+      rl,
+      "  MCC account ID (optional, press Enter to skip): "
+    );
+    console.log("\nStep 2: OAuth credentials");
+    console.log(
+      "  (Create in Google Cloud Console \u2192 APIs & Services \u2192 Credentials)\n"
+    );
+    console.log(`  Redirect URI to register: ${REDIRECT_URI}
+`);
+    const clientId = await prompt(rl, "  Client ID: ");
+    if (!clientId) {
+      console.error("\n  Client ID is required.");
+      return;
+    }
+    const clientSecret = await prompt(rl, "  Client secret: ");
+    if (!clientSecret) {
+      console.error("\n  Client secret is required.");
+      return;
+    }
+    rl.close();
+    console.log("\nStep 3: Authorization");
+    const authParams = new URLSearchParams({
+      client_id: clientId,
+      redirect_uri: REDIRECT_URI,
+      response_type: "code",
+      scope: SCOPE,
+      access_type: "offline",
+      prompt: "consent"
+    });
+    const authUrl = `${AUTH_URL}?${authParams.toString()}`;
+    console.log("  Opening browser...\n");
+    openBrowser(authUrl);
+    console.log(`  If the browser didn't open, visit:
+  ${authUrl}
+`);
+    const { refreshToken } = await waitForOAuthCallback(clientId, clientSecret);
+    const envVars = {
+      GOOGLE_ADS_DEVELOPER_TOKEN: developerToken,
+      GOOGLE_ADS_CLIENT_ID: clientId,
+      GOOGLE_ADS_CLIENT_SECRET: clientSecret,
+      GOOGLE_ADS_REFRESH_TOKEN: refreshToken
+    };
+    if (loginCustomerId) {
+      envVars.GOOGLE_ADS_LOGIN_CUSTOMER_ID = loginCustomerId;
+    }
+    saveToEnv(envVars);
+    console.log(`
+\u2713 Saved to .env. Restart your MCP client to use Google Ads tools.`);
+  } catch (err) {
+    console.error(
+      `
+Error: ${err instanceof Error ? err.message : String(err)}`
+    );
+    process.exit(1);
+  } finally {
+    rl.close();
+  }
+}
 
 // src/index.ts
+await maybeRunAuthCommand();
 var apiKeyResult = resolveApiKey();
 var metaTokenResult = resolveMetaToken();
+var googleAdsResult = resolveGoogleAdsConfig();
 if (apiKeyResult.value) process.env.API_KEY = apiKeyResult.value;
 if (metaTokenResult.value) process.env.META_ACCESS_TOKEN = metaTokenResult.value;
+if (googleAdsResult.developerToken)
+  process.env.GOOGLE_ADS_DEVELOPER_TOKEN = googleAdsResult.developerToken;
+if (googleAdsResult.clientId)
+  process.env.GOOGLE_ADS_CLIENT_ID = googleAdsResult.clientId;
+if (googleAdsResult.clientSecret)
+  process.env.GOOGLE_ADS_CLIENT_SECRET = googleAdsResult.clientSecret;
+if (googleAdsResult.refreshToken)
+  process.env.GOOGLE_ADS_REFRESH_TOKEN = googleAdsResult.refreshToken;
+if (googleAdsResult.loginCustomerId)
+  process.env.GOOGLE_ADS_LOGIN_CUSTOMER_ID = googleAdsResult.loginCustomerId;
 var apiKey = apiKeyResult.value;
 console.error(
   apiKey ? `API key: ${apiKeyResult.source}` : "API key: not configured \u2014 KB tools will not be available"
@@ -1193,6 +1786,9 @@ console.error(
 console.error(
   metaTokenResult.value ? `Meta token: ${metaTokenResult.source}` : "Meta token: not configured \u2014 Meta tools will return errors when called"
 );
+console.error(
+  googleAdsResult.configured ? `Google Ads: configured` : `Google Ads: not configured (missing: ${googleAdsResult.missing.join(", ")}) \u2014 run \`npx mobile-growth-mcp auth google\` to set up`
+);
 var server = new McpServer({
   name: "mobile-growth-mcp",
   version: "2.0.0"
@@ -1200,6 +1796,10 @@ var server = new McpServer({
 var status = {
   kb: { connected: false, toolCount: 0, promptCount: 0 },
   meta: { tokenConfigured: !!metaTokenResult.value },
+  google: {
+    configured: googleAdsResult.configured,
+    missing: googleAdsResult.missing
+  },
   apiKey: { source: apiKeyResult.source }
 };
 if (apiKey) {
@@ -1223,6 +1823,7 @@ registerGetMetaAdSets(server);
 registerGetMetaAds(server);
 registerGetMetaInsights(server);
 registerGetMetaAdFatigue(server);
+registerGetGoogleAdsCampaigns(server);
 registerConnectionStatus(server, status);
 registerVocabularyResource(server);
 registerInstructionsResource(server, status);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mobile-growth-mcp",
-  "version": "2.0.6",
+  "version": "2.1.2",
   "description": "MCP server for mobile growth & UA knowledge base — campaign optimization, creative strategy, and subscription app insights",
   "type": "module",
   "main": "dist/index.js",
@@ -33,5 +33,13 @@
     "meta-ads",
     "subscription-apps"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kubachour/mobile-growth-mcp.git"
+  },
+  "homepage": "https://github.com/kubachour/mobile-growth-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/kubachour/mobile-growth-mcp/issues"
+  },
   "license": "MIT"
 }