@yoryoboy/bi-mcp 1.5.0 → 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/README.md +1 -2
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/mcp-use.json +2 -2
  4. package/dist/src/analytics/ga4-report-utils.js +20 -47
  5. package/dist/src/analytics/ga4-report-utils.js.map +2 -2
  6. package/dist/src/config/google-store.js +96 -0
  7. package/dist/src/config/google-store.js.map +7 -0
  8. package/dist/src/config/google.js +4 -15
  9. package/dist/src/config/google.js.map +2 -2
  10. package/dist/src/services/analytics/oauth.js +20 -7
  11. package/dist/src/services/analytics/oauth.js.map +2 -2
  12. package/dist/src/services/search-console/search-console-utils.js +49 -170
  13. package/dist/src/services/search-console/search-console-utils.js.map +2 -2
  14. package/dist/src/tools/analytics/attribution-gaps.js +3 -2
  15. package/dist/src/tools/analytics/attribution-gaps.js.map +2 -2
  16. package/dist/src/tools/analytics/channel-mix.js +3 -2
  17. package/dist/src/tools/analytics/channel-mix.js.map +2 -2
  18. package/dist/src/tools/analytics/ecommerce-tracking-health.js +3 -2
  19. package/dist/src/tools/analytics/ecommerce-tracking-health.js.map +2 -2
  20. package/dist/src/tools/analytics/engagement-overview.js +3 -2
  21. package/dist/src/tools/analytics/engagement-overview.js.map +2 -2
  22. package/dist/src/tools/analytics/property-info.js +3 -2
  23. package/dist/src/tools/analytics/property-info.js.map +2 -2
  24. package/dist/src/tools/analytics/revenue-by-channel.js +3 -2
  25. package/dist/src/tools/analytics/revenue-by-channel.js.map +2 -2
  26. package/dist/src/tools/analytics/revenue-overview.js +3 -2
  27. package/dist/src/tools/analytics/revenue-overview.js.map +2 -2
  28. package/dist/src/tools/analytics/revenue-trend.js +3 -2
  29. package/dist/src/tools/analytics/revenue-trend.js.map +2 -2
  30. package/dist/src/tools/analytics/source-medium-breakdown.js +3 -2
  31. package/dist/src/tools/analytics/source-medium-breakdown.js.map +2 -2
  32. package/dist/src/tools/analytics/top-landing-pages.js +3 -2
  33. package/dist/src/tools/analytics/top-landing-pages.js.map +2 -2
  34. package/dist/src/tools/config/list-profiles.js +23 -8
  35. package/dist/src/tools/config/list-profiles.js.map +2 -2
  36. package/dist/src/tools/google-ads/account-overview.js +3 -2
  37. package/dist/src/tools/google-ads/account-overview.js.map +2 -2
  38. package/dist/src/tools/google-ads/account-risks.js +3 -2
  39. package/dist/src/tools/google-ads/account-risks.js.map +2 -2
  40. package/dist/src/tools/google-ads/break-even-analysis.js +3 -2
  41. package/dist/src/tools/google-ads/break-even-analysis.js.map +2 -2
  42. package/dist/src/tools/google-ads/campaign-performance.js +3 -2
  43. package/dist/src/tools/google-ads/campaign-performance.js.map +2 -2
  44. package/dist/src/tools/google-ads/channel-mix.js +3 -2
  45. package/dist/src/tools/google-ads/channel-mix.js.map +2 -2
  46. package/dist/src/tools/google-ads/compare-accounts.js +1 -1
  47. package/dist/src/tools/google-ads/compare-accounts.js.map +2 -2
  48. package/dist/src/tools/google-ads/customer-clients.js +3 -2
  49. package/dist/src/tools/google-ads/customer-clients.js.map +2 -2
  50. package/dist/src/tools/google-ads/customer-info.js +3 -2
  51. package/dist/src/tools/google-ads/customer-info.js.map +2 -2
  52. package/dist/src/tools/google-ads/scaling-health.js +3 -2
  53. package/dist/src/tools/google-ads/scaling-health.js.map +2 -2
  54. package/dist/src/tools/google-ads/search-terms-summary.js +3 -2
  55. package/dist/src/tools/google-ads/search-terms-summary.js.map +2 -2
  56. package/dist/src/tools/google-ads/time-series.js +3 -2
  57. package/dist/src/tools/google-ads/time-series.js.map +2 -2
  58. package/dist/src/tools/search-console/country-breakdown.js +1 -1
  59. package/dist/src/tools/search-console/country-breakdown.js.map +2 -2
  60. package/dist/src/tools/search-console/device-breakdown.js +1 -1
  61. package/dist/src/tools/search-console/device-breakdown.js.map +2 -2
  62. package/dist/src/tools/search-console/high-impression-low-click-queries.js +1 -1
  63. package/dist/src/tools/search-console/high-impression-low-click-queries.js.map +2 -2
  64. package/dist/src/tools/search-console/low-ctr-opportunities.js +1 -1
  65. package/dist/src/tools/search-console/low-ctr-opportunities.js.map +2 -2
  66. package/dist/src/tools/search-console/page-performance.js +1 -1
  67. package/dist/src/tools/search-console/page-performance.js.map +2 -2
  68. package/dist/src/tools/search-console/product-demand-low-capture-queries.js +1 -1
  69. package/dist/src/tools/search-console/product-demand-low-capture-queries.js.map +2 -2
  70. package/dist/src/tools/search-console/query-page-matrix.js +1 -1
  71. package/dist/src/tools/search-console/query-page-matrix.js.map +2 -2
  72. package/dist/src/tools/search-console/query-performance.js +1 -1
  73. package/dist/src/tools/search-console/query-performance.js.map +2 -2
  74. package/dist/src/tools/search-console/quick-win-opportunities.js +1 -1
  75. package/dist/src/tools/search-console/quick-win-opportunities.js.map +2 -2
  76. package/dist/src/tools/search-console/rising-non-brand-queries.js +1 -1
  77. package/dist/src/tools/search-console/rising-non-brand-queries.js.map +2 -2
  78. package/dist/src/tools/search-console/search-performance.js +1 -1
  79. package/dist/src/tools/search-console/search-performance.js.map +2 -2
  80. package/dist/src/tools/search-console/site-context.js +2 -2
  81. package/dist/src/tools/search-console/site-context.js.map +2 -2
  82. package/dist/src/tools/search-console/visibility-declines.js +1 -1
  83. package/dist/src/tools/search-console/visibility-declines.js.map +2 -2
  84. package/dist/src/utils/google-ads.js +15 -26
  85. package/dist/src/utils/google-ads.js.map +2 -2
  86. package/package.json +1 -1
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/break-even-analysis.ts"],
4
- "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"],
5
- "mappings": "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",
4
+ "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 .optional()\n .describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\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"],
5
+ "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,mCAAmC,EAAE,OAAO;AAAA,EACvD,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAClF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,gCAAgC;AAAA,EAC9E,YAAY,EACT,OAAO,EACP,SAAS,EACT,SAAS,sHAAsH;AAAA,EAClI,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iFAAiF;AAAA,EAC3H,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,eAAe,EACZ,OAAO,EACP,SAAS,EACT,SAAS,4GAA4G;AAAA,EACxH,WAAW,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,mDAAmD;AACjE,CAAC;AAED,eAAsB,kCACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,MAAM,2BAA2B,OAAO,YAAY,OAAO,SAAS;AACvF,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,gCAAgC,OAAO,SAAS,UAAU,OAAO,OAAO;AAAA,MAC1E,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,OAAO,KAAK,CAAC,KAAK,CAAC;AAC/B,UAAM,SAAS,0BAA0B,cAAc,KAAK,gBAAgB,CAAC;AAC7E,UAAM,OAAO,iBAAiB,cAAc,KAAK,oBAAoB,CAAC;AACtE,UAAM,cAAc;AAAA,MAClB,0BAA0B,cAAc,KAAK,qBAAqB,CAAC;AAAA,IACrE;AACA,UAAM,kBAAkB;AAAA,MACtB,0BAA0B,cAAc,KAAK,0BAA0B,CAAC;AAAA,IAC1E;AACA,UAAM,cAAc,MAAM,kBAAkB,IAAI;AAChD,UAAM,aAAa,MAAM,OAAO,WAAW;AAC3C,UAAM,UAAU,MAAM,cAAc,OAAO,aAAa;AACxD,UAAM,iBAAiB,OAAO,cAAc,OAAO,gBAAgB,KAAK,GAAG;AAE3E,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,eAAe,cAAc,KAAK,0BAA0B;AAAA,QAC5D,eAAe,cAAc,KAAK,uBAAuB;AAAA,QACzD,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,QAAQ;AAAA,UACN,iBAAiB,OAAO;AAAA,UACxB,YAAY,OAAO;AAAA,QACrB;AAAA,QACA,UAAU;AAAA,UACR;AAAA,UACA;AAAA,UACA;AAAA,UACA,kBAAkB;AAAA,UAClB,cAAc;AAAA,UACd,aAAa;AAAA,UACb,iBAAiB,OAAO;AAAA,UACxB,UAAU;AAAA,UACV,kBAAkB;AAAA,UAClB,qBAAqB,eAAe,OAAO;AAAA,UAC3C,mBAAmB,OAAO,YAAY,MAAM,aAAa,OAAO,SAAS,IAAI;AAAA,UAC7E,sBAAsB,OAAO,YACzB,aAAa,KAAK,cAAc,OAAO,YACvC;AAAA,QACN;AAAA,QACA,gBAAgB;AAAA,UACd,QACE,eAAe,OAAO,gBAClB,qBACA;AAAA,UACN,SACE,eAAe,OAAO,gBAClB,sCAAsC,OAAO,MAC7C,sCAAsC,KAAK,IAAI,OAAO,CAAC;AAAA,QAC/D;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
6
6
  "names": []
7
7
  }
@@ -17,7 +17,8 @@ const campaignStatusEnum = z.enum(["ENABLED", "PAUSED", "REMOVED"]);
17
17
  const googleAdsCampaignPerformanceSchema = z.object({
18
18
  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
19
19
  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
20
- customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
20
+ customerId: z.string().optional().describe("Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens."),
21
+ profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped Google Ads customer ID."),
21
22
  loginCustomerId: z.string().optional().describe(
22
23
  "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
23
24
  ),
@@ -26,7 +27,7 @@ const googleAdsCampaignPerformanceSchema = z.object({
26
27
  });
27
28
  async function googleAdsCampaignPerformanceHandler(params) {
28
29
  try {
29
- const customerId = resolveGoogleAdsCustomerId(params.customerId);
30
+ const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);
30
31
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
31
32
  const developerToken = resolveGoogleAdsDeveloperToken();
32
33
  const effectiveStatuses = params.statusFilter && params.statusFilter.length > 0 ? params.statusFilter : params.enabledOnly !== false ? ["ENABLED"] : void 0;
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/campaign-performance.ts"],
4
- "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"],
5
- "mappings": "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",
4
+ "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().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\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"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -16,14 +16,15 @@ import { stripNulls } from "../../utils/strip-payload.js";
16
16
  const googleAdsChannelMixSchema = z.object({
17
17
  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
18
18
  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
19
- customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
19
+ customerId: z.string().optional().describe("Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens."),
20
+ profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped Google Ads customer ID."),
20
21
  loginCustomerId: z.string().optional().describe(
21
22
  "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
22
23
  )
23
24
  });
24
25
  async function googleAdsChannelMixHandler(params) {
25
26
  try {
26
- const customerId = resolveGoogleAdsCustomerId(params.customerId);
27
+ const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);
27
28
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
28
29
  const developerToken = resolveGoogleAdsDeveloperToken();
29
30
  const result = await searchGoogleAds(
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/channel-mix.ts"],
4
- "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 googleAdsChannelMixSchema = 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 googleAdsChannelMixHandler(\n params: z.infer<typeof googleAdsChannelMixSchema>\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 \"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\n const grouped = new Map<\n string,\n {\n channel_type: string;\n impressions: number;\n clicks: number;\n cost: number;\n conversions: number;\n conversion_value: number;\n }\n >();\n\n for (const row of result.rows) {\n const channelType = String(\n getFieldValue(row, \"campaign.advertisingChannelType\", \"UNKNOWN\") ?? \"UNKNOWN\"\n );\n const current = grouped.get(channelType) ?? {\n channel_type: channelType,\n impressions: 0,\n clicks: 0,\n cost: 0,\n conversions: 0,\n conversion_value: 0,\n };\n\n current.impressions += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\n current.clicks += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n current.cost += microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n current.conversions += round(\n parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n );\n current.conversion_value += round(\n parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n );\n\n grouped.set(channelType, current);\n }\n\n const totals = Array.from(grouped.values()).reduce(\n (acc, channel) => {\n acc.impressions += channel.impressions;\n acc.clicks += channel.clicks;\n acc.cost += channel.cost;\n acc.conversions += channel.conversions;\n acc.conversion_value += channel.conversion_value;\n return acc;\n },\n { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\n );\n\n const channels = Array.from(grouped.values())\n .map((channel) => ({\n ...channel,\n cost: round(channel.cost),\n conversions: round(channel.conversions),\n conversion_value: round(channel.conversion_value),\n ctr_percent: round(toPercent(channel.clicks, channel.impressions)),\n cost_share_percent: round(toPercent(channel.cost, totals.cost)),\n cpa: round(channel.cost / channel.conversions),\n roas: round(channel.conversion_value / channel.cost),\n }))\n .sort((a, b) => b.cost - a.cost);\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 total_channels: channels.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 dominant_channel: channels[0]?.channel_type,\n dominant_channel_cost_share_percent: channels[0]?.cost_share_percent,\n },\n channels,\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 channel mix\");\n }\n}\n"],
5
- "mappings": "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",
4
+ "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 googleAdsChannelMixSchema = 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 .optional()\n .describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 googleAdsChannelMixHandler(\n params: z.infer<typeof googleAdsChannelMixSchema>\n) {\n try {\n const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\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 \"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\n const grouped = new Map<\n string,\n {\n channel_type: string;\n impressions: number;\n clicks: number;\n cost: number;\n conversions: number;\n conversion_value: number;\n }\n >();\n\n for (const row of result.rows) {\n const channelType = String(\n getFieldValue(row, \"campaign.advertisingChannelType\", \"UNKNOWN\") ?? \"UNKNOWN\"\n );\n const current = grouped.get(channelType) ?? {\n channel_type: channelType,\n impressions: 0,\n clicks: 0,\n cost: 0,\n conversions: 0,\n conversion_value: 0,\n };\n\n current.impressions += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.impressions\"));\n current.clicks += parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n current.cost += microsToCurrency(getFieldValue(row, \"metrics.costMicros\"));\n current.conversions += round(\n parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversions\"))\n );\n current.conversion_value += round(\n parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.conversionsValue\"))\n );\n\n grouped.set(channelType, current);\n }\n\n const totals = Array.from(grouped.values()).reduce(\n (acc, channel) => {\n acc.impressions += channel.impressions;\n acc.clicks += channel.clicks;\n acc.cost += channel.cost;\n acc.conversions += channel.conversions;\n acc.conversion_value += channel.conversion_value;\n return acc;\n },\n { impressions: 0, clicks: 0, cost: 0, conversions: 0, conversion_value: 0 }\n );\n\n const channels = Array.from(grouped.values())\n .map((channel) => ({\n ...channel,\n cost: round(channel.cost),\n conversions: round(channel.conversions),\n conversion_value: round(channel.conversion_value),\n ctr_percent: round(toPercent(channel.clicks, channel.impressions)),\n cost_share_percent: round(toPercent(channel.cost, totals.cost)),\n cpa: round(channel.cost / channel.conversions),\n roas: round(channel.conversion_value / channel.cost),\n }))\n .sort((a, b) => b.cost - a.cost);\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 total_channels: channels.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 dominant_channel: channels[0]?.channel_type,\n dominant_channel_cost_share_percent: channels[0]?.cost_share_percent,\n },\n channels,\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 channel mix\");\n }\n}\n"],
5
+ "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAClF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,gCAAgC;AAAA,EAC9E,YAAY,EACT,OAAO,EACP,SAAS,EACT,SAAS,sHAAsH;AAAA,EAClI,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iFAAiF;AAAA,EAC3H,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,2BACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,MAAM,2BAA2B,OAAO,YAAY,OAAO,SAAS;AACvF,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,gCAAgC,OAAO,SAAS,UAAU,OAAO,OAAO;AAAA,QACxE;AAAA,QACA;AAAA,MACF,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,UAAU,oBAAI,IAUlB;AAEF,eAAW,OAAO,OAAO,MAAM;AAC7B,YAAM,cAAc;AAAA,QAClB,cAAc,KAAK,mCAAmC,SAAS,KAAK;AAAA,MACtE;AACA,YAAM,UAAU,QAAQ,IAAI,WAAW,KAAK;AAAA,QAC1C,cAAc;AAAA,QACd,aAAa;AAAA,QACb,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,aAAa;AAAA,QACb,kBAAkB;AAAA,MACpB;AAEA,cAAQ,eAAe,0BAA0B,cAAc,KAAK,qBAAqB,CAAC;AAC1F,cAAQ,UAAU,0BAA0B,cAAc,KAAK,gBAAgB,CAAC;AAChF,cAAQ,QAAQ,iBAAiB,cAAc,KAAK,oBAAoB,CAAC;AACzE,cAAQ,eAAe;AAAA,QACrB,0BAA0B,cAAc,KAAK,qBAAqB,CAAC;AAAA,MACrE;AACA,cAAQ,oBAAoB;AAAA,QAC1B,0BAA0B,cAAc,KAAK,0BAA0B,CAAC;AAAA,MAC1E;AAEA,cAAQ,IAAI,aAAa,OAAO;AAAA,IAClC;AAEA,UAAM,SAAS,MAAM,KAAK,QAAQ,OAAO,CAAC,EAAE;AAAA,MAC1C,CAAC,KAAK,YAAY;AAChB,YAAI,eAAe,QAAQ;AAC3B,YAAI,UAAU,QAAQ;AACtB,YAAI,QAAQ,QAAQ;AACpB,YAAI,eAAe,QAAQ;AAC3B,YAAI,oBAAoB,QAAQ;AAChC,eAAO;AAAA,MACT;AAAA,MACA,EAAE,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,kBAAkB,EAAE;AAAA,IAC5E;AAEA,UAAM,WAAW,MAAM,KAAK,QAAQ,OAAO,CAAC,EACzC,IAAI,CAAC,aAAa;AAAA,MACjB,GAAG;AAAA,MACH,MAAM,MAAM,QAAQ,IAAI;AAAA,MACxB,aAAa,MAAM,QAAQ,WAAW;AAAA,MACtC,kBAAkB,MAAM,QAAQ,gBAAgB;AAAA,MAChD,aAAa,MAAM,UAAU,QAAQ,QAAQ,QAAQ,WAAW,CAAC;AAAA,MACjE,oBAAoB,MAAM,UAAU,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,MAC9D,KAAK,MAAM,QAAQ,OAAO,QAAQ,WAAW;AAAA,MAC7C,MAAM,MAAM,QAAQ,mBAAmB,QAAQ,IAAI;AAAA,IACrD,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI;AAEjC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,eAAe,cAAc,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,0BAA0B;AAAA,QAC7E,eAAe,cAAc,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,uBAAuB;AAAA,QAC1E,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,UAAU;AAAA,UACR,gBAAgB,SAAS;AAAA,UACzB,aAAa,OAAO;AAAA,UACpB,QAAQ,OAAO;AAAA,UACf,MAAM,MAAM,OAAO,IAAI;AAAA,UACvB,aAAa,MAAM,OAAO,WAAW;AAAA,UACrC,kBAAkB,MAAM,OAAO,gBAAgB;AAAA,UAC/C,kBAAkB,SAAS,CAAC,GAAG;AAAA,UAC/B,qCAAqC,SAAS,CAAC,GAAG;AAAA,QACpD;AAAA,QACA;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,wCAAwC;AAAA,EAC5F;AACF;",
6
6
  "names": []
7
7
  }
@@ -23,7 +23,7 @@ const googleAdsCompareAccountsSchema = z.object({
23
23
  });
24
24
  async function googleAdsCompareAccountsHandler(params) {
25
25
  try {
26
- const customerIds = params.customerIds.map((id) => resolveGoogleAdsCustomerId(id));
26
+ const customerIds = await Promise.all(params.customerIds.map((id) => resolveGoogleAdsCustomerId(id)));
27
27
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
28
28
  const developerToken = resolveGoogleAdsDeveloperToken();
29
29
  const accountResults = await Promise.all(
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/compare-accounts.ts"],
4
- "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 googleAdsCompareAccountsSchema = 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 customerIds: z\n .array(z.string())\n .min(2)\n .max(10)\n .describe(\"Google Ads customer IDs to compare. 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 googleAdsCompareAccountsHandler(\n params: z.infer<typeof googleAdsCompareAccountsSchema>\n) {\n try {\n const customerIds = params.customerIds.map((id) => resolveGoogleAdsCustomerId(id));\n const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n const developerToken = resolveGoogleAdsDeveloperToken();\n\n const accountResults = await Promise.all(\n customerIds.map(async (customerId) => {\n const [overviewResult, campaignResult] = await Promise.all([\n 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 searchGoogleAds(\n customerId,\n [\n \"SELECT\",\n \"metrics.cost_micros\",\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 ]);\n\n const row = overviewResult.rows[0] ?? {};\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 clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n const roas = round(conversionValue / cost);\n const cpa = round(cost / conversions);\n const topCampaignCost = microsToCurrency(\n getFieldValue(campaignResult.rows[0] ?? {}, \"metrics.costMicros\")\n );\n const topCampaignCostSharePercent = round(toPercent(topCampaignCost, cost));\n\n const riskScore =\n (roas < 1 ? 40 : roas < 1.5 ? 20 : 0) +\n (conversions < 5 ? 25 : 0) +\n (topCampaignCostSharePercent >= 70 ? 25 : topCampaignCostSharePercent >= 50 ? 10 : 0) +\n (cost <= 0 ? 10 : 0);\n\n return {\n customer_id: customerId,\n customer_name: getFieldValue(row, \"customer.descriptiveName\"),\n currency_code: getFieldValue(row, \"customer.currencyCode\"),\n cost,\n clicks,\n conversions,\n conversion_value: conversionValue,\n roas,\n cpa,\n top_campaign_cost_share_percent: topCampaignCostSharePercent,\n risk_score: riskScore,\n };\n })\n );\n\n const rankedAccounts = accountResults.sort((a, b) => b.risk_score - a.risk_score);\n\n return object(\n stripNulls({\n login_customer_id: loginCustomerId,\n date_range: {\n start_date: params.startDate,\n end_date: params.endDate,\n },\n overview: {\n compared_accounts: rankedAccounts.length,\n highest_risk_customer_id: rankedAccounts[0]?.customer_id,\n highest_risk_customer_name: rankedAccounts[0]?.customer_name,\n lowest_risk_customer_id: rankedAccounts.at(-1)?.customer_id,\n lowest_risk_customer_name: rankedAccounts.at(-1)?.customer_name,\n },\n accounts: rankedAccounts,\n interpretation: {\n worst_account: rankedAccounts[0]\n ? `${rankedAccounts[0].customer_name} appears to be the weakest account, mainly driven by ROAS ${rankedAccounts[0].roas}, ${rankedAccounts[0].conversions} conversions, and ${rankedAccounts[0].top_campaign_cost_share_percent}% spend concentration in the top campaign.`\n : undefined,\n },\n })\n );\n } catch (err) {\n return error(err instanceof Error ? err.message : \"Failed to compare Google Ads accounts\");\n }\n}\n"],
5
- "mappings": "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",
4
+ "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 googleAdsCompareAccountsSchema = 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 customerIds: z\n .array(z.string())\n .min(2)\n .max(10)\n .describe(\"Google Ads customer IDs to compare. 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 googleAdsCompareAccountsHandler(\n params: z.infer<typeof googleAdsCompareAccountsSchema>\n) {\n try {\n const customerIds = await Promise.all(params.customerIds.map((id) => resolveGoogleAdsCustomerId(id)));\n const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n const developerToken = resolveGoogleAdsDeveloperToken();\n\n const accountResults = await Promise.all(\n customerIds.map(async (customerId) => {\n const [overviewResult, campaignResult] = await Promise.all([\n 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 searchGoogleAds(\n customerId,\n [\n \"SELECT\",\n \"metrics.cost_micros\",\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 ]);\n\n const row = overviewResult.rows[0] ?? {};\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 clicks = parseGoogleAdsMetricValue(getFieldValue(row, \"metrics.clicks\"));\n const roas = round(conversionValue / cost);\n const cpa = round(cost / conversions);\n const topCampaignCost = microsToCurrency(\n getFieldValue(campaignResult.rows[0] ?? {}, \"metrics.costMicros\")\n );\n const topCampaignCostSharePercent = round(toPercent(topCampaignCost, cost));\n\n const riskScore =\n (roas < 1 ? 40 : roas < 1.5 ? 20 : 0) +\n (conversions < 5 ? 25 : 0) +\n (topCampaignCostSharePercent >= 70 ? 25 : topCampaignCostSharePercent >= 50 ? 10 : 0) +\n (cost <= 0 ? 10 : 0);\n\n return {\n customer_id: customerId,\n customer_name: getFieldValue(row, \"customer.descriptiveName\"),\n currency_code: getFieldValue(row, \"customer.currencyCode\"),\n cost,\n clicks,\n conversions,\n conversion_value: conversionValue,\n roas,\n cpa,\n top_campaign_cost_share_percent: topCampaignCostSharePercent,\n risk_score: riskScore,\n };\n })\n );\n\n const rankedAccounts = accountResults.sort((a, b) => b.risk_score - a.risk_score);\n\n return object(\n stripNulls({\n login_customer_id: loginCustomerId,\n date_range: {\n start_date: params.startDate,\n end_date: params.endDate,\n },\n overview: {\n compared_accounts: rankedAccounts.length,\n highest_risk_customer_id: rankedAccounts[0]?.customer_id,\n highest_risk_customer_name: rankedAccounts[0]?.customer_name,\n lowest_risk_customer_id: rankedAccounts.at(-1)?.customer_id,\n lowest_risk_customer_name: rankedAccounts.at(-1)?.customer_name,\n },\n accounts: rankedAccounts,\n interpretation: {\n worst_account: rankedAccounts[0]\n ? `${rankedAccounts[0].customer_name} appears to be the weakest account, mainly driven by ROAS ${rankedAccounts[0].roas}, ${rankedAccounts[0].conversions} conversions, and ${rankedAccounts[0].top_campaign_cost_share_percent}% spend concentration in the top campaign.`\n : undefined,\n },\n })\n );\n } catch (err) {\n return error(err instanceof Error ? err.message : \"Failed to compare Google Ads accounts\");\n }\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -9,14 +9,15 @@ import {
9
9
  import { searchGoogleAds } from "../../services/google-ads/google-ads-client.js";
10
10
  import { stripNulls } from "../../utils/strip-payload.js";
11
11
  const googleAdsCustomerClientsSchema = z.object({
12
- customerId: z.string().describe("Google Ads customer ID to inspect for visible child accounts. Usually the MCC ID."),
12
+ customerId: z.string().optional().describe("Google Ads customer ID to inspect for visible child accounts. If omitted, resolves the profileId mapping."),
13
+ profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped Google Ads customer ID."),
13
14
  loginCustomerId: z.string().optional().describe(
14
15
  "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
15
16
  )
16
17
  });
17
18
  async function googleAdsCustomerClientsHandler(params) {
18
19
  try {
19
- const customerId = resolveGoogleAdsCustomerId(params.customerId);
20
+ const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);
20
21
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
21
22
  const developerToken = resolveGoogleAdsDeveloperToken();
22
23
  const result = await searchGoogleAds(
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/customer-clients.ts"],
4
- "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n getFieldValue,\n resolveGoogleAdsCustomerId,\n resolveGoogleAdsDeveloperToken,\n resolveGoogleAdsLoginCustomerId,\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 googleAdsCustomerClientsSchema = z.object({\n customerId: z\n .string()\n .describe(\"Google Ads customer ID to inspect for visible child accounts. Usually the MCC ID.\"),\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 googleAdsCustomerClientsHandler(\n params: z.infer<typeof googleAdsCustomerClientsSchema>\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_client.client_customer,\",\n \"customer_client.descriptive_name,\",\n \"customer_client.currency_code,\",\n \"customer_client.time_zone,\",\n \"customer_client.manager,\",\n \"customer_client.test_account,\",\n \"customer_client.status\",\n \"FROM customer_client\",\n \"ORDER BY customer_client.descriptive_name\",\n ].join(\" \"),\n developerToken,\n loginCustomerId\n );\n\n const customers = result.rows.map((row) => ({\n customer_id: String(getFieldValue(row, \"customerClient.clientCustomer\") ?? \"\").replace(\n \"customers/\",\n \"\"\n ),\n descriptive_name: getFieldValue(row, \"customerClient.descriptiveName\"),\n currency_code: getFieldValue(row, \"customerClient.currencyCode\"),\n time_zone: getFieldValue(row, \"customerClient.timeZone\"),\n is_manager: getFieldValue<boolean>(row, \"customerClient.manager\"),\n is_test_account: getFieldValue<boolean>(row, \"customerClient.testAccount\"),\n status: getFieldValue(row, \"customerClient.status\"),\n }));\n\n return object(\n stripNulls({\n customer_id: customerId,\n login_customer_id: loginCustomerId,\n overview: {\n total_visible_customers: customers.length,\n manager_customers: customers.filter((customer) => customer.is_manager).length,\n client_customers: customers.filter((customer) => customer.is_manager === false).length,\n },\n customers,\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 list visible Google Ads customer clients\"\n );\n }\n}\n"],
5
- "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,YAAY,EACT,OAAO,EACP,SAAS,mFAAmF;AAAA,EAC/F,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,gCACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,2BAA2B,OAAO,UAAU;AAC/D,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,YAAY,OAAO,KAAK,IAAI,CAAC,SAAS;AAAA,MAC1C,aAAa,OAAO,cAAc,KAAK,+BAA+B,KAAK,EAAE,EAAE;AAAA,QAC7E;AAAA,QACA;AAAA,MACF;AAAA,MACA,kBAAkB,cAAc,KAAK,gCAAgC;AAAA,MACrE,eAAe,cAAc,KAAK,6BAA6B;AAAA,MAC/D,WAAW,cAAc,KAAK,yBAAyB;AAAA,MACvD,YAAY,cAAuB,KAAK,wBAAwB;AAAA,MAChE,iBAAiB,cAAuB,KAAK,4BAA4B;AAAA,MACzE,QAAQ,cAAc,KAAK,uBAAuB;AAAA,IACpD,EAAE;AAEF,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,UAAU;AAAA,UACR,yBAAyB,UAAU;AAAA,UACnC,mBAAmB,UAAU,OAAO,CAAC,aAAa,SAAS,UAAU,EAAE;AAAA,UACvE,kBAAkB,UAAU,OAAO,CAAC,aAAa,SAAS,eAAe,KAAK,EAAE;AAAA,QAClF;AAAA,QACA;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
4
+ "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n getFieldValue,\n resolveGoogleAdsCustomerId,\n resolveGoogleAdsDeveloperToken,\n resolveGoogleAdsLoginCustomerId,\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 googleAdsCustomerClientsSchema = z.object({\n customerId: z\n .string()\n .optional()\n .describe(\"Google Ads customer ID to inspect for visible child accounts. If omitted, resolves the profileId mapping.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 googleAdsCustomerClientsHandler(\n params: z.infer<typeof googleAdsCustomerClientsSchema>\n) {\n try {\n const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n const developerToken = resolveGoogleAdsDeveloperToken();\n\n const result = await searchGoogleAds(\n customerId,\n [\n \"SELECT\",\n \"customer_client.client_customer,\",\n \"customer_client.descriptive_name,\",\n \"customer_client.currency_code,\",\n \"customer_client.time_zone,\",\n \"customer_client.manager,\",\n \"customer_client.test_account,\",\n \"customer_client.status\",\n \"FROM customer_client\",\n \"ORDER BY customer_client.descriptive_name\",\n ].join(\" \"),\n developerToken,\n loginCustomerId\n );\n\n const customers = result.rows.map((row) => ({\n customer_id: String(getFieldValue(row, \"customerClient.clientCustomer\") ?? \"\").replace(\n \"customers/\",\n \"\"\n ),\n descriptive_name: getFieldValue(row, \"customerClient.descriptiveName\"),\n currency_code: getFieldValue(row, \"customerClient.currencyCode\"),\n time_zone: getFieldValue(row, \"customerClient.timeZone\"),\n is_manager: getFieldValue<boolean>(row, \"customerClient.manager\"),\n is_test_account: getFieldValue<boolean>(row, \"customerClient.testAccount\"),\n status: getFieldValue(row, \"customerClient.status\"),\n }));\n\n return object(\n stripNulls({\n customer_id: customerId,\n login_customer_id: loginCustomerId,\n overview: {\n total_visible_customers: customers.length,\n manager_customers: customers.filter((customer) => customer.is_manager).length,\n client_customers: customers.filter((customer) => customer.is_manager === false).length,\n },\n customers,\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 list visible Google Ads customer clients\"\n );\n }\n}\n"],
5
+ "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,YAAY,EACT,OAAO,EACP,SAAS,EACT,SAAS,2GAA2G;AAAA,EACvH,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iFAAiF;AAAA,EAC3H,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,gCACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,MAAM,2BAA2B,OAAO,YAAY,OAAO,SAAS;AACvF,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,YAAY,OAAO,KAAK,IAAI,CAAC,SAAS;AAAA,MAC1C,aAAa,OAAO,cAAc,KAAK,+BAA+B,KAAK,EAAE,EAAE;AAAA,QAC7E;AAAA,QACA;AAAA,MACF;AAAA,MACA,kBAAkB,cAAc,KAAK,gCAAgC;AAAA,MACrE,eAAe,cAAc,KAAK,6BAA6B;AAAA,MAC/D,WAAW,cAAc,KAAK,yBAAyB;AAAA,MACvD,YAAY,cAAuB,KAAK,wBAAwB;AAAA,MAChE,iBAAiB,cAAuB,KAAK,4BAA4B;AAAA,MACzE,QAAQ,cAAc,KAAK,uBAAuB;AAAA,IACpD,EAAE;AAEF,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,UAAU;AAAA,UACR,yBAAyB,UAAU;AAAA,UACnC,mBAAmB,UAAU,OAAO,CAAC,aAAa,SAAS,UAAU,EAAE;AAAA,UACvE,kBAAkB,UAAU,OAAO,CAAC,aAAa,SAAS,eAAe,KAAK,EAAE;AAAA,QAClF;AAAA,QACA;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
6
6
  "names": []
7
7
  }
@@ -9,14 +9,15 @@ import {
9
9
  import { searchGoogleAds } from "../../services/google-ads/google-ads-client.js";
10
10
  import { stripNulls } from "../../utils/strip-payload.js";
11
11
  const googleAdsCustomerInfoSchema = z.object({
12
- customerId: z.string().describe("Google Ads customer ID to inspect. Accepts digits with or without hyphens."),
12
+ customerId: z.string().optional().describe("Google Ads customer ID to inspect. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens."),
13
+ profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped Google Ads customer ID."),
13
14
  loginCustomerId: z.string().optional().describe(
14
15
  "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
15
16
  )
16
17
  });
17
18
  async function googleAdsCustomerInfoHandler(params) {
18
19
  try {
19
- const customerId = resolveGoogleAdsCustomerId(params.customerId);
20
+ const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);
20
21
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
21
22
  const developerToken = resolveGoogleAdsDeveloperToken();
22
23
  const result = await searchGoogleAds(
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/customer-info.ts"],
4
- "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n getFieldValue,\n resolveGoogleAdsCustomerId,\n resolveGoogleAdsDeveloperToken,\n resolveGoogleAdsLoginCustomerId,\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 googleAdsCustomerInfoSchema = z.object({\n customerId: z.string().describe(\"Google Ads customer ID to inspect. 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 googleAdsCustomerInfoHandler(\n params: z.infer<typeof googleAdsCustomerInfoSchema>\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.id,\",\n \"customer.descriptive_name,\",\n \"customer.currency_code,\",\n \"customer.time_zone,\",\n \"customer.manager,\",\n \"customer.test_account\",\n \"FROM customer\",\n ].join(\" \"),\n developerToken,\n loginCustomerId\n );\n\n const row = result.rows[0] ?? {};\n\n return object(\n stripNulls({\n customer_id: customerId,\n login_customer_id: loginCustomerId,\n customer: {\n id: getFieldValue(row, \"customer.id\"),\n descriptive_name: getFieldValue(row, \"customer.descriptiveName\"),\n currency_code: getFieldValue(row, \"customer.currencyCode\"),\n time_zone: getFieldValue(row, \"customer.timeZone\"),\n is_manager: getFieldValue(row, \"customer.manager\"),\n is_test_account: getFieldValue(row, \"customer.testAccount\"),\n },\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 customer info\");\n }\n}\n"],
5
- "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,YAAY,EAAE,OAAO,EAAE,SAAS,4EAA4E;AAAA,EAC5G,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,6BACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,2BAA2B,OAAO,UAAU;AAC/D,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,OAAO,KAAK,CAAC,KAAK,CAAC;AAE/B,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,UAAU;AAAA,UACR,IAAI,cAAc,KAAK,aAAa;AAAA,UACpC,kBAAkB,cAAc,KAAK,0BAA0B;AAAA,UAC/D,eAAe,cAAc,KAAK,uBAAuB;AAAA,UACzD,WAAW,cAAc,KAAK,mBAAmB;AAAA,UACjD,YAAY,cAAc,KAAK,kBAAkB;AAAA,UACjD,iBAAiB,cAAc,KAAK,sBAAsB;AAAA,QAC5D;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,0CAA0C;AAAA,EAC9F;AACF;",
4
+ "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport {\n getFieldValue,\n resolveGoogleAdsCustomerId,\n resolveGoogleAdsDeveloperToken,\n resolveGoogleAdsLoginCustomerId,\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 googleAdsCustomerInfoSchema = z.object({\n customerId: z.string().optional().describe(\"Google Ads customer ID to inspect. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 googleAdsCustomerInfoHandler(\n params: z.infer<typeof googleAdsCustomerInfoSchema>\n) {\n try {\n const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\n const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);\n const developerToken = resolveGoogleAdsDeveloperToken();\n\n const result = await searchGoogleAds(\n customerId,\n [\n \"SELECT\",\n \"customer.id,\",\n \"customer.descriptive_name,\",\n \"customer.currency_code,\",\n \"customer.time_zone,\",\n \"customer.manager,\",\n \"customer.test_account\",\n \"FROM customer\",\n ].join(\" \"),\n developerToken,\n loginCustomerId\n );\n\n const row = result.rows[0] ?? {};\n\n return object(\n stripNulls({\n customer_id: customerId,\n login_customer_id: loginCustomerId,\n customer: {\n id: getFieldValue(row, \"customer.id\"),\n descriptive_name: getFieldValue(row, \"customer.descriptiveName\"),\n currency_code: getFieldValue(row, \"customer.currencyCode\"),\n time_zone: getFieldValue(row, \"customer.timeZone\"),\n is_manager: getFieldValue(row, \"customer.manager\"),\n is_test_account: getFieldValue(row, \"customer.testAccount\"),\n },\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 customer info\");\n }\n}\n"],
5
+ "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,wHAAwH;AAAA,EACnK,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iFAAiF;AAAA,EAC3H,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,6BACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,MAAM,2BAA2B,OAAO,YAAY,OAAO,SAAS;AACvF,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,OAAO,KAAK,CAAC,KAAK,CAAC;AAE/B,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,UAAU;AAAA,UACR,IAAI,cAAc,KAAK,aAAa;AAAA,UACpC,kBAAkB,cAAc,KAAK,0BAA0B;AAAA,UAC/D,eAAe,cAAc,KAAK,uBAAuB;AAAA,UACzD,WAAW,cAAc,KAAK,mBAAmB;AAAA,UACjD,YAAY,cAAc,KAAK,kBAAkB;AAAA,UACjD,iBAAiB,cAAc,KAAK,sBAAsB;AAAA,QAC5D;AAAA,QACA,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,0CAA0C;AAAA,EAC9F;AACF;",
6
6
  "names": []
7
7
  }
@@ -16,7 +16,8 @@ import { stripNulls } from "../../utils/strip-payload.js";
16
16
  const googleAdsScalingHealthSchema = z.object({
17
17
  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
18
18
  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
19
- customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
19
+ customerId: z.string().optional().describe("Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens."),
20
+ profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped Google Ads customer ID."),
20
21
  loginCustomerId: z.string().optional().describe(
21
22
  "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
22
23
  ),
@@ -25,7 +26,7 @@ const googleAdsScalingHealthSchema = z.object({
25
26
  });
26
27
  async function googleAdsScalingHealthHandler(params) {
27
28
  try {
28
- const customerId = resolveGoogleAdsCustomerId(params.customerId);
29
+ const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);
29
30
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
30
31
  const developerToken = resolveGoogleAdsDeveloperToken();
31
32
  const overviewResult = await searchGoogleAds(
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/scaling-health.ts"],
4
- "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"],
5
- "mappings": "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",
4
+ "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 .optional()\n .describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\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"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -16,7 +16,8 @@ import { stripNulls } from "../../utils/strip-payload.js";
16
16
  const googleAdsSearchTermsSummarySchema = z.object({
17
17
  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
18
18
  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
19
- customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
19
+ customerId: z.string().optional().describe("Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens."),
20
+ profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped Google Ads customer ID."),
20
21
  loginCustomerId: z.string().optional().describe(
21
22
  "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
22
23
  ),
@@ -24,7 +25,7 @@ const googleAdsSearchTermsSummarySchema = z.object({
24
25
  });
25
26
  async function googleAdsSearchTermsSummaryHandler(params) {
26
27
  try {
27
- const customerId = resolveGoogleAdsCustomerId(params.customerId);
28
+ const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);
28
29
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
29
30
  const developerToken = resolveGoogleAdsDeveloperToken();
30
31
  const result = await searchGoogleAds(
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/search-terms-summary.ts"],
4
- "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"],
5
- "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAEpB,MAAM,oCAAoC,EAAE,OAAO;AAAA,EACxD,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAClF,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,SAAS,gCAAgC;AAAA,EAC9E,YAAY,EAAE,OAAO,EAAE,SAAS,0EAA0E;AAAA,EAC1G,iBAAiB,EACd,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,EACJ,OAAO,EACP,IAAI,EACJ,IAAI,CAAC,EACL,IAAI,EAAE,EACN,SAAS,EACT,QAAQ,EAAE,EACV,SAAS,wEAAwE;AACtF,CAAC;AAED,eAAsB,mCACpB,QACA;AACA,MAAI;AACF,UAAM,aAAa,2BAA2B,OAAO,UAAU;AAC/D,UAAM,kBAAkB,gCAAgC,OAAO,eAAe;AAC9E,UAAM,iBAAiB,+BAA+B;AAEtD,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,gCAAgC,OAAO,SAAS,UAAU,OAAO,OAAO;AAAA,QACxE;AAAA,QACA;AAAA,QACA,SAAS,OAAO,KAAK;AAAA,MACvB,EAAE,KAAK,GAAG;AAAA,MACV;AAAA,MACA;AAAA,IACF;AAEA,UAAM,cAAc,OAAO,KAAK,IAAI,CAAC,QAAQ;AAC3C,YAAM,cAAc,0BAA0B,cAAc,KAAK,qBAAqB,CAAC;AACvF,YAAM,SAAS,0BAA0B,cAAc,KAAK,gBAAgB,CAAC;AAC7E,YAAM,OAAO,iBAAiB,cAAc,KAAK,oBAAoB,CAAC;AACtE,YAAM,cAAc;AAAA,QAClB,0BAA0B,cAAc,KAAK,qBAAqB,CAAC;AAAA,MACrE;AACA,YAAM,kBAAkB;AAAA,QACtB,0BAA0B,cAAc,KAAK,0BAA0B,CAAC;AAAA,MAC1E;AAEA,aAAO;AAAA,QACL,aAAa,cAAc,KAAK,2BAA2B;AAAA,QAC3D,aAAa,cAAc,KAAK,aAAa;AAAA,QAC7C,eAAe,cAAc,KAAK,eAAe;AAAA,QACjD,aAAa,cAAc,KAAK,YAAY;AAAA,QAC5C,eAAe,cAAc,KAAK,cAAc;AAAA,QAChD;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,kBAAkB;AAAA,QAClB,aAAa,MAAM,UAAU,QAAQ,WAAW,CAAC;AAAA,QACjD,KAAK,MAAM,OAAO,WAAW;AAAA,QAC7B,MAAM,MAAM,kBAAkB,IAAI;AAAA,MACpC;AAAA,IACF,CAAC;AAED,UAAM,SAAS,YAAY;AAAA,MACzB,CAAC,KAAK,SAAS;AACb,YAAI,eAAe,KAAK;AACxB,YAAI,UAAU,KAAK;AACnB,YAAI,QAAQ,KAAK;AACjB,YAAI,eAAe,KAAK;AACxB,YAAI,oBAAoB,KAAK;AAC7B,eAAO;AAAA,MACT;AAAA,MACA,EAAE,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,kBAAkB,EAAE;AAAA,IAC5E;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa;AAAA,QACb,mBAAmB;AAAA,QACnB,eAAe,cAAc,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,0BAA0B;AAAA,QAC7E,eAAe,cAAc,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,uBAAuB;AAAA,QAC1E,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,UAAU;AAAA,UACR,gBAAgB,YAAY;AAAA,UAC5B,aAAa,OAAO;AAAA,UACpB,QAAQ,OAAO;AAAA,UACf,MAAM,MAAM,OAAO,IAAI;AAAA,UACvB,aAAa,MAAM,OAAO,WAAW;AAAA,UACrC,kBAAkB,MAAM,OAAO,gBAAgB;AAAA,UAC/C,aAAa,MAAM,UAAU,OAAO,QAAQ,OAAO,WAAW,CAAC;AAAA,UAC/D,KAAK,MAAM,OAAO,OAAO,OAAO,WAAW;AAAA,UAC3C,MAAM,MAAM,OAAO,mBAAmB,OAAO,IAAI;AAAA,UACjD,kBAAkB,YAAY,CAAC,GAAG;AAAA,QACpC;AAAA,QACA,cAAc;AAAA,QACd,UAAU;AAAA,UACR,WAAW,OAAO,KAAK;AAAA,UACvB,YAAY,OAAO;AAAA,QACrB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
4
+ "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().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\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"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -17,7 +17,8 @@ const googleAdsTimeSeriesGranularityEnum = z.enum(["daily", "weekly"]);
17
17
  const googleAdsTimeSeriesSchema = z.object({
18
18
  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format."),
19
19
  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format."),
20
- customerId: z.string().describe("Google Ads customer ID to query. Accepts digits with or without hyphens."),
20
+ customerId: z.string().optional().describe("Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens."),
21
+ profileId: z.string().optional().describe("Optional business profile ID used to resolve the mapped Google Ads customer ID."),
21
22
  loginCustomerId: z.string().optional().describe(
22
23
  "Optional manager account ID used as login customer. If omitted, uses GOOGLE_ADS_LOGIN_CUSTOMER_ID when configured."
23
24
  ),
@@ -25,7 +26,7 @@ const googleAdsTimeSeriesSchema = z.object({
25
26
  });
26
27
  async function googleAdsTimeSeriesHandler(params) {
27
28
  try {
28
- const customerId = resolveGoogleAdsCustomerId(params.customerId);
29
+ const customerId = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);
29
30
  const loginCustomerId = resolveGoogleAdsLoginCustomerId(params.loginCustomerId);
30
31
  const developerToken = resolveGoogleAdsDeveloperToken();
31
32
  const segmentField = params.granularity === "weekly" ? "segments.week" : "segments.date";
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tools/google-ads/time-series.ts"],
4
- "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"],
5
- "mappings": "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",
4
+ "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().optional().describe(\"Google Ads customer ID to query. If omitted, resolves the profileId mapping. Accepts digits with or without hyphens.\"),\n profileId: z.string().optional().describe(\"Optional business profile ID used to resolve the mapped Google Ads customer ID.\"),\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 = await resolveGoogleAdsCustomerId(params.customerId, params.profileId);\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"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -26,7 +26,7 @@ const searchConsoleCountryBreakdownSchema = z.object({
26
26
  });
27
27
  async function searchConsoleCountryBreakdownHandler(params) {
28
28
  try {
29
- const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
29
+ const siteUrl = await resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
30
30
  const dimensionFilters = [];
31
31
  if (params.queryContains?.trim()) {
32
32
  dimensionFilters.push({