@yoryoboy/bi-mcp 1.0.1

package/dist/src/tools/google-ads/scaling-health.js

@@ -0,0 +1,174 @@
+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 googleAdsScalingHealthSchema = 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."),
+  targetCpa: z.number().positive().optional().describe("Optional maximum acceptable CPA for the business.")
+});
+async function googleAdsScalingHealthHandler(params) {
+  try {
+    const customerId = resolveGoogleAdsCustomerId(params.customerId);
+    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
+    const developerToken = resolveGoogleAdsDeveloperToken();
+    const overviewResult = 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 campaignsResult = await searchGoogleAds(
+      customerId,
+      [
+        "SELECT",
+        "campaign.name,",
+        "metrics.cost_micros,",
+        "metrics.conversions_value,",
+        "metrics.conversions",
+        "FROM campaign",
+        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,
+        "AND campaign.status = 'ENABLED'",
+        "ORDER BY metrics.cost_micros DESC"
+      ].join(" "),
+      developerToken,
+      loginCustomerId
+    );
+    const seriesResult = await 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 overviewRow = overviewResult.rows[0] ?? {};
+    const cost = microsToCurrency(getFieldValue(overviewRow, "metrics.costMicros"));
+    const conversions = round(
+      parseGoogleAdsMetricValue(getFieldValue(overviewRow, "metrics.conversions"))
+    );
+    const conversionValue = round(
+      parseGoogleAdsMetricValue(getFieldValue(overviewRow, "metrics.conversionsValue"))
+    );
+    const clicks = parseGoogleAdsMetricValue(getFieldValue(overviewRow, "metrics.clicks"));
+    const currentRoas = round(conversionValue / cost);
+    const currentCpa = round(cost / conversions);
+    const campaignCosts = campaignsResult.rows.map(
+      (row) => microsToCurrency(getFieldValue(row, "metrics.costMicros"))
+    );
+    const topCampaignCostShare = round(toPercent(campaignCosts[0] ?? 0, cost));
+    const series = seriesResult.rows.map((row) => ({
+      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)
+    );
+    let score = 0;
+    if (currentRoas >= params.breakEvenRoas) score += 35;
+    else if (currentRoas >= params.breakEvenRoas * 0.8) score += 20;
+    if (!params.targetCpa || currentCpa > 0 && currentCpa <= params.targetCpa) score += 20;
+    else if (params.targetCpa && currentCpa <= params.targetCpa * 1.2) score += 10;
+    if (topCampaignCostShare < 50) score += 20;
+    else if (topCampaignCostShare < 70) score += 10;
+    if (secondHalfRoas >= firstHalfRoas * 0.9) score += 15;
+    else if (secondHalfRoas >= firstHalfRoas * 0.75) score += 8;
+    if (conversions >= 10) score += 10;
+    else if (conversions >= 5) score += 5;
+    const status = score >= 75 ? "ready_to_scale" : score >= 50 ? "scale_with_caution" : "not_ready";
+    return object(
+      stripNulls({
+        customer_id: customerId,
+        login_customer_id: loginCustomerId,
+        customer_name: getFieldValue(overviewRow, "customer.descriptiveName"),
+        currency_code: getFieldValue(overviewRow, "customer.currencyCode"),
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        inputs: {
+          break_even_roas: params.breakEvenRoas,
+          target_cpa: params.targetCpa
+        },
+        overview: {
+          cost,
+          clicks,
+          conversions,
+          conversion_value: conversionValue,
+          current_roas: currentRoas,
+          current_cpa: currentCpa,
+          top_campaign_cost_share_percent: topCampaignCostShare,
+          first_half_roas: firstHalfRoas,
+          second_half_roas: secondHalfRoas,
+          scaling_health_score: score,
+          scaling_health_status: status
+        },
+        checks: {
+          above_break_even: currentRoas >= params.breakEvenRoas,
+          cpa_within_target: params.targetCpa ? currentCpa <= params.targetCpa : void 0,
+          concentration_acceptable: topCampaignCostShare < 70,
+          recent_efficiency_stable: secondHalfRoas >= firstHalfRoas * 0.9,
+          conversion_volume_acceptable: conversions >= 5
+        },
+        interpretation: {
+          status,
+          message: status === "ready_to_scale" ? "The account shows enough efficiency and stability to test scaling." : status === "scale_with_caution" ? "The account has mixed signals. Scale only with tight monitoring." : "The account is not ready to scale without increasing risk."
+        },
+        metadata: {
+          request_ids: [overviewResult.requestId, campaignsResult.requestId, seriesResult.requestId]
+        }
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to evaluate Google Ads scaling health"
+    );
+  }
+}
+export {
+  googleAdsScalingHealthHandler,
+  googleAdsScalingHealthSchema
+};
+//# sourceMappingURL=scaling-health.js.map

package/dist/src/tools/google-ads/scaling-health.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/google-ads/scaling-health.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\nexport const googleAdsScalingHealthSchema = 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.\"),\n  targetCpa: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\"Optional maximum acceptable CPA for the business.\"),\n});\n\nexport async function googleAdsScalingHealthHandler(\n  params: z.infer<typeof googleAdsScalingHealthSchema>\n) {\n  try {\n    const customerId = resolveGoogleAdsCustomerId(params.customerId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n\n    const overviewResult = 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    const campaignsResult = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"campaign.name,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions_value,\",\n        \"metrics.conversions\",\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    const seriesResult = await 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    const overviewRow = overviewResult.rows[0] ?? {};\n    const cost = microsToCurrency(getFieldValue(overviewRow, \"metrics.costMicros\"));\n    const conversions = round(\n      parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.conversions\"))\n    );\n    const conversionValue = round(\n      parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.conversionsValue\"))\n    );\n    const clicks = parseGoogleAdsMetricValue(getFieldValue(overviewRow, \"metrics.clicks\"));\n    const currentRoas = round(conversionValue / cost);\n    const currentCpa = round(cost / conversions);\n\n    const campaignCosts = campaignsResult.rows.map((row) =>\n      microsToCurrency(getFieldValue(row, \"metrics.costMicros\"))\n    );\n    const topCampaignCostShare = round(toPercent(campaignCosts[0] ?? 0, cost));\n\n    const series = seriesResult.rows.map((row) => ({\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    let score = 0;\n    if (currentRoas >= params.breakEvenRoas) score += 35;\n    else if (currentRoas >= params.breakEvenRoas * 0.8) score += 20;\n\n    if (!params.targetCpa || (currentCpa > 0 && currentCpa <= params.targetCpa)) score += 20;\n    else if (params.targetCpa && currentCpa <= params.targetCpa * 1.2) score += 10;\n\n    if (topCampaignCostShare < 50) score += 20;\n    else if (topCampaignCostShare < 70) score += 10;\n\n    if (secondHalfRoas >= firstHalfRoas * 0.9) score += 15;\n    else if (secondHalfRoas >= firstHalfRoas * 0.75) score += 8;\n\n    if (conversions >= 10) score += 10;\n    else if (conversions >= 5) score += 5;\n\n    const status =\n      score >= 75 ? \"ready_to_scale\" : score >= 50 ? \"scale_with_caution\" : \"not_ready\";\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(overviewRow, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(overviewRow, \"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          cost,\n          clicks,\n          conversions,\n          conversion_value: conversionValue,\n          current_roas: currentRoas,\n          current_cpa: currentCpa,\n          top_campaign_cost_share_percent: topCampaignCostShare,\n          first_half_roas: firstHalfRoas,\n          second_half_roas: secondHalfRoas,\n          scaling_health_score: score,\n          scaling_health_status: status,\n        },\n        checks: {\n          above_break_even: currentRoas >= params.breakEvenRoas,\n          cpa_within_target: params.targetCpa ? currentCpa <= params.targetCpa : undefined,\n          concentration_acceptable: topCampaignCostShare < 70,\n          recent_efficiency_stable: secondHalfRoas >= firstHalfRoas * 0.9,\n          conversion_volume_acceptable: conversions >= 5,\n        },\n        interpretation: {\n          status,\n          message:\n            status === \"ready_to_scale\"\n              ? \"The account shows enough efficiency and stability to test scaling.\"\n              : status === \"scale_with_caution\"\n                ? \"The account has mixed signals. Scale only with tight monitoring.\"\n                : \"The account is not ready to scale without increasing risk.\",\n        },\n        metadata: {\n          request_ids: [overviewResult.requestId, campaignsResult.requestId, seriesResult.requestId],\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to evaluate Google Ads scaling health\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/google-ads/search-terms-summary.js

@@ -0,0 +1,131 @@
+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 googleAdsSearchTermsSummarySchema = 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."
+  ),
+  limit: z.number().int().min(1).max(50).optional().default(20).describe("Maximum number of search terms to return, ordered by spend descending.")
+});
+async function googleAdsSearchTermsSummaryHandler(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,",
+        "search_term_view.search_term,",
+        "campaign.id,",
+        "campaign.name,",
+        "ad_group.id,",
+        "ad_group.name,",
+        "metrics.impressions,",
+        "metrics.clicks,",
+        "metrics.cost_micros,",
+        "metrics.conversions,",
+        "metrics.conversions_value",
+        "FROM search_term_view",
+        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,
+        "AND metrics.impressions > 0",
+        "ORDER BY metrics.cost_micros DESC",
+        `LIMIT ${params.limit}`
+      ].join(" "),
+      developerToken,
+      loginCustomerId
+    );
+    const searchTerms = 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 {
+        search_term: getFieldValue(row, "searchTermView.searchTerm"),
+        campaign_id: getFieldValue(row, "campaign.id"),
+        campaign_name: getFieldValue(row, "campaign.name"),
+        ad_group_id: getFieldValue(row, "adGroup.id"),
+        ad_group_name: getFieldValue(row, "adGroup.name"),
+        impressions,
+        clicks,
+        cost,
+        conversions,
+        conversion_value: conversionValue,
+        ctr_percent: round(toPercent(clicks, impressions)),
+        cpa: round(cost / conversions),
+        roas: round(conversionValue / cost)
+      };
+    });
+    const totals = searchTerms.reduce(
+      (acc, item) => {
+        acc.impressions += item.impressions;
+        acc.clicks += item.clicks;
+        acc.cost += item.cost;
+        acc.conversions += item.conversions;
+        acc.conversion_value += item.conversion_value;
+        return acc;
+      },
+      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }
+    );
+    return object(
+      stripNulls({
+        customer_id: customerId,
+        login_customer_id: loginCustomerId,
+        customer_name: getFieldValue(result.rows[0] ?? {}, "customer.descriptiveName"),
+        currency_code: getFieldValue(result.rows[0] ?? {}, "customer.currencyCode"),
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        overview: {
+          returned_terms: searchTerms.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)),
+          cpa: round(totals.cost / totals.conversions),
+          roas: round(totals.conversion_value / totals.cost),
+          top_term_by_cost: searchTerms[0]?.search_term
+        },
+        search_terms: searchTerms,
+        metadata: {
+          row_count: result.rows.length,
+          request_id: result.requestId
+        }
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to fetch Google Ads search terms summary"
+    );
+  }
+}
+export {
+  googleAdsSearchTermsSummaryHandler,
+  googleAdsSearchTermsSummarySchema
+};
+//# sourceMappingURL=search-terms-summary.js.map

package/dist/src/tools/google-ads/search-terms-summary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/google-ads/search-terms-summary.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\nexport const googleAdsSearchTermsSummarySchema = 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  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(50)\n    .optional()\n    .default(20)\n    .describe(\"Maximum number of search terms to return, ordered by spend descending.\"),\n});\n\nexport async function googleAdsSearchTermsSummaryHandler(\n  params: z.infer<typeof googleAdsSearchTermsSummarySchema>\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        \"search_term_view.search_term,\",\n        \"campaign.id,\",\n        \"campaign.name,\",\n        \"ad_group.id,\",\n        \"ad_group.name,\",\n        \"metrics.impressions,\",\n        \"metrics.clicks,\",\n        \"metrics.cost_micros,\",\n        \"metrics.conversions,\",\n        \"metrics.conversions_value\",\n        \"FROM search_term_view\",\n        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,\n        \"AND metrics.impressions > 0\",\n        \"ORDER BY metrics.cost_micros DESC\",\n        `LIMIT ${params.limit}`,\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const searchTerms = 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        search_term: getFieldValue(row, \"searchTermView.searchTerm\"),\n        campaign_id: getFieldValue(row, \"campaign.id\"),\n        campaign_name: getFieldValue(row, \"campaign.name\"),\n        ad_group_id: getFieldValue(row, \"adGroup.id\"),\n        ad_group_name: getFieldValue(row, \"adGroup.name\"),\n        impressions,\n        clicks,\n        cost,\n        conversions,\n        conversion_value: conversionValue,\n        ctr_percent: round(toPercent(clicks, impressions)),\n        cpa: round(cost / conversions),\n        roas: round(conversionValue / cost),\n      };\n    });\n\n    const totals = searchTerms.reduce(\n      (acc, item) => {\n        acc.impressions += item.impressions;\n        acc.clicks += item.clicks;\n        acc.cost += item.cost;\n        acc.conversions += item.conversions;\n        acc.conversion_value += item.conversion_value;\n        return acc;\n      },\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\n    );\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        overview: {\n          returned_terms: searchTerms.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          cpa: round(totals.cost / totals.conversions),\n          roas: round(totals.conversion_value / totals.cost),\n          top_term_by_cost: searchTerms[0]?.search_term,\n        },\n        search_terms: searchTerms,\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 search terms summary\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/google-ads/time-series.js

@@ -0,0 +1,126 @@
+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 googleAdsTimeSeriesGranularityEnum = z.enum(["daily", "weekly"]);
+const googleAdsTimeSeriesSchema = 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."
+  ),
+  granularity: googleAdsTimeSeriesGranularityEnum.optional().default("daily").describe("Time series granularity: daily or weekly.")
+});
+async function googleAdsTimeSeriesHandler(params) {
+  try {
+    const customerId = resolveGoogleAdsCustomerId(params.customerId);
+    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
+    const developerToken = resolveGoogleAdsDeveloperToken();
+    const segmentField = params.granularity === "weekly" ? "segments.week" : "segments.date";
+    const result = await searchGoogleAds(
+      customerId,
+      [
+        "SELECT",
+        "customer.descriptive_name,",
+        "customer.currency_code,",
+        `${segmentField},`,
+        "metrics.impressions,",
+        "metrics.clicks,",
+        "metrics.cost_micros,",
+        "metrics.conversions,",
+        "metrics.conversions_value",
+        "FROM customer",
+        `WHERE segments.date BETWEEN '${params.startDate}' AND '${params.endDate}'`,
+        `ORDER BY ${segmentField}`
+      ].join(" "),
+      developerToken,
+      loginCustomerId
+    );
+    const series = 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 {
+        period_start: String(
+          getFieldValue(
+            row,
+            params.granularity === "weekly" ? "segments.week" : "segments.date"
+          ) ?? ""
+        ),
+        impressions,
+        clicks,
+        cost,
+        conversions,
+        conversion_value: conversionValue,
+        ctr_percent: round(toPercent(clicks, impressions)),
+        cpa: round(cost / conversions),
+        roas: round(conversionValue / cost)
+      };
+    });
+    const totals = series.reduce(
+      (acc, item) => {
+        acc.impressions += item.impressions;
+        acc.clicks += item.clicks;
+        acc.cost += item.cost;
+        acc.conversions += item.conversions;
+        acc.conversion_value += item.conversion_value;
+        return acc;
+      },
+      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }
+    );
+    return object(
+      stripNulls({
+        customer_id: customerId,
+        login_customer_id: loginCustomerId,
+        customer_name: getFieldValue(result.rows[0] ?? {}, "customer.descriptiveName"),
+        currency_code: getFieldValue(result.rows[0] ?? {}, "customer.currencyCode"),
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        granularity: params.granularity,
+        overview: {
+          periods: series.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)),
+          cpa: round(totals.cost / totals.conversions),
+          roas: round(totals.conversion_value / totals.cost)
+        },
+        series,
+        metadata: {
+          row_count: result.rows.length,
+          request_id: result.requestId
+        }
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to fetch Google Ads time series");
+  }
+}
+export {
+  googleAdsTimeSeriesHandler,
+  googleAdsTimeSeriesSchema
+};
+//# sourceMappingURL=time-series.js.map

package/dist/src/tools/google-ads/time-series.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/google-ads/time-series.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 googleAdsTimeSeriesGranularityEnum = z.enum([\"daily\", \"weekly\"]);\n\nexport const googleAdsTimeSeriesSchema = 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  granularity: googleAdsTimeSeriesGranularityEnum\n    .optional()\n    .default(\"daily\")\n    .describe(\"Time series granularity: daily or weekly.\"),\n});\n\nexport async function googleAdsTimeSeriesHandler(\n  params: z.infer<typeof googleAdsTimeSeriesSchema>\n) {\n  try {\n    const customerId = resolveGoogleAdsCustomerId(params.customerId);\n    const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n    const developerToken = resolveGoogleAdsDeveloperToken();\n    const segmentField = params.granularity === \"weekly\" ? \"segments.week\" : \"segments.date\";\n\n    const result = await searchGoogleAds(\n      customerId,\n      [\n        \"SELECT\",\n        \"customer.descriptive_name,\",\n        \"customer.currency_code,\",\n        `${segmentField},`,\n        \"metrics.impressions,\",\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        `ORDER BY ${segmentField}`,\n      ].join(\" \"),\n      developerToken,\n      loginCustomerId\n    );\n\n    const series = 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        period_start: String(\n          getFieldValue(\n            row,\n            params.granularity === \"weekly\" ? \"segments.week\" : \"segments.date\"\n          ) ?? \"\"\n        ),\n        impressions,\n        clicks,\n        cost,\n        conversions,\n        conversion_value: conversionValue,\n        ctr_percent: round(toPercent(clicks, impressions)),\n        cpa: round(cost / conversions),\n        roas: round(conversionValue / cost),\n      };\n    });\n\n    const totals = series.reduce(\n      (acc, item) => {\n        acc.impressions += item.impressions;\n        acc.clicks += item.clicks;\n        acc.cost += item.cost;\n        acc.conversions += item.conversions;\n        acc.conversion_value += item.conversion_value;\n        return acc;\n      },\n      { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\n    );\n\n    return object(\n      stripNulls({\n        customer_id: customerId,\n        login_customer_id: loginCustomerId,\n        customer_name: getFieldValue(result.rows[0] ?? {}, \"customer.descriptiveName\"),\n        currency_code: getFieldValue(result.rows[0] ?? {}, \"customer.currencyCode\"),\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        granularity: params.granularity,\n        overview: {\n          periods: series.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          cpa: round(totals.cost / totals.conversions),\n          roas: round(totals.conversion_value / totals.cost),\n        },\n        series,\n        metadata: {\n          row_count: result.rows.length,\n          request_id: result.requestId,\n        },\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to fetch Google Ads time series\");\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/index.js

@@ -0,0 +1,5 @@
+export * from "./vtex/index.js";
+export * from "./analytics/index.js";
+export * from "./google-ads/index.js";
+export * from "./search-console/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/tools/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/index.ts"],
+  "sourcesContent": ["export * from \"./vtex/index.js\";\nexport * from \"./analytics/index.js\";\nexport * from \"./google-ads/index.js\";\nexport * from \"./search-console/index.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/src/tools/search-console/country-breakdown.js

@@ -0,0 +1,85 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  buildSearchConsoleQueryBody,
+  endDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  sumSearchConsoleRows,
+  toPercent,
+  normalizeSearchConsoleRow,
+  round
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleCountryBreakdownSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  queryContains: z.string().optional().describe("Optional query substring filter."),
+  pageContains: z.string().optional().describe("Optional page substring filter.")
+});
+async function searchConsoleCountryBreakdownHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const dimensionFilters = [];
+    if (params.queryContains?.trim()) {
+      dimensionFilters.push({
+        dimension: "query",
+        operator: "contains",
+        expression: params.queryContains.trim()
+      });
+    }
+    if (params.pageContains?.trim()) {
+      dimensionFilters.push({
+        dimension: "page",
+        operator: "contains",
+        expression: params.pageContains.trim()
+      });
+    }
+    const response = await querySearchConsolePerformance(
+      siteUrl,
+      buildSearchConsoleQueryBody({
+        startDate: params.startDate,
+        endDate: params.endDate,
+        dimensions: ["country"],
+        searchType: params.searchType,
+        dimensionFilters
+      })
+    );
+    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, ["country"]));
+    const totals = sumSearchConsoleRows(rows);
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        country_breakdown: rows.map((row) => ({
+          country: row.dimensions.country,
+          clicks: row.clicks,
+          impressions: row.impressions,
+          ctr_percent: row.ctr_percent,
+          position: row.position,
+          impression_share_percent: round(toPercent(row.impressions, totals.impressions), 2),
+          click_share_percent: round(toPercent(row.clicks, totals.clicks), 2)
+        }))
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to fetch Search Console country breakdown"
+    );
+  }
+}
+export {
+  searchConsoleCountryBreakdownHandler,
+  searchConsoleCountryBreakdownSchema
+};
+//# sourceMappingURL=country-breakdown.js.map

package/dist/src/tools/search-console/country-breakdown.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/country-breakdown.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildSearchConsoleQueryBody,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  sumSearchConsoleRows,\n  toPercent,\n  normalizeSearchConsoleRow,\n  round,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleCountryBreakdownSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  queryContains: z.string().optional().describe(\"Optional query substring filter.\"),\n  pageContains: z.string().optional().describe(\"Optional page substring filter.\"),\n});\n\nexport async function searchConsoleCountryBreakdownHandler(\n  params: z.infer<typeof searchConsoleCountryBreakdownSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const dimensionFilters = [];\n\n    if (params.queryContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"query\",\n        operator: \"contains\",\n        expression: params.queryContains.trim(),\n      });\n    }\n\n    if (params.pageContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"contains\",\n        expression: params.pageContains.trim(),\n      });\n    }\n\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"country\"],\n        searchType: params.searchType,\n        dimensionFilters,\n      })\n    );\n\n    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, [\"country\"]));\n    const totals = sumSearchConsoleRows(rows);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        country_breakdown: rows.map((row) => ({\n          country: row.dimensions.country,\n          clicks: row.clicks,\n          impressions: row.impressions,\n          ctr_percent: row.ctr_percent,\n          position: row.position,\n          impression_share_percent: round(toPercent(row.impressions, totals.impressions), 2),\n          click_share_percent: round(toPercent(row.clicks, totals.clicks), 2),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console country breakdown\"\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,sCAAsC,EAAE,OAAO;AAAA,EAC1D,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAChF,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iCAAiC;AAChF,CAAC;AAED,eAAsB,qCACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,mBAAmB,CAAC;AAE1B,QAAI,OAAO,eAAe,KAAK,GAAG;AAChC,uBAAiB,KAAK;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,QACV,YAAY,OAAO,cAAc,KAAK;AAAA,MACxC,CAAC;AAAA,IACH;AAEA,QAAI,OAAO,cAAc,KAAK,GAAG;AAC/B,uBAAiB,KAAK;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,QACV,YAAY,OAAO,aAAa,KAAK;AAAA,MACvC,CAAC;AAAA,IACH;AAEA,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA,4BAA4B;AAAA,QAC1B,WAAW,OAAO;AAAA,QAClB,SAAS,OAAO;AAAA,QAChB,YAAY,CAAC,SAAS;AAAA,QACtB,YAAY,OAAO;AAAA,QACnB;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,0BAA0B,KAAK,CAAC,SAAS,CAAC,CAAC;AAC3F,UAAM,SAAS,qBAAqB,IAAI;AAExC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,mBAAmB,KAAK,IAAI,CAAC,SAAS;AAAA,UACpC,SAAS,IAAI,WAAW;AAAA,UACxB,QAAQ,IAAI;AAAA,UACZ,aAAa,IAAI;AAAA,UACjB,aAAa,IAAI;AAAA,UACjB,UAAU,IAAI;AAAA,UACd,0BAA0B,MAAM,UAAU,IAAI,aAAa,OAAO,WAAW,GAAG,CAAC;AAAA,UACjF,qBAAqB,MAAM,UAAU,IAAI,QAAQ,OAAO,MAAM,GAAG,CAAC;AAAA,QACpE,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
+  "names": []
+}