@yoryoboy/bi-mcp 1.0.1

package/dist/src/tools/google-ads/account-risks.js

@@ -0,0 +1,267 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  dateRegex,
+  getFieldValue,
+  microsToCurrency,
+  parseGoogleAdsMetricValue,
+  resolveGoogleAdsCustomerId,
+  resolveGoogleAdsDeveloperToken,
+  resolveGoogleAdsLoginCustomerId,
+  round,
+  toPercent
+} from "../../utils/google-ads.js";
+import { searchGoogleAds } from "../../services/google-ads/google-ads-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+function buildRisk(code, severity, title, detail, metricValue) {
+  return stripNulls({
+    code,
+    severity,
+    title,
+    detail,
+    metric_value: metricValue !== void 0 ? round(metricValue) : void 0
+  });
+}
+const googleAdsAccountRisksSchema = z.object({
+  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
+  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
+  customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
+  loginCustomerId: z.string().optional().describe(
+    "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
+  )
+});
+async function googleAdsAccountRisksHandler(params) {
+  try {
+    const customerId = resolveGoogleAdsCustomerId(params.customerId);
+    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
+    const developerToken = resolveGoogleAdsDeveloperToken();
+    const [campaignsResult, channelsResult, seriesResult] = await Promise.all([
+      searchGoogleAds(
+        customerId,
+        [
+          "SELECT",
+          "customer.descriptive_name,",
+          "customer.currency_code,",
+          "campaign.id,",
+          "campaign.name,",
+          "campaign.advertising_channel_type,",
+          "metrics.impressions,",
+          "metrics.clicks,",
+          "metrics.cost_micros,",
+          "metrics.conversions,",
+          "metrics.conversions_value",
+          "FROM campaign",
+          `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,
+          "AND campaign.status = 'ENABLED'",
+          "ORDER BY metrics.cost_micros DESC"
+        ].join(" "),
+        developerToken,
+        loginCustomerId
+      ),
+      searchGoogleAds(
+        customerId,
+        [
+          "SELECT",
+          "campaign.advertising_channel_type,",
+          "metrics.cost_micros,",
+          "metrics.conversions_value",
+          "FROM campaign",
+          `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,
+          "AND campaign.status = 'ENABLED'"
+        ].join(" "),
+        developerToken,
+        loginCustomerId
+      ),
+      searchGoogleAds(
+        customerId,
+        [
+          "SELECT",
+          "segments.date,",
+          "metrics.cost_micros,",
+          "metrics.conversions_value,",
+          "metrics.conversions",
+          "FROM customer",
+          `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,
+          "ORDER BY segments.date"
+        ].join(" "),
+        developerToken,
+        loginCustomerId
+      )
+    ]);
+    const campaignRows = campaignsResult.rows.map((row) => ({
+      campaign_name: getFieldValue(row, "campaign.name"),
+      channel_type: getFieldValue(row, "campaign.advertisingChannelType"),
+      cost: microsToCurrency(getFieldValue(row, "metrics.costMicros")),
+      conversions: round(parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversions"))),
+      conversion_value: round(
+        parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversionsValue"))
+      )
+    }));
+    const totalCost = campaignRows.reduce((sum, row) => sum + row.cost, 0);
+    const totalConversions = campaignRows.reduce((sum, row) => sum + row.conversions, 0);
+    const totalConversionValue = campaignRows.reduce((sum, row) => sum + row.conversion_value, 0);
+    const topCampaign = campaignRows[0];
+    const topCampaignShare = round(toPercent(topCampaign?.cost ?? 0, totalCost));
+    const channelCosts = /* @__PURE__ */ new Map();
+    for (const row of channelsResult.rows) {
+      const channelType = String(
+        getFieldValue(row, "campaign.advertisingChannelType", "UNKNOWN") ?? "UNKNOWN"
+      );
+      channelCosts.set(
+        channelType,
+        (channelCosts.get(channelType) ?? 0) + microsToCurrency(getFieldValue(row, "metrics.costMicros"))
+      );
+    }
+    const dominantChannel = Array.from(channelCosts.entries()).sort((a, b) => b[1] - a[1])[0];
+    const dominantChannelShare = round(toPercent(dominantChannel?.[1] ?? 0, totalCost));
+    const series = seriesResult.rows.map((row) => ({
+      period_start: String(getFieldValue(row, "segments.date") ?? ""),
+      cost: microsToCurrency(getFieldValue(row, "metrics.costMicros")),
+      conversion_value: round(
+        parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversionsValue"))
+      ),
+      conversions: round(parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversions")))
+    }));
+    const midpoint = Math.ceil(series.length / 2);
+    const firstHalf = series.slice(0, midpoint);
+    const secondHalf = series.slice(midpoint);
+    const firstHalfRoas = round(
+      firstHalf.reduce((sum, item) => sum + item.conversion_value, 0) / firstHalf.reduce((sum, item) => sum + item.cost, 0)
+    );
+    const secondHalfRoas = round(
+      secondHalf.reduce((sum, item) => sum + item.conversion_value, 0) / secondHalf.reduce((sum, item) => sum + item.cost, 0)
+    );
+    const risks = [];
+    if (topCampaignShare >= 70) {
+      risks.push(
+        buildRisk(
+          "campaign_concentration_high",
+          "high",
+          "Concentraci\xF3n alta en una campa\xF1a",
+          `La campa\xF1a principal concentra ${topCampaignShare}% del gasto.`,
+          topCampaignShare
+        )
+      );
+    } else if (topCampaignShare >= 50) {
+      risks.push(
+        buildRisk(
+          "campaign_concentration_medium",
+          "medium",
+          "Concentraci\xF3n relevante en una campa\xF1a",
+          `La campa\xF1a principal concentra ${topCampaignShare}% del gasto.`,
+          topCampaignShare
+        )
+      );
+    }
+    if (dominantChannelShare >= 80) {
+      risks.push(
+        buildRisk(
+          "channel_concentration_high",
+          "high",
+          "Dependencia alta de un tipo de campa\xF1a",
+          `${dominantChannel?.[0] ?? "UNKNOWN"} concentra ${dominantChannelShare}% del gasto.`,
+          dominantChannelShare
+        )
+      );
+    } else if (dominantChannelShare >= 60) {
+      risks.push(
+        buildRisk(
+          "channel_concentration_medium",
+          "medium",
+          "Dependencia relevante de un tipo de campa\xF1a",
+          `${dominantChannel?.[0] ?? "UNKNOWN"} concentra ${dominantChannelShare}% del gasto.`,
+          dominantChannelShare
+        )
+      );
+    }
+    const overallRoas = round(totalConversionValue / totalCost);
+    if (overallRoas < 1) {
+      risks.push(
+        buildRisk(
+          "low_roas",
+          "high",
+          "ROAS por debajo de 1",
+          `El ROAS agregado es ${overallRoas}. La cuenta est\xE1 devolviendo menos valor que el gasto atribuido.`,
+          overallRoas
+        )
+      );
+    } else if (overallRoas < 1.5) {
+      risks.push(
+        buildRisk(
+          "borderline_roas",
+          "medium",
+          "ROAS ajustado al l\xEDmite",
+          `El ROAS agregado es ${overallRoas}. Hay poco margen antes de entrar en zona de riesgo.`,
+          overallRoas
+        )
+      );
+    }
+    if (totalConversions < 5) {
+      risks.push(
+        buildRisk(
+          "low_conversion_volume",
+          "medium",
+          "Volumen de conversiones bajo",
+          `La cuenta gener\xF3 ${round(totalConversions)} conversiones en el per\xEDodo. La se\xF1al estad\xEDstica es limitada.`,
+          totalConversions
+        )
+      );
+    }
+    if (firstHalf.length > 0 && secondHalf.length > 0 && secondHalfRoas < firstHalfRoas * 0.7) {
+      risks.push(
+        buildRisk(
+          "roas_deteriorating",
+          "medium",
+          "Deterioro reciente de eficiencia",
+          `El ROAS cay\xF3 de ${firstHalfRoas} en la primera mitad a ${secondHalfRoas} en la segunda mitad del per\xEDodo.`,
+          secondHalfRoas
+        )
+      );
+    }
+    const highSeverityCount = risks.filter((risk) => risk.severity === "high").length;
+    const mediumSeverityCount = risks.filter((risk) => risk.severity === "medium").length;
+    const overallSeverity = highSeverityCount > 0 ? "high" : mediumSeverityCount > 0 ? "medium" : "low";
+    return object(
+      stripNulls({
+        customer_id: customerId,
+        login_customer_id: loginCustomerId,
+        customer_name: getFieldValue(campaignsResult.rows[0] ?? {}, "customer.descriptiveName"),
+        currency_code: getFieldValue(campaignsResult.rows[0] ?? {}, "customer.currencyCode"),
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        overview: {
+          total_campaigns: campaignRows.length,
+          total_cost: round(totalCost),
+          total_conversions: round(totalConversions),
+          total_conversion_value: round(totalConversionValue),
+          roas: overallRoas,
+          top_campaign_by_cost: topCampaign?.campaign_name,
+          top_campaign_cost_share_percent: topCampaignShare,
+          dominant_channel: dominantChannel?.[0],
+          dominant_channel_cost_share_percent: dominantChannelShare,
+          first_half_roas: firstHalfRoas,
+          second_half_roas: secondHalfRoas
+        },
+        risk_summary: {
+          overall_severity: overallSeverity,
+          high_severity_count: highSeverityCount,
+          medium_severity_count: mediumSeverityCount,
+          total_risks: risks.length
+        },
+        risks,
+        metadata: {
+          request_ids: [campaignsResult.requestId, channelsResult.requestId, seriesResult.requestId]
+        }
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to evaluate Google Ads account risks");
+  }
+}
+export {
+  googleAdsAccountRisksHandler,
+  googleAdsAccountRisksSchema
+};
+//# sourceMappingURL=account-risks.js.map

package/dist/src/tools/google-ads/account-risks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/google-ads/account-risks.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\ntype RiskSeverity = \"low\" | \"medium\" | \"high\";\n\nfunction buildRisk(\n  code: string,\n  severity: RiskSeverity,\n  title: string,\n  detail: string,\n  metricValue?: number\n) {\n  return stripNulls({\n    code,\n    severity,\n    title,\n    detail,\n    metric_value: metricValue !== undefined ? round(metricValue) : undefined,\n  });\n}\n\nexport const googleAdsAccountRisksSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z\n    .string()\n    .describe(\"Google Ads customer ID to query. Accepts digits with or without hyphens.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n});\n\nexport async function googleAdsAccountRisksHandler(\n  params: z.infer<typeof googleAdsAccountRisksSchema>\n) {\n  try {\n    const customerId = resolveGoogleAdsCustomerId(params.customerId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const [campaignsResult, channelsResult, seriesResult] = await Promise.all([\n      searchGoogleAds(\n        customerId,\n        [\n          \"SELECT\",\n          \"customer.descriptive_name,\",\n          \"customer.currency_code,\",\n          \"campaign.id,\",\n          \"campaign.name,\",\n          \"campaign.advertising_channel_type,\",\n          \"metrics.impressions,\",\n          \"metrics.clicks,\",\n          \"metrics.cost_micros,\",\n          \"metrics.conversions,\",\n          \"metrics.conversions_value\",\n          \"FROM campaign\",\n          `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n          \"AND campaign.status = 'ENABLED'\",\n          \"ORDER BY metrics.cost_micros DESC\",\n        ].join(\" \"),\n        developerToken,\n        loginCustomerId\n      ),\n      searchGoogleAds(\n        customerId,\n        [\n          \"SELECT\",\n          \"campaign.advertising_channel_type,\",\n          \"metrics.cost_micros,\",\n          \"metrics.conversions_value\",\n          \"FROM campaign\",\n          `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n          \"AND campaign.status = 'ENABLED'\",\n        ].join(\" \"),\n        developerToken,\n        loginCustomerId\n      ),\n      searchGoogleAds(\n        customerId,\n        [\n          \"SELECT\",\n          \"segments.date,\",\n          \"metrics.cost_micros,\",\n          \"metrics.conversions_value,\",\n          \"metrics.conversions\",\n          \"FROM customer\",\n          `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n          \"ORDER BY segments.date\",\n        ].join(\" \"),\n        developerToken,\n        loginCustomerId\n      ),\n    ]);\n\n    const campaignRows = campaignsResult.rows.map((row) => ({\n      campaign_name: getFieldValue(row, \"campaign.name\"),\n      channel_type: getFieldValue(row, \"campaign.advertisingChannelType\"),\n      cost: microsToCurrency(getFieldValue(row, \"metrics.costMicros\")),\n      conversions: round(parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))),\n      conversion_value: round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      ),\n    }));\n\n    const totalCost = campaignRows.reduce((sum, row) => sum + row.cost, 0);\n    const totalConversions = campaignRows.reduce((sum, row) => sum + row.conversions, 0);\n    const totalConversionValue = campaignRows.reduce((sum, row) => sum + row.conversion_value, 0);\n    const topCampaign = campaignRows[0];\n    const topCampaignShare = round(toPercent(topCampaign?.cost ?? 0, totalCost));\n\n    const channelCosts = new Map<string, number>();\n    for (const row of channelsResult.rows) {\n      const channelType = String(\n        getFieldValue(row, \"campaign.advertisingChannelType\", \"UNKNOWN\") ?? \"UNKNOWN\"\n      );\n      channelCosts.set(\n        channelType,\n        (channelCosts.get(channelType) ?? 0) +\n          microsToCurrency(getFieldValue(row, \"metrics.costMicros\"))\n      );\n    }\n    const dominantChannel = Array.from(channelCosts.entries()).sort((a, b) => b[1] - a[1])[0];\n    const dominantChannelShare = round(toPercent(dominantChannel?.[1] ?? 0, totalCost));\n\n    const series = seriesResult.rows.map((row) => ({\n      period_start: String(getFieldValue(row, \"segments.date\") ?? \"\"),\n      cost: microsToCurrency(getFieldValue(row, \"metrics.costMicros\")),\n      conversion_value: round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      ),\n      conversions: round(parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))),\n    }));\n    const midpoint = Math.ceil(series.length / 2);\n    const firstHalf = series.slice(0, midpoint);\n    const secondHalf = series.slice(midpoint);\n    const firstHalfRoas = round(\n      firstHalf.reduce((sum, item) => sum + item.conversion_value, 0) /\n        firstHalf.reduce((sum, item) => sum + item.cost, 0)\n    );\n    const secondHalfRoas = round(\n      secondHalf.reduce((sum, item) => sum + item.conversion_value, 0) /\n        secondHalf.reduce((sum, item) => sum + item.cost, 0)\n    );\n\n    const risks = [];\n\n    if (topCampaignShare >= 70) {\n      risks.push(\n        buildRisk(\n          \"campaign_concentration_high\",\n          \"high\",\n          \"Concentraci\u00F3n alta en una campa\u00F1a\",\n          `La campa\u00F1a principal concentra ${topCampaignShare}% del gasto.`,\n          topCampaignShare\n        )\n      );\n    } else if (topCampaignShare >= 50) {\n      risks.push(\n        buildRisk(\n          \"campaign_concentration_medium\",\n          \"medium\",\n          \"Concentraci\u00F3n relevante en una campa\u00F1a\",\n          `La campa\u00F1a principal concentra ${topCampaignShare}% del gasto.`,\n          topCampaignShare\n        )\n      );\n    }\n\n    if (dominantChannelShare >= 80) {\n      risks.push(\n        buildRisk(\n          \"channel_concentration_high\",\n          \"high\",\n          \"Dependencia alta de un tipo de campa\u00F1a\",\n          `${dominantChannel?.[0] ?? \"UNKNOWN\"} concentra ${dominantChannelShare}% del gasto.`,\n          dominantChannelShare\n        )\n      );\n    } else if (dominantChannelShare >= 60) {\n      risks.push(\n        buildRisk(\n          \"channel_concentration_medium\",\n          \"medium\",\n          \"Dependencia relevante de un tipo de campa\u00F1a\",\n          `${dominantChannel?.[0] ?? \"UNKNOWN\"} concentra ${dominantChannelShare}% del gasto.`,\n          dominantChannelShare\n        )\n      );\n    }\n\n    const overallRoas = round(totalConversionValue / totalCost);\n    if (overallRoas < 1) {\n      risks.push(\n        buildRisk(\n          \"low_roas\",\n          \"high\",\n          \"ROAS por debajo de 1\",\n          `El ROAS agregado es ${overallRoas}. La cuenta est\u00E1 devolviendo menos valor que el gasto atribuido.`,\n          overallRoas\n        )\n      );\n    } else if (overallRoas < 1.5) {\n      risks.push(\n        buildRisk(\n          \"borderline_roas\",\n          \"medium\",\n          \"ROAS ajustado al l\u00EDmite\",\n          `El ROAS agregado es ${overallRoas}. Hay poco margen antes de entrar en zona de riesgo.`,\n          overallRoas\n        )\n      );\n    }\n\n    if (totalConversions < 5) {\n      risks.push(\n        buildRisk(\n          \"low_conversion_volume\",\n          \"medium\",\n          \"Volumen de conversiones bajo\",\n          `La cuenta gener\u00F3 ${round(totalConversions)} conversiones en el per\u00EDodo. La se\u00F1al estad\u00EDstica es limitada.`,\n          totalConversions\n        )\n      );\n    }\n\n    if (firstHalf.length > 0 && secondHalf.length > 0 && secondHalfRoas < firstHalfRoas * 0.7) {\n      risks.push(\n        buildRisk(\n          \"roas_deteriorating\",\n          \"medium\",\n          \"Deterioro reciente de eficiencia\",\n          `El ROAS cay\u00F3 de ${firstHalfRoas} en la primera mitad a ${secondHalfRoas} en la segunda mitad del per\u00EDodo.`,\n          secondHalfRoas\n        )\n      );\n    }\n\n    const highSeverityCount = risks.filter((risk) => risk.severity === \"high\").length;\n    const mediumSeverityCount = risks.filter((risk) => risk.severity === \"medium\").length;\n    const overallSeverity: RiskSeverity =\n      highSeverityCount > 0 ? \"high\" : mediumSeverityCount > 0 ? \"medium\" : \"low\";\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(campaignsResult.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(campaignsResult.rows[0] ?? {}, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          total_campaigns: campaignRows.length,\n          total_cost: round(totalCost),\n          total_conversions: round(totalConversions),\n          total_conversion_value: round(totalConversionValue),\n          roas: overallRoas,\n          top_campaign_by_cost: topCampaign?.campaign_name,\n          top_campaign_cost_share_percent: topCampaignShare,\n          dominant_channel: dominantChannel?.[0],\n          dominant_channel_cost_share_percent: dominantChannelShare,\n          first_half_roas: firstHalfRoas,\n          second_half_roas: secondHalfRoas,\n        },\n        risk_summary: {\n          overall_severity: overallSeverity,\n          high_severity_count: highSeverityCount,\n          medium_severity_count: mediumSeverityCount,\n          total_risks: risks.length,\n        },\n        risks,\n        metadata: {\n          request_ids: [campaignsResult.requestId, channelsResult.requestId, seriesResult.requestId],\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to evaluate Google Ads account risks\");\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/google-ads/break-even-analysis.js

@@ -0,0 +1,107 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  dateRegex,
+  getFieldValue,
+  microsToCurrency,
+  parseGoogleAdsMetricValue,
+  resolveGoogleAdsCustomerId,
+  resolveGoogleAdsDeveloperToken,
+  resolveGoogleAdsLoginCustomerId,
+  round
+} from "../../utils/google-ads.js";
+import { searchGoogleAds } from "../../services/google-ads/google-ads-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const googleAdsBreakEvenAnalysisSchema = z.object({
+  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
+  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
+  customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
+  loginCustomerId: z.string().optional().describe(
+    "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
+  ),
+  breakEvenRoas: z.number().positive().describe("Break-even ROAS for the business. Example: 2.5 means the account needs at least 2.5x return to break even."),
+  targetCpa: z.number().positive().optional().describe("Optional maximum acceptable CPA for the business.")
+});
+async function googleAdsBreakEvenAnalysisHandler(params) {
+  try {
+    const customerId = resolveGoogleAdsCustomerId(params.customerId);
+    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
+    const developerToken = resolveGoogleAdsDeveloperToken();
+    const result = await searchGoogleAds(
+      customerId,
+      [
+        "SELECT",
+        "customer.descriptive_name,",
+        "customer.currency_code,",
+        "metrics.clicks,",
+        "metrics.cost_micros,",
+        "metrics.conversions,",
+        "metrics.conversions_value",
+        "FROM customer",
+        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`
+      ].join(" "),
+      developerToken,
+      loginCustomerId
+    );
+    const row = result.rows[0] ?? {};
+    const clicks = parseGoogleAdsMetricValue(getFieldValue(row, "metrics.clicks"));
+    const cost = microsToCurrency(getFieldValue(row, "metrics.costMicros"));
+    const conversions = round(
+      parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversions"))
+    );
+    const conversionValue = round(
+      parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversionsValue"))
+    );
+    const currentRoas = round(conversionValue / cost);
+    const currentCpa = round(cost / conversions);
+    const roasGap = round(currentRoas - params.breakEvenRoas);
+    const roasGapPercent = round((currentRoas / params.breakEvenRoas - 1) * 100);
+    return object(
+      stripNulls({
+        customer_id: customerId,
+        login_customer_id: loginCustomerId,
+        customer_name: getFieldValue(row, "customer.descriptiveName"),
+        currency_code: getFieldValue(row, "customer.currencyCode"),
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        inputs: {
+          break_even_roas: params.breakEvenRoas,
+          target_cpa: params.targetCpa
+        },
+        overview: {
+          clicks,
+          cost,
+          conversions,
+          conversion_value: conversionValue,
+          current_roas: currentRoas,
+          current_cpa: currentCpa,
+          break_even_roas: params.breakEvenRoas,
+          roas_gap: roasGap,
+          roas_gap_percent: roasGapPercent,
+          is_above_break_even: currentRoas >= params.breakEvenRoas,
+          cpa_vs_target_gap: params.targetCpa ? round(currentCpa - params.targetCpa) : void 0,
+          is_cpa_within_target: params.targetCpa ? currentCpa > 0 && currentCpa <= params.targetCpa : void 0
+        },
+        interpretation: {
+          status: currentRoas >= params.breakEvenRoas ? "above_break_even" : "below_break_even",
+          message: currentRoas >= params.breakEvenRoas ? `The account is above break-even by ${roasGap}.` : `The account is below break-even by ${Math.abs(roasGap)}.`
+        },
+        metadata: {
+          row_count: result.rows.length,
+          request_id: result.requestId
+        }
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to run Google Ads break-even analysis"
+    );
+  }
+}
+export {
+  googleAdsBreakEvenAnalysisHandler,
+  googleAdsBreakEvenAnalysisSchema
+};
+//# sourceMappingURL=break-even-analysis.js.map

package/dist/src/tools/google-ads/break-even-analysis.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/google-ads/break-even-analysis.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const googleAdsBreakEvenAnalysisSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z\n    .string()\n    .describe(\"Google Ads customer ID to query. Accepts digits with or without hyphens.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n  breakEvenRoas: z\n    .number()\n    .positive()\n    .describe(\"Break-even ROAS for the business. Example: 2.5 means the account needs at least 2.5x return to break even.\"),\n  targetCpa: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\"Optional maximum acceptable CPA for the business.\"),\n});\n\nexport async function googleAdsBreakEvenAnalysisHandler(\n  params: z.infer<typeof googleAdsBreakEvenAnalysisSchema>\n) {\n  try {\n    const customerId = resolveGoogleAdsCustomerId(params.customerId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value\",\n        \"FROM customer\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const row = result.rows[0] ?? {};\n    const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n    const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n    const conversions = round(\n      parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n    );\n    const conversionValue = round(\n      parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n    );\n    const currentRoas = round(conversionValue / cost);\n    const currentCpa = round(cost / conversions);\n    const roasGap = round(currentRoas - params.breakEvenRoas);\n    const roasGapPercent = round((currentRoas / params.breakEvenRoas - 1) * 100);\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(row, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(row, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        inputs: {\n          break_even_roas: params.breakEvenRoas,\n          target_cpa: params.targetCpa,\n        },\n        overview: {\n          clicks,\n          cost,\n          conversions,\n          conversion_value: conversionValue,\n          current_roas: currentRoas,\n          current_cpa: currentCpa,\n          break_even_roas: params.breakEvenRoas,\n          roas_gap: roasGap,\n          roas_gap_percent: roasGapPercent,\n          is_above_break_even: currentRoas >= params.breakEvenRoas,\n          cpa_vs_target_gap: params.targetCpa ? round(currentCpa - params.targetCpa) : undefined,\n          is_cpa_within_target: params.targetCpa\n            ? currentCpa > 0 && currentCpa <= params.targetCpa\n            : undefined,\n        },\n        interpretation: {\n          status:\n            currentRoas >= params.breakEvenRoas\n              ? \"above_break_even\"\n              : \"below_break_even\",\n          message:\n            currentRoas >= params.breakEvenRoas\n              ? `The account is above break-even by ${roasGap}.`\n              : `The account is below break-even by ${Math.abs(roasGap)}.`,\n        },\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to run Google Ads break-even analysis\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/google-ads/campaign-performance.js

@@ -0,0 +1,157 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  dateRegex,
+  getFieldValue,
+  microsToCurrency,
+  parseGoogleAdsMetricValue,
+  resolveGoogleAdsCustomerId,
+  resolveGoogleAdsDeveloperToken,
+  resolveGoogleAdsLoginCustomerId,
+  round,
+  toPercent
+} from "../../utils/google-ads.js";
+import { searchGoogleAds } from "../../services/google-ads/google-ads-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const campaignStatusEnum = z.enum(["ENABLED", "PAUSED", "REMOVED"]);
+const googleAdsCampaignPerformanceSchema = z.object({
+  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
+  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
+  customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
+  loginCustomerId: z.string().optional().describe(
+    "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
+  ),
+  enabledOnly: z.boolean().optional().default(true).describe("If true, only returns enabled campaigns unless statusFilter is explicitly provided."),
+  statusFilter: z.array(campaignStatusEnum).optional().describe("Optional list of campaign statuses to include. Overrides enabledOnly when provided.")
+});
+async function googleAdsCampaignPerformanceHandler(params) {
+  try {
+    const customerId = resolveGoogleAdsCustomerId(params.customerId);
+    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
+    const developerToken = resolveGoogleAdsDeveloperToken();
+    const effectiveStatuses = params.statusFilter && params.statusFilter.length > 0 ? params.statusFilter : params.enabledOnly !== false ? ["ENABLED"] : void 0;
+    const whereClauses = [`segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`];
+    if (effectiveStatuses?.length) {
+      whereClauses.push(
+        `campaign.status IN (${effectiveStatuses.map((status) => `'${status}'`).join(", ")})`
+      );
+    }
+    const result = await searchGoogleAds(
+      customerId,
+      [
+        "SELECT",
+        "customer.descriptive_name,",
+        "customer.currency_code,",
+        "campaign.id,",
+        "campaign.name,",
+        "campaign.status,",
+        "campaign.advertising_channel_type,",
+        "metrics.impressions,",
+        "metrics.clicks,",
+        "metrics.cost_micros,",
+        "metrics.conversions,",
+        "metrics.conversions_value,",
+        "metrics.ctr,",
+        "metrics.average_cpc",
+        "FROM campaign",
+        `WHERE ${whereClauses.join(" AND ")}`,
+        "ORDER BY metrics.cost_micros DESC"
+      ].join(" "),
+      developerToken,
+      loginCustomerId
+    );
+    const campaigns = result.rows.map((row) => {
+      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, "metrics.impressions"));
+      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, "metrics.clicks"));
+      const cost = microsToCurrency(getFieldValue(row, "metrics.costMicros"));
+      const conversions = round(
+        parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversions"))
+      );
+      const conversionValue = round(
+        parseGoogleAdsMetricValue(getFieldValue(row, "metrics.conversionsValue"))
+      );
+      return {
+        campaign_id: getFieldValue(row, "campaign.id"),
+        campaign_name: getFieldValue(row, "campaign.name"),
+        status: getFieldValue(row, "campaign.status"),
+        channel_type: getFieldValue(row, "campaign.advertisingChannelType"),
+        impressions,
+        clicks,
+        cost,
+        conversions,
+        conversion_value: conversionValue,
+        ctr_percent: round(parseGoogleAdsMetricValue(getFieldValue(row, "metrics.ctr")) * 100),
+        average_cpc: microsToCurrency(getFieldValue(row, "metrics.averageCpc")),
+        cpa: round(cost / conversions),
+        roas: round(conversionValue / cost),
+        conversion_rate_percent: round(toPercent(conversions, clicks)),
+        cost_share_percent: 0
+      };
+    });
+    const totals = campaigns.reduce(
+      (acc, campaign) => {
+        acc.impressions += campaign.impressions;
+        acc.clicks += campaign.clicks;
+        acc.cost += campaign.cost;
+        acc.conversions += campaign.conversions;
+        acc.conversion_value += campaign.conversion_value;
+        return acc;
+      },
+      {
+        impressions: 0,
+        clicks: 0,
+        cost: 0,
+        conversions: 0,
+        conversion_value: 0
+      }
+    );
+    const campaignsWithShare = campaigns.map((campaign) => ({
+      ...campaign,
+      cost_share_percent: round(toPercent(campaign.cost, totals.cost))
+    }));
+    return object(
+      stripNulls({
+        customer_id: customerId,
+        login_customer_id: loginCustomerId,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        customer_name: getFieldValue(result.rows[0] ?? {}, "customer.descriptiveName"),
+        currency_code: getFieldValue(result.rows[0] ?? {}, "customer.currencyCode"),
+        applied_filters: {
+          enabled_only: params.enabledOnly !== false,
+          statuses: effectiveStatuses
+        },
+        overview: {
+          total_campaigns: campaignsWithShare.length,
+          impressions: totals.impressions,
+          clicks: totals.clicks,
+          cost: round(totals.cost),
+          conversions: round(totals.conversions),
+          conversion_value: round(totals.conversion_value),
+          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),
+          average_cpc: round(totals.cost / totals.clicks),
+          cpa: round(totals.cost / totals.conversions),
+          roas: round(totals.conversion_value / totals.cost),
+          conversion_rate_percent: round(toPercent(totals.conversions, totals.clicks)),
+          top_campaign_by_cost: campaignsWithShare[0]?.campaign_name
+        },
+        campaigns: campaignsWithShare,
+        metadata: {
+          row_count: result.rows.length,
+          request_id: result.requestId
+        }
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to fetch Google Ads campaign performance"
+    );
+  }
+}
+export {
+  googleAdsCampaignPerformanceHandler,
+  googleAdsCampaignPerformanceSchema
+};
+//# sourceMappingURL=campaign-performance.js.map

package/dist/src/tools/google-ads/campaign-performance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/google-ads/campaign-performance.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n  dateRegex,\n  getFieldValue,\n  microsToCurrency,\n  parseGoogleAdsMetricValue,\n  resolveGoogleAdsCustomerId,\n  resolveGoogleAdsDeveloperToken,\n  resolveGoogleAdsLoginCustomerId,\n  round,\n  toPercent,\n} from \"../../utils/google-ads.js\";\nimport { searchGoogleAds } from \"../../services/google-ads/google-ads-client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst campaignStatusEnum = z.enum([\"ENABLED\", \"PAUSED\", \"REMOVED\"]);\n\nexport const googleAdsCampaignPerformanceSchema = z.object({\n  startDate: z.string().regex(dateRegex).describe(\"Start date in YYYY-MM-DD format.\"),\n  endDate: z.string().regex(dateRegex).describe(\"End date in YYYY-MM-DD format.\"),\n  customerId: z.string().describe(\"Google Ads customer ID to query. Accepts digits with or without hyphens.\"),\n  loginCustomerId: z\n    .string()\n    .optional()\n    .describe(\n      \"Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured.\"\n    ),\n  enabledOnly: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe(\"If true, only returns enabled campaigns unless statusFilter is explicitly provided.\"),\n  statusFilter: z\n    .array(campaignStatusEnum)\n    .optional()\n    .describe(\"Optional list of campaign statuses to include. Overrides enabledOnly when provided.\"),\n});\n\nexport async function googleAdsCampaignPerformanceHandler(\n  params: z.infer<typeof googleAdsCampaignPerformanceSchema>\n) {\n  try {\n    const customerId = resolveGoogleAdsCustomerId(params.customerId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n    const effectiveStatuses =\n      params.statusFilter && params.statusFilter.length > 0\n        ? params.statusFilter\n        : params.enabledOnly !== false\n          ? [\"ENABLED\"]\n          : undefined;\n    const whereClauses = [`segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`];\n\n    if (effectiveStatuses?.length) {\n      whereClauses.push(\n        `campaign.status IN (${effectiveStatuses.map((status) => `'${status}'`).join(\", \")})`\n      );\n    }\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        \"campaign.id,\",\n        \"campaign.name,\",\n        \"campaign.status,\",\n        \"campaign.advertising_channel_type,\",\n        \"metrics.impressions,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value,\",\n        \"metrics.ctr,\",\n        \"metrics.average_cpc\",\n        \"FROM campaign\",\n        `WHERE ${whereClauses.join(\" AND \")}`,\n        \"ORDER BY metrics.cost_micros DESC\",\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const campaigns = result.rows.map((row) => {\n      const impressions = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\n      const clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n      const cost = microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n      const conversions = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n      );\n      const conversionValue = round(\n        parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n      );\n\n      return {\n        campaign_id: getFieldValue(row, \"campaign.id\"),\n        campaign_name: getFieldValue(row, \"campaign.name\"),\n        status: getFieldValue(row, \"campaign.status\"),\n        channel_type: getFieldValue(row, \"campaign.advertisingChannelType\"),\n        impressions,\n        clicks,\n        cost,\n        conversions,\n        conversion_value: conversionValue,\n        ctr_percent: round(parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.ctr\")) * 100),\n        average_cpc: microsToCurrency(getFieldValue(row, \"metrics.averageCpc\")),\n        cpa: round(cost / conversions),\n        roas: round(conversionValue / cost),\n        conversion_rate_percent: round(toPercent(conversions, clicks)),\n        cost_share_percent: 0,\n      };\n    });\n\n    const totals = campaigns.reduce(\n      (acc, campaign) => {\n        acc.impressions += campaign.impressions;\n        acc.clicks += campaign.clicks;\n        acc.cost += campaign.cost;\n        acc.conversions += campaign.conversions;\n        acc.conversion_value += campaign.conversion_value;\n        return acc;\n      },\n      {\n        impressions: 0,\n        clicks: 0,\n        cost: 0,\n        conversions: 0,\n        conversion_value: 0,\n      }\n    );\n    const campaignsWithShare = campaigns.map((campaign) => ({\n      ...campaign,\n      cost_share_percent: round(toPercent(campaign.cost, totals.cost)),\n    }));\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\n        applied_filters: {\n          enabled_only: params.enabledOnly !== false,\n          statuses: effectiveStatuses,\n        },\n        overview: {\n          total_campaigns: campaignsWithShare.length,\n          impressions: totals.impressions,\n          clicks: totals.clicks,\n          cost: round(totals.cost),\n          conversions: round(totals.conversions),\n          conversion_value: round(totals.conversion_value),\n          ctr_percent: round(toPercent(totals.clicks, totals.impressions)),\n          average_cpc: round(totals.cost / totals.clicks),\n          cpa: round(totals.cost / totals.conversions),\n          roas: round(totals.conversion_value / totals.cost),\n          conversion_rate_percent: round(toPercent(totals.conversions, totals.clicks)),\n          top_campaign_by_cost: campaignsWithShare[0]?.campaign_name,\n        },\n        campaigns: campaignsWithShare,\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Google Ads campaign performance\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}