mobile-growth-mcp 2.2.4 → 2.3.5

package/dist/index.js

@@ -164,685 +164,8 @@ function registerFetchedPrompts(server2, apiKey2, prompts) {
   }
 }
 
-// src/tools/meta-campaigns.ts
-import { z as z2 } from "zod";
-
-// src/meta/client.ts
-var META_API_VERSION = "v21.0";
-var META_BASE_URL = `https://graph.facebook.com/${META_API_VERSION}`;
-var THROTTLE_WARN_THRESHOLD = 75;
-function getMetaAccessToken() {
-  const token = process.env.META_ACCESS_TOKEN;
-  if (!token) {
-    throw new Error(
-      'Missing META_ACCESS_TOKEN. To fix, add it to your MCP config:\n  \u2022 Claude Code / Cursor: add "META_ACCESS_TOKEN": "..." to the "env" block in .mcp.json\n  \u2022 Claude Desktop: add "META_ACCESS_TOKEN": "..." to the "env" block in claude_desktop_config.json\n  \u2022 CLI: add META_ACCESS_TOKEN=... to a .env file in your working directory\nThen restart your MCP client.'
-    );
-  }
-  return token;
-}
-function isMetaApiError(body) {
-  return typeof body === "object" && body !== null && "error" in body && typeof body.error?.message === "string";
-}
-function formatMetaError(err) {
-  const code = err.code;
-  const sub = err.error_subcode;
-  if (code === 190) {
-    return `Authentication error: Access token is invalid or expired. Generate a new token in Meta Business Suite. (code ${code})`;
-  }
-  if (code === 4 || code === 17 || code >= 8e4 && code <= 80099) {
-    return `Rate limit hit: ${err.message}. Wait a few minutes before retrying. (code ${code}${sub ? `/${sub}` : ""})`;
-  }
-  if (code === 100) {
-    return `Invalid parameter: ${err.message} (code ${code}${sub ? `/${sub}` : ""})`;
-  }
-  return `Meta API error: ${err.message} (code ${code}${sub ? `/${sub}` : ""})`;
-}
-function parseThrottleHeader(headers) {
-  const raw = headers.get("x-fb-ads-insights-throttle");
-  if (!raw) return void 0;
-  try {
-    const info = JSON.parse(raw);
-    const maxUtil = Math.max(info.app_id_util_pct, info.acc_id_util_pct);
-    const warning = maxUtil > THROTTLE_WARN_THRESHOLD ? `\u26A0 Meta API utilization at ${maxUtil}% \u2014 approaching rate limit. Slow down requests.` : void 0;
-    return { throttle: info, warning };
-  } catch {
-    return void 0;
-  }
-}
-async function metaApiGet(options) {
-  const token = getMetaAccessToken();
-  const url = new URL(`${META_BASE_URL}${options.path}`);
-  if (options.params) {
-    for (const [key, value] of Object.entries(options.params)) {
-      url.searchParams.set(key, value);
-    }
-  }
-  const response = await fetch(url.toString(), {
-    headers: { Authorization: `Bearer ${token}` }
-  });
-  const body = await response.json();
-  if (!response.ok || isMetaApiError(body)) {
-    if (isMetaApiError(body)) {
-      throw new Error(formatMetaError(body.error));
-    }
-    throw new Error(`Meta API returned ${response.status}: ${JSON.stringify(body)}`);
-  }
-  const throttleInfo = parseThrottleHeader(response.headers);
-  return {
-    data: body,
-    throttle: throttleInfo?.throttle,
-    warning: throttleInfo?.warning
-  };
-}
-function activeFilter() {
-  return JSON.stringify([
-    {
-      field: "ad.effective_status",
-      operator: "IN",
-      value: ["ACTIVE"]
-    }
-  ]);
-}
-function getActionValue(actions, actionType) {
-  if (!actions) return 0;
-  const action = actions.find((a) => a.action_type === actionType);
-  return action ? parseFloat(action.value) : 0;
-}
-function getCostPerAction(costPerAction, actionType) {
-  if (!costPerAction) return null;
-  const action = costPerAction.find((a) => a.action_type === actionType);
-  return action ? parseFloat(action.value) : null;
-}
-var DEFAULT_DATE_PRESET = "last_7d";
-var CAMPAIGN_DEFAULT_FIELDS = "id,name,status,effective_status,objective,bid_strategy,daily_budget,lifetime_budget,buying_type,special_ad_categories";
-var ADSET_DEFAULT_FIELDS = "id,name,status,effective_status,campaign_id,optimization_goal,billing_event,bid_strategy,bid_amount,daily_budget,lifetime_budget,targeting,promoted_object";
-var AD_DEFAULT_FIELDS = "id,name,status,effective_status,adset_id,campaign_id,creative{id,title,body,image_url,video_id,call_to_action_type}";
-var INSIGHT_DEFAULT_FIELDS = "campaign_id,campaign_name,spend,impressions,clicks,ctr,cpm,cpc,actions,cost_per_action_type";
-
-// src/tools/meta-campaigns.ts
-function registerGetMetaCampaigns(server2) {
-  server2.tool(
-    "get_meta_campaigns",
-    "List campaigns from a Meta ad account. Defaults to active campaigns with lean field set. Returns first page only \u2014 use 'after' cursor for next page.",
-    {
-      ad_account_id: z2.string().describe("Meta ad account ID (e.g. act_123456789)"),
-      fields: z2.string().optional().describe(
-        `Comma-separated fields. Default: ${CAMPAIGN_DEFAULT_FIELDS}`
-      ),
-      effective_status: z2.array(z2.string()).optional().describe(
-        'Filter by status. Default: ["ACTIVE"]. Use ["ACTIVE","PAUSED"] for all non-deleted.'
-      ),
-      limit: z2.number().min(1).max(100).optional().describe("Results per page (default 50, max 100)"),
-      after: z2.string().optional().describe("Pagination cursor from previous response")
-    },
-    async ({ ad_account_id, fields, effective_status, limit, after }) => {
-      try {
-        const params = {
-          fields: fields ?? CAMPAIGN_DEFAULT_FIELDS,
-          limit: String(limit ?? 50)
-        };
-        if (effective_status) {
-          params.filtering = JSON.stringify([
-            {
-              field: "effective_status",
-              operator: "IN",
-              value: effective_status
-            }
-          ]);
-        } else {
-          params.filtering = activeFilter();
-        }
-        if (after) {
-          params.after = after;
-        }
-        const result = await metaApiGet({
-          path: `/${ad_account_id}/campaigns`,
-          params
-        });
-        const campaigns = result.data.data;
-        const nextCursor = result.data.paging?.cursors?.after;
-        let text = `Found ${campaigns.length} campaigns:
-
-`;
-        for (const c of campaigns) {
-          text += `- **${c.name}** (${c.id})
-  Status: ${c.effective_status} | Objective: ${c.objective}` + (c.bid_strategy ? ` | Bid: ${c.bid_strategy}` : "") + (c.daily_budget ? ` | Daily: $${(parseInt(c.daily_budget) / 100).toFixed(2)}` : "") + (c.lifetime_budget ? ` | Lifetime: $${(parseInt(c.lifetime_budget) / 100).toFixed(2)}` : "") + "\n";
-        }
-        if (nextCursor) {
-          text += `
-_More results available. Pass \`after: "${nextCursor}"\` for next page._`;
-        }
-        if (result.warning) {
-          text = `${result.warning}
-
-${text}`;
-        }
-        return { content: [{ type: "text", text }] };
-      } catch (err) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: ${err instanceof Error ? err.message : String(err)}`
-            }
-          ],
-          isError: true
-        };
-      }
-    }
-  );
-}
-
-// src/tools/meta-adsets.ts
-import { z as z3 } from "zod";
-function registerGetMetaAdSets(server2) {
-  server2.tool(
-    "get_meta_adsets",
-    "List ad sets from a Meta ad account, optionally scoped to a campaign. Defaults to active ad sets with lean field set.",
-    {
-      ad_account_id: z3.string().describe("Meta ad account ID (e.g. act_123456789)"),
-      campaign_id: z3.string().optional().describe(
-        "Scope to a specific campaign ID. If provided, fetches ad sets under that campaign."
-      ),
-      fields: z3.string().optional().describe(`Comma-separated fields. Default: ${ADSET_DEFAULT_FIELDS}`),
-      effective_status: z3.array(z3.string()).optional().describe('Filter by status. Default: ["ACTIVE"]'),
-      limit: z3.number().min(1).max(100).optional().describe("Results per page (default 50, max 100)"),
-      after: z3.string().optional().describe("Pagination cursor from previous response")
-    },
-    async ({
-      ad_account_id,
-      campaign_id,
-      fields,
-      effective_status,
-      limit,
-      after
-    }) => {
-      try {
-        const params = {
-          fields: fields ?? ADSET_DEFAULT_FIELDS,
-          limit: String(limit ?? 50)
-        };
-        if (effective_status) {
-          params.filtering = JSON.stringify([
-            {
-              field: "effective_status",
-              operator: "IN",
-              value: effective_status
-            }
-          ]);
-        } else {
-          params.filtering = activeFilter();
-        }
-        if (after) {
-          params.after = after;
-        }
-        const parentPath = campaign_id ? `/${campaign_id}/adsets` : `/${ad_account_id}/adsets`;
-        const result = await metaApiGet({
-          path: parentPath,
-          params
-        });
-        const adsets = result.data.data;
-        const nextCursor = result.data.paging?.cursors?.after;
-        let text = `Found ${adsets.length} ad sets:
-
-`;
-        for (const a of adsets) {
-          text += `- **${a.name}** (${a.id})
-  Campaign: ${a.campaign_id} | Status: ${a.effective_status}` + (a.optimization_goal ? ` | Goal: ${a.optimization_goal}` : "") + (a.bid_strategy ? ` | Bid: ${a.bid_strategy}` : "") + (a.daily_budget ? ` | Daily: $${(parseInt(a.daily_budget) / 100).toFixed(2)}` : "") + "\n";
-        }
-        if (nextCursor) {
-          text += `
-_More results available. Pass \`after: "${nextCursor}"\` for next page._`;
-        }
-        if (result.warning) {
-          text = `${result.warning}
-
-${text}`;
-        }
-        return { content: [{ type: "text", text }] };
-      } catch (err) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: ${err instanceof Error ? err.message : String(err)}`
-            }
-          ],
-          isError: true
-        };
-      }
-    }
-  );
-}
-
-// src/tools/meta-ads.ts
-import { z as z4 } from "zod";
-function registerGetMetaAds(server2) {
-  server2.tool(
-    "get_meta_ads",
-    "List ads from a Meta ad account, optionally scoped to an ad set. Defaults to active ads with lean field set.",
-    {
-      ad_account_id: z4.string().describe("Meta ad account ID (e.g. act_123456789)"),
-      adset_id: z4.string().optional().describe("Scope to a specific ad set ID."),
-      fields: z4.string().optional().describe(`Comma-separated fields. Default: ${AD_DEFAULT_FIELDS}`),
-      effective_status: z4.array(z4.string()).optional().describe('Filter by status. Default: ["ACTIVE"]'),
-      limit: z4.number().min(1).max(100).optional().describe("Results per page (default 50, max 100)"),
-      after: z4.string().optional().describe("Pagination cursor from previous response")
-    },
-    async ({ ad_account_id, adset_id, fields, effective_status, limit, after }) => {
-      try {
-        const params = {
-          fields: fields ?? AD_DEFAULT_FIELDS,
-          limit: String(limit ?? 50)
-        };
-        if (effective_status) {
-          params.filtering = JSON.stringify([
-            {
-              field: "effective_status",
-              operator: "IN",
-              value: effective_status
-            }
-          ]);
-        } else {
-          params.filtering = activeFilter();
-        }
-        if (after) {
-          params.after = after;
-        }
-        const parentPath = adset_id ? `/${adset_id}/ads` : `/${ad_account_id}/ads`;
-        const result = await metaApiGet({
-          path: parentPath,
-          params
-        });
-        const ads = result.data.data;
-        const nextCursor = result.data.paging?.cursors?.after;
-        let text = `Found ${ads.length} ads:
-
-`;
-        for (const ad of ads) {
-          text += `- **${ad.name}** (${ad.id})
-  Ad Set: ${ad.adset_id} | Status: ${ad.effective_status}` + (ad.creative?.call_to_action_type ? ` | CTA: ${ad.creative.call_to_action_type}` : "") + (ad.creative?.video_id ? " | Format: Video" : "") + (ad.creative?.image_url ? " | Format: Image" : "") + "\n";
-        }
-        if (nextCursor) {
-          text += `
-_More results available. Pass \`after: "${nextCursor}"\` for next page._`;
-        }
-        if (result.warning) {
-          text = `${result.warning}
-
-${text}`;
-        }
-        return { content: [{ type: "text", text }] };
-      } catch (err) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: ${err instanceof Error ? err.message : String(err)}`
-            }
-          ],
-          isError: true
-        };
-      }
-    }
-  );
-}
-
-// src/tools/meta-insights.ts
-import { z as z5 } from "zod";
-function registerGetMetaInsights(server2) {
-  server2.tool(
-    "get_meta_insights",
-    "Pull performance insights from a Meta ad account with configurable level, breakdowns, and date range. Default: campaign-level, last 7 days, active only. Conversion event is configurable (default: mobile_app_install).",
-    {
-      ad_account_id: z5.string().describe("Meta ad account ID (e.g. act_123456789)"),
-      level: z5.enum(["account", "campaign", "adset", "ad"]).optional().describe("Aggregation level (default: campaign)"),
-      fields: z5.string().optional().describe(
-        `Comma-separated fields. Default: ${INSIGHT_DEFAULT_FIELDS}`
-      ),
-      date_preset: z5.string().optional().describe(`Date preset (default: ${DEFAULT_DATE_PRESET})`),
-      time_range: z5.object({
-        since: z5.string().describe("Start date YYYY-MM-DD"),
-        until: z5.string().describe("End date YYYY-MM-DD")
-      }).optional().describe("Custom date range. Overrides date_preset if provided."),
-      time_increment: z5.string().optional().describe(
-        'Time granularity: "1" for daily, "7" for weekly, "monthly", or "all_days" (default: aggregated)'
-      ),
-      breakdowns: z5.string().optional().describe(
-        "Comma-separated breakdowns (e.g. age,gender or publisher_platform,platform_position)"
-      ),
-      filtering: z5.string().optional().describe(
-        'JSON filtering array. Default: active only. Pass "[]" to include all statuses.'
-      ),
-      conversion_event: z5.string().optional().describe(
-        "Action type for CPA calculation (default: mobile_app_install)"
-      ),
-      sort: z5.string().optional().describe(
-        'Sort field (e.g. "spend_descending", "impressions_descending")'
-      ),
-      limit: z5.number().min(1).max(500).optional().describe("Results per page (default 50, max 500)"),
-      after: z5.string().optional().describe("Pagination cursor from previous response")
-    },
-    async ({
-      ad_account_id,
-      level,
-      fields,
-      date_preset,
-      time_range,
-      time_increment,
-      breakdowns,
-      filtering,
-      conversion_event,
-      sort,
-      limit,
-      after
-    }) => {
-      try {
-        const convEvent = conversion_event ?? "mobile_app_install";
-        const params = {
-          fields: fields ?? INSIGHT_DEFAULT_FIELDS,
-          level: level ?? "campaign",
-          limit: String(limit ?? 50)
-        };
-        if (time_range) {
-          params.time_range = JSON.stringify(time_range);
-        } else {
-          params.date_preset = date_preset ?? DEFAULT_DATE_PRESET;
-        }
-        if (time_increment) {
-          params.time_increment = time_increment;
-        }
-        if (breakdowns) {
-          params.breakdowns = breakdowns;
-        }
-        if (filtering !== void 0) {
-          params.filtering = filtering === "[]" ? "[]" : filtering;
-        } else {
-          params.filtering = activeFilter();
-        }
-        if (sort) {
-          params.sort = sort;
-        }
-        if (after) {
-          params.after = after;
-        }
-        const result = await metaApiGet({
-          path: `/${ad_account_id}/insights`,
-          params
-        });
-        const rows = result.data.data;
-        const nextCursor = result.data.paging?.cursors?.after;
-        if (!rows || rows.length === 0) {
-          return {
-            content: [
-              {
-                type: "text",
-                text: "No insight data returned for the given parameters. Try a broader date range or check that active campaigns exist."
-              }
-            ]
-          };
-        }
-        let text = `**${rows.length} rows** | Level: ${level ?? "campaign"} | Event: ${convEvent}
-
-`;
-        for (const row of rows) {
-          const spend = parseFloat(row.spend || "0");
-          const impressions = parseInt(row.impressions || "0");
-          const conversions = getActionValue(row.actions, convEvent);
-          const cpa = getCostPerAction(row.cost_per_action_type, convEvent);
-          const label = row.ad_name ?? row.adset_name ?? row.campaign_name ?? row.campaign_id ?? "Account";
-          const breakdownParts = [];
-          if (row.age) breakdownParts.push(`Age: ${row.age}`);
-          if (row.gender) breakdownParts.push(`Gender: ${row.gender}`);
-          if (row.publisher_platform)
-            breakdownParts.push(`Platform: ${row.publisher_platform}`);
-          if (row.platform_position)
-            breakdownParts.push(`Position: ${row.platform_position}`);
-          if (row.country) breakdownParts.push(`Country: ${row.country}`);
-          const breakdownStr = breakdownParts.length > 0 ? ` (${breakdownParts.join(", ")})` : "";
-          const dateStr = time_increment && row.date_start !== row.date_stop ? ` [${row.date_start} \u2192 ${row.date_stop}]` : time_increment ? ` [${row.date_start}]` : "";
-          text += `**${label}**${breakdownStr}${dateStr}
-  Spend: $${spend.toFixed(2)} | Impressions: ${impressions.toLocaleString()}` + (row.clicks ? ` | Clicks: ${row.clicks}` : "") + (row.ctr ? ` | CTR: ${row.ctr}%` : "") + (row.cpm ? ` | CPM: $${row.cpm}` : "") + (row.frequency ? ` | Freq: ${row.frequency}` : "") + (conversions > 0 ? ` | ${convEvent}: ${conversions}` : "") + (cpa !== null ? ` | CPA: $${cpa.toFixed(2)}` : "") + "\n\n";
-        }
-        if (nextCursor) {
-          text += `_More results available. Pass \`after: "${nextCursor}"\` for next page._
-`;
-        }
-        if (result.warning) {
-          text = `${result.warning}
-
-${text}`;
-        }
-        return { content: [{ type: "text", text }] };
-      } catch (err) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: ${err instanceof Error ? err.message : String(err)}`
-            }
-          ],
-          isError: true
-        };
-      }
-    }
-  );
-}
-
-// src/tools/meta-ad-fatigue.ts
-import { z as z6 } from "zod";
-function registerGetMetaAdFatigue(server2) {
-  server2.tool(
-    "get_meta_ad_fatigue",
-    "Detect creative fatigue in active ads. Analyzes frequency, CTR decline, and CPA trends over the last 7 days at daily granularity. Grounded in knowledge base insights: wk-tw-001 (diagnostic patterns), ds-pt-003 (frequency thresholds), vs-nt-002 (degraded creative rules).",
-    {
-      ad_account_id: z6.string().describe("Meta ad account ID (e.g. act_123456789)"),
-      campaign_id: z6.string().optional().describe("Scope to a specific campaign"),
-      conversion_event: z6.string().optional().describe("Action type for CPA (default: mobile_app_install)"),
-      frequency_warning: z6.number().optional().describe("Frequency threshold for warning (default: 3)"),
-      frequency_critical: z6.number().optional().describe("Frequency threshold for critical (default: 5)"),
-      ctr_decline_threshold: z6.number().optional().describe(
-        "CTR decline % from peak to flag fatigue (default: 30)"
-      )
-    },
-    async ({
-      ad_account_id,
-      campaign_id,
-      conversion_event,
-      frequency_warning,
-      frequency_critical,
-      ctr_decline_threshold
-    }) => {
-      try {
-        const convEvent = conversion_event ?? "mobile_app_install";
-        const freqWarn = frequency_warning ?? 3;
-        const freqCrit = frequency_critical ?? 5;
-        const ctrThreshold = ctr_decline_threshold ?? 30;
-        const filtering = JSON.parse(activeFilter());
-        if (campaign_id) {
-          filtering.push({
-            field: "campaign.id",
-            operator: "EQUAL",
-            value: campaign_id
-          });
-        }
-        const result = await metaApiGet({
-          path: `/${ad_account_id}/insights`,
-          params: {
-            level: "ad",
-            time_increment: "1",
-            fields: "ad_id,ad_name,spend,impressions,clicks,ctr,cpm,frequency,actions,cost_per_action_type",
-            date_preset: "last_7d",
-            filtering: JSON.stringify(filtering),
-            limit: "500"
-          }
-        });
-        const rows = result.data.data;
-        if (!rows || rows.length === 0) {
-          return {
-            content: [
-              {
-                type: "text",
-                text: "No active ad data found for the last 7 days."
-              }
-            ]
-          };
-        }
-        const adMap = /* @__PURE__ */ new Map();
-        for (const row of rows) {
-          const adId = row.ad_id;
-          if (!adMap.has(adId)) {
-            adMap.set(adId, {
-              ad_id: adId,
-              ad_name: row.ad_name ?? adId,
-              days: []
-            });
-          }
-          adMap.get(adId).days.push({
-            date: row.date_start,
-            spend: parseFloat(row.spend || "0"),
-            impressions: parseInt(row.impressions || "0"),
-            clicks: parseInt(row.clicks || "0"),
-            ctr: parseFloat(row.ctr || "0"),
-            cpm: parseFloat(row.cpm || "0"),
-            frequency: parseFloat(row.frequency || "0"),
-            conversions: getActionValue(row.actions, convEvent),
-            cpa: getCostPerAction(row.cost_per_action_type, convEvent)
-          });
-        }
-        const results = [];
-        let totalSpend = 0;
-        for (const ad of adMap.values()) {
-          ad.days.sort(
-            (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()
-          );
-          const adSpend = ad.days.reduce((s, d) => s + d.spend, 0);
-          totalSpend += adSpend;
-          const avgFreq = ad.days.reduce((s, d) => s + d.frequency, 0) / ad.days.length;
-          const peakCtr = Math.max(...ad.days.map((d) => d.ctr));
-          const last3 = ad.days.slice(-3);
-          const recentCtr = last3.reduce((s, d) => s + d.ctr, 0) / last3.length;
-          const ctrDecline = peakCtr > 0 ? (peakCtr - recentCtr) / peakCtr * 100 : 0;
-          const mid = Math.floor(ad.days.length / 2);
-          const earlyDays = ad.days.slice(0, Math.max(mid, 1));
-          const lateDays = ad.days.slice(mid);
-          const earlyConv = earlyDays.reduce((s, d) => s + d.conversions, 0);
-          const earlySpend = earlyDays.reduce((s, d) => s + d.spend, 0);
-          const earlyCpa = earlyConv > 0 ? earlySpend / earlyConv : null;
-          const lateConv = lateDays.reduce((s, d) => s + d.conversions, 0);
-          const lateSpend = lateDays.reduce((s, d) => s + d.spend, 0);
-          const recentCpa = lateConv > 0 ? lateSpend / lateConv : null;
-          const cpaChange = earlyCpa !== null && recentCpa !== null && earlyCpa > 0 ? (recentCpa - earlyCpa) / earlyCpa * 100 : null;
-          let status2 = "HEALTHY";
-          let diagnosis = "Metrics stable \u2014 no fatigue detected.";
-          const highFreq = avgFreq >= freqCrit;
-          const medFreq = avgFreq >= freqWarn;
-          const ctrDeclining = ctrDecline >= ctrThreshold;
-          const cpaRising = cpaChange !== null && cpaChange > 20;
-          if (highFreq && cpaRising) {
-            status2 = "FATIGUED";
-            diagnosis = `Audience saturation: frequency ${avgFreq.toFixed(1)} + CPA rising ${cpaChange.toFixed(0)}% [wk-tw-001 #1, ds-pt-003]`;
-          } else if (ctrDeclining && cpaRising) {
-            status2 = "FATIGUED";
-            diagnosis = `Creative fatigue: CTR declined ${ctrDecline.toFixed(0)}% from peak + CPA rising ${cpaChange.toFixed(0)}% [wk-tw-001 #4]`;
-          } else if (highFreq) {
-            status2 = "WARNING";
-            diagnosis = `High frequency (${avgFreq.toFixed(1)}) \u2014 approaching saturation [ds-pt-003]. CPA ${cpaRising ? "rising" : "stable"}.`;
-          } else if (ctrDeclining) {
-            status2 = "WARNING";
-            diagnosis = `CTR declining ${ctrDecline.toFixed(0)}% from peak \u2014 early fatigue signal [wk-tw-001 #4].`;
-          } else if (medFreq && cpaRising) {
-            status2 = "WARNING";
-            diagnosis = `Frequency ${avgFreq.toFixed(1)} + CPA trending up ${cpaChange.toFixed(0)}% \u2014 monitor closely [wk-tw-001 #1].`;
-          }
-          results.push({
-            ad_id: ad.ad_id,
-            ad_name: ad.ad_name,
-            total_spend: adSpend,
-            avg_frequency: avgFreq,
-            peak_ctr: peakCtr,
-            recent_ctr: recentCtr,
-            ctr_decline_pct: ctrDecline,
-            early_cpa: earlyCpa,
-            recent_cpa: recentCpa,
-            cpa_change_pct: cpaChange,
-            status: status2,
-            diagnosis
-          });
-        }
-        const statusOrder = { FATIGUED: 0, WARNING: 1, HEALTHY: 2 };
-        results.sort(
-          (a, b) => statusOrder[a.status] - statusOrder[b.status] || b.total_spend - a.total_spend
-        );
-        const fatigued = results.filter((r) => r.status === "FATIGUED");
-        const warning = results.filter((r) => r.status === "WARNING");
-        const healthy = results.filter((r) => r.status === "HEALTHY");
-        const fatiguedSpend = fatigued.reduce((s, r) => s + r.total_spend, 0);
-        const spendConcentration = totalSpend > 0 ? fatiguedSpend / totalSpend * 100 : 0;
-        let text = `# Ad Fatigue Report
-
-`;
-        text += `**${results.length} ads analyzed** | ${fatigued.length} fatigued | ${warning.length} warning | ${healthy.length} healthy
-`;
-        text += `**Total spend:** $${totalSpend.toFixed(2)} | **Fatigued ad spend:** $${fatiguedSpend.toFixed(2)} (${spendConcentration.toFixed(0)}%)
-
-`;
-        if (spendConcentration > 50) {
-          text += `\u26A0 **Over 50% of spend is going to fatigued ads.** Urgent creative rotation needed.
-
-`;
-        }
-        text += `| Status | Ad | Spend | Freq | CTR (peak\u2192recent) | CPA Trend | Diagnosis |
-`;
-        text += `|--------|-----|-------|------|-------------------|-----------|------------|
-`;
-        for (const r of results) {
-          const icon = r.status === "FATIGUED" ? "\u{1F534}" : r.status === "WARNING" ? "\u{1F7E1}" : "\u{1F7E2}";
-          text += `| ${icon} ${r.status} | ${r.ad_name.slice(0, 30)} | $${r.total_spend.toFixed(0)} | ${r.avg_frequency.toFixed(1)} | ${r.peak_ctr.toFixed(2)}%\u2192${r.recent_ctr.toFixed(2)}% (${r.ctr_decline_pct > 0 ? "-" : ""}${r.ctr_decline_pct.toFixed(0)}%) | ${r.cpa_change_pct !== null ? `${r.cpa_change_pct > 0 ? "+" : ""}${r.cpa_change_pct.toFixed(0)}%` : "N/A"} | ${r.diagnosis} |
-`;
-        }
-        text += `
-## Recommendations
-
-`;
-        if (fatigued.length > 0) {
-          text += `### Fatigued Ads (${fatigued.length})
-- **Rotate with genuinely new creative concepts**, not variations. Meta's Andromeda requires at least 25% visual difference to treat it as a new ad [lp-pt-001, oh-li-001].
-- **Change the hook** (first 3 seconds) to access new audience segments [oh-li-005].
-- **Do NOT re-test degraded creatives** \u2014 exhaust all other angles first. Wait 3-6 months before revisiting [vs-nt-002].
-- Meta will auto-shift spend away from degrading creatives [vs-nt-001] \u2014 don't panic-pause, but do prepare replacements.
-
-`;
-        }
-        if (healthy.length > 0) {
-          text += `### Healthy Ads (${healthy.length})
-- Let Meta manage allocation. Don't force spend to low-spend winners \u2014 Meta has determined scaling them would degrade performance [ds-pt-004].
-
-`;
-        }
-        if (result.warning) {
-          text = `${result.warning}
-
-${text}`;
-        }
-        return { content: [{ type: "text", text }] };
-      } catch (err) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: ${err instanceof Error ? err.message : String(err)}`
-            }
-          ],
-          isError: true
-        };
-      }
-    }
-  );
-}
-
 // src/tools/google-campaigns.ts
-import { z as z7 } from "zod";
+import { z as z2 } from "zod";
 
 // src/google/oauth.ts
 var TOKEN_URL = "https://oauth2.googleapis.com/token";
@@ -944,6 +267,30 @@ function formatGoogleAdsError(err) {
   }
   return `Google Ads API error (${code}): ${err.message}`;
 }
+async function googleAdsMutate(customerId, operations) {
+  const auth = getGoogleAdsAuth();
+  const normalizedId = normalizeCustomerId(customerId);
+  const headers = await auth.getHeaders(normalizedId);
+  const url = `${BASE_URL}/customers/${normalizedId}/googleAds:mutate`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      ...headers,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ mutateOperations: operations })
+  });
+  const body = await response.json();
+  if (!response.ok) {
+    if (isGoogleAdsError(body)) {
+      throw new Error(formatGoogleAdsError(body.error));
+    }
+    throw new Error(
+      `Google Ads API mutate returned ${response.status}: ${JSON.stringify(body)}`
+    );
+  }
+  return body;
+}
 async function googleAdsQuery(customerId, query) {
   const auth = getGoogleAdsAuth();
   const normalizedId = normalizeCustomerId(customerId);
@@ -1072,10 +419,10 @@ function registerGetGoogleAdsCampaigns(server2) {
     "get_google_ads_campaigns",
     "List Google App Campaigns with status, bid strategy, budgets, and app info. Campaign naming conventions encode dimensions (app, event, country, OS) \u2014 surface the raw name for parsing. Requires Google Ads credentials \u2014 run `npx mobile-growth-mcp auth google` to set up.",
     {
-      customer_id: z7.string().describe("Google Ads customer ID (e.g. 123-456-7890 or 1234567890)"),
-      status: z7.array(z7.enum(["ENABLED", "PAUSED", "REMOVED"])).optional().describe('Filter by campaign status. Default: ["ENABLED"]'),
-      channel_sub_type: z7.array(z7.enum(["APP_CAMPAIGN", "APP_CAMPAIGN_FOR_ENGAGEMENT"])).optional().describe('Filter by sub-type. Default: ["APP_CAMPAIGN", "APP_CAMPAIGN_FOR_ENGAGEMENT"]. Set to include all app campaign types'),
-      limit: z7.number().min(1).max(100).optional().describe("Max campaigns to return (default 50)")
+      customer_id: z2.string().describe("Google Ads customer ID (e.g. 123-456-7890 or 1234567890)"),
+      status: z2.array(z2.enum(["ENABLED", "PAUSED", "REMOVED"])).optional().describe('Filter by campaign status. Default: ["ENABLED"]'),
+      channel_sub_type: z2.array(z2.enum(["APP_CAMPAIGN", "APP_CAMPAIGN_FOR_ENGAGEMENT"])).optional().describe('Filter by sub-type. Default: ["APP_CAMPAIGN", "APP_CAMPAIGN_FOR_ENGAGEMENT"]. Set to include all app campaign types'),
+      limit: z2.number().min(1).max(100).optional().describe("Max campaigns to return (default 50)")
     },
     async ({ customer_id, status: status2, channel_sub_type, limit }) => {
       try {
@@ -1156,16 +503,16 @@ function registerGetGoogleAdsCampaigns(server2) {
 }
 
 // src/tools/google-ad-groups.ts
-import { z as z8 } from "zod";
+import { z as z3 } from "zod";
 function registerGetGoogleAdsAdGroups(server2) {
   server2.tool(
     "get_google_ad_groups",
     "List ad groups within Google App Campaigns. In UAC, ad groups represent creative themes (e.g. 'at_home_workouts'). The algorithm allocates spend across ad groups based on which themes resonate \u2014 observe spend distribution to identify winning messaging angles. To scale, add new ad groups with different text-asset strategies rather than aggressively increasing bids (ab-pt-006).",
     {
-      customer_id: z8.string().describe("Google Ads customer ID (e.g. 123-456-7890 or 1234567890)"),
-      campaign_id: z8.string().optional().describe("Scope to a specific campaign. If omitted, returns ad groups across all app campaigns"),
-      status: z8.array(z8.enum(["ENABLED", "PAUSED", "REMOVED"])).optional().describe('Filter by ad group status. Default: ["ENABLED"]'),
-      limit: z8.number().min(1).max(100).optional().describe("Max results to return (default 50)")
+      customer_id: z3.string().describe("Google Ads customer ID (e.g. 123-456-7890 or 1234567890)"),
+      campaign_id: z3.string().optional().describe("Scope to a specific campaign. If omitted, returns ad groups across all app campaigns"),
+      status: z3.array(z3.enum(["ENABLED", "PAUSED", "REMOVED"])).optional().describe('Filter by ad group status. Default: ["ENABLED"]'),
+      limit: z3.number().min(1).max(100).optional().describe("Max results to return (default 50)")
     },
     async ({ customer_id, campaign_id, status: status2, limit }) => {
       try {
@@ -1236,7 +583,7 @@ function registerGetGoogleAdsAdGroups(server2) {
 }
 
 // src/tools/google-assets.ts
-import { z as z9 } from "zod";
+import { z as z4 } from "zod";
 var SLOT_LIMITS = {
   HEADLINE: 5,
   DESCRIPTION: 5,
@@ -1255,12 +602,12 @@ function registerGetGoogleAdsAssets(server2) {
     "get_google_assets",
     "List creative assets linked to a campaign or ad group with metadata, performance labels, and slot utilization audit. Google allows up to 5 headlines, 5 descriptions, 20 images, 20 videos, 20 HTML5 per ad group. Missing asset types mean missing inventory channels. Google's built-in asset ratings (Low/Good/Best) measure scalability, not conversion value \u2014 evaluate by your own CPA/ROAS (ab-pt-008).",
     {
-      customer_id: z9.string().describe("Google Ads customer ID"),
-      campaign_id: z9.string().optional().describe("Scope to a specific campaign"),
-      ad_group_id: z9.string().optional().describe("Scope to a specific ad group"),
-      asset_type: z9.array(z9.enum(["IMAGE", "YOUTUBE_VIDEO", "TEXT", "MEDIA_BUNDLE"])).optional().describe("Filter by asset type"),
-      include_slot_audit: z9.boolean().optional().describe("Include slot utilization audit (default true)"),
-      limit: z9.number().min(1).max(500).optional().describe("Max results to return (default 50)")
+      customer_id: z4.string().describe("Google Ads customer ID"),
+      campaign_id: z4.string().optional().describe("Scope to a specific campaign"),
+      ad_group_id: z4.string().optional().describe("Scope to a specific ad group"),
+      asset_type: z4.array(z4.enum(["IMAGE", "YOUTUBE_VIDEO", "TEXT", "MEDIA_BUNDLE"])).optional().describe("Filter by asset type"),
+      include_slot_audit: z4.boolean().optional().describe("Include slot utilization audit (default true)"),
+      limit: z4.number().min(1).max(500).optional().describe("Max results to return (default 50)")
     },
     async ({ customer_id, campaign_id, ad_group_id, asset_type, include_slot_audit, limit }) => {
       try {
@@ -1444,7 +791,7 @@ function registerGetGoogleAdsAssets(server2) {
 }
 
 // src/tools/google-insights.ts
-import { z as z10 } from "zod";
+import { z as z5 } from "zod";
 function parseNum(v) {
   if (v === void 0 || v === null) return 0;
   if (typeof v === "number") return v;
@@ -1501,19 +848,19 @@ function registerGetGoogleAdsInsights(server2) {
     "get_google_insights",
     "Pull performance metrics from Google Ads with configurable level, breakdowns, date ranges, and time granularity. Use network breakdown to detect traffic shifts between Search, Display/AdMob, and YouTube \u2014 the #1 diagnostic lever for Google campaigns (ab-pt-005). Supports campaign, ad_group, asset, and account levels.",
     {
-      customer_id: z10.string().describe("Google Ads customer ID"),
-      level: z10.enum(["account", "campaign", "ad_group", "asset"]).optional().describe("Aggregation level (default: campaign)"),
-      campaign_id: z10.string().optional().describe("Scope to specific campaign"),
-      ad_group_id: z10.string().optional().describe("Scope to specific ad group"),
-      breakdown: z10.enum(["network", "device"]).optional().describe("Segmentation dimension. Only one at a time (GAQL restriction)"),
-      date_range: z10.object({
-        start_date: z10.string().describe("YYYY-MM-DD"),
-        end_date: z10.string().describe("YYYY-MM-DD")
+      customer_id: z5.string().describe("Google Ads customer ID"),
+      level: z5.enum(["account", "campaign", "ad_group", "asset"]).optional().describe("Aggregation level (default: campaign)"),
+      campaign_id: z5.string().optional().describe("Scope to specific campaign"),
+      ad_group_id: z5.string().optional().describe("Scope to specific ad group"),
+      breakdown: z5.enum(["network", "device"]).optional().describe("Segmentation dimension. Only one at a time (GAQL restriction)"),
+      date_range: z5.object({
+        start_date: z5.string().describe("YYYY-MM-DD"),
+        end_date: z5.string().describe("YYYY-MM-DD")
       }).optional().describe("Custom date range. Overrides date_preset"),
-      date_preset: z10.enum(["LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH"]).optional().describe("Predefined date range (default: LAST_7_DAYS)"),
-      time_increment: z10.enum(["daily", "weekly", "monthly", "summary"]).optional().describe("Time granularity (default: summary)"),
-      sort: z10.enum(["cost_desc", "conversions_desc", "impressions_desc", "ctr_desc"]).optional().describe("Sort order (default: cost_desc)"),
-      limit: z10.number().min(1).max(500).optional().describe("Max results (default 50)")
+      date_preset: z5.enum(["LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH"]).optional().describe("Predefined date range (default: LAST_7_DAYS)"),
+      time_increment: z5.enum(["daily", "weekly", "monthly", "summary"]).optional().describe("Time granularity (default: summary)"),
+      sort: z5.enum(["cost_desc", "conversions_desc", "impressions_desc", "ctr_desc"]).optional().describe("Sort order (default: cost_desc)"),
+      limit: z5.number().min(1).max(500).optional().describe("Max results (default 50)")
     },
     async ({ customer_id, level, campaign_id, ad_group_id, breakdown, date_range, date_preset, time_increment, sort, limit }) => {
       try {
@@ -1691,7 +1038,7 @@ function registerGetGoogleAdsInsights(server2) {
 }
 
 // src/tools/google-network-mix.ts
-import { z as z11 } from "zod";
+import { z as z6 } from "zod";
 function parseNum2(v) {
   if (v === void 0 || v === null) return 0;
   if (typeof v === "number") return v;
@@ -1703,13 +1050,13 @@ function registerGetGoogleAdsNetworkMix(server2) {
     "get_google_network_mix",
     "Analyze traffic distribution across Google's ad networks (Search, Display/AdMob, YouTube) over time. Computes spend share % per network per day and flags significant shifts. Traffic shifts signal performance problems \u2014 a sudden shift to Display/MGDN tanks CPA. Google optimizes for Google's revenue alongside yours; use this to detect shifts to low-quality inventory (ab-pt-005, ab-pt-017).",
     {
-      customer_id: z11.string().describe("Google Ads customer ID"),
-      campaign_id: z11.string().optional().describe("Scope to one campaign. If omitted, aggregates across all app campaigns"),
-      date_range: z11.object({
-        start_date: z11.string().describe("YYYY-MM-DD"),
-        end_date: z11.string().describe("YYYY-MM-DD")
+      customer_id: z6.string().describe("Google Ads customer ID"),
+      campaign_id: z6.string().optional().describe("Scope to one campaign. If omitted, aggregates across all app campaigns"),
+      date_range: z6.object({
+        start_date: z6.string().describe("YYYY-MM-DD"),
+        end_date: z6.string().describe("YYYY-MM-DD")
       }).optional().describe("Custom date range. Default: last 14 days"),
-      shift_threshold_pct: z11.number().optional().describe("Flag networks whose spend share changed by more than this % (default 10)")
+      shift_threshold_pct: z6.number().optional().describe("Flag networks whose spend share changed by more than this % (default 10)")
     },
     async ({ customer_id, campaign_id, date_range, shift_threshold_pct }) => {
       try {
@@ -1876,7 +1223,7 @@ function registerGetGoogleAdsNetworkMix(server2) {
 }
 
 // src/tools/google-asset-fatigue.ts
-import { z as z12 } from "zod";
+import { z as z7 } from "zod";
 function parseNum3(v) {
   if (v === void 0 || v === null) return 0;
   if (typeof v === "number") return v;
@@ -1916,13 +1263,13 @@ function registerGetGoogleAdsAssetFatigue(server2) {
     "get_google_asset_fatigue",
     "Detect creative asset fatigue in Google UAC campaigns by analyzing per-asset impression trends, CTR decline, and CPA deterioration. Also checks asset age against Google's 2-week learning minimum and 2-3 month refresh cadence. Google doesn't expose per-asset frequency \u2014 uses impression volume decay as the primary fatigue signal. Never remove assets within first 2 weeks (goog-pdf-018). Google's performance label measures scalability, not fatigue (ab-pt-008).",
     {
-      customer_id: z12.string().describe("Google Ads customer ID"),
-      campaign_id: z12.string().describe("Campaign to analyze"),
-      ad_group_id: z12.string().optional().describe("Scope to specific ad group"),
-      lookback_days: z12.number().min(7).max(90).optional().describe("Days of daily data to analyze (default 14)"),
-      ctr_decline_threshold_pct: z12.number().optional().describe("CTR decline % from peak to flag fatigue (default 30)"),
-      impression_decay_threshold_pct: z12.number().optional().describe("Impression volume drop % from peak to flag (default 50)"),
-      asset_type: z12.array(z12.enum(["IMAGE", "YOUTUBE_VIDEO", "TEXT"])).optional().describe("Filter by asset type")
+      customer_id: z7.string().describe("Google Ads customer ID"),
+      campaign_id: z7.string().describe("Campaign to analyze"),
+      ad_group_id: z7.string().optional().describe("Scope to specific ad group"),
+      lookback_days: z7.number().min(7).max(90).optional().describe("Days of daily data to analyze (default 14)"),
+      ctr_decline_threshold_pct: z7.number().optional().describe("CTR decline % from peak to flag fatigue (default 30)"),
+      impression_decay_threshold_pct: z7.number().optional().describe("Impression volume drop % from peak to flag (default 50)"),
+      asset_type: z7.array(z7.enum(["IMAGE", "YOUTUBE_VIDEO", "TEXT"])).optional().describe("Filter by asset type")
     },
     async ({ customer_id, campaign_id, ad_group_id, lookback_days, ctr_decline_threshold_pct, impression_decay_threshold_pct, asset_type }) => {
       try {
@@ -2173,11 +1520,173 @@ Sources: goog-pdf-018, ab-pt-008, goog-pdf-019, ab-pt-007
   );
 }
 
+// src/tools/google-upload-assets.ts
+import { z as z8 } from "zod";
+import { readFile } from "fs/promises";
+import { basename, resolve } from "path";
+async function fetchAsBase64(url) {
+  if (url.startsWith("data:")) {
+    const commaIdx = url.indexOf(",");
+    if (commaIdx === -1) throw new Error("Invalid data URI");
+    return url.slice(commaIdx + 1);
+  }
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status}`);
+  const buf = Buffer.from(await res.arrayBuffer());
+  return buf.toString("base64");
+}
+async function readFileAsBase64(filePath) {
+  const buf = await readFile(resolve(filePath));
+  return buf.toString("base64");
+}
+function registerUploadGoogleImageAssets(server2) {
+  server2.tool(
+    "upload_google_image_assets",
+    "Upload image assets to a Google Ads account. Accepts URLs or local file paths. Each image becomes an Asset resource in the account. Optionally link assets to a campaign or ad group after upload. Supports batch upload (up to 50 images per call).",
+    {
+      customer_id: z8.string().describe("Google Ads customer ID"),
+      images: z8.array(
+        z8.object({
+          source: z8.string().describe(
+            "Image URL (https://...) or local file path (/path/to/image.png)"
+          ),
+          name: z8.string().optional().describe(
+            "Asset name in Google Ads (default: filename from source)"
+          )
+        })
+      ).min(1).max(50).describe("Array of images to upload (max 50 per call)"),
+      campaign_id: z8.string().optional().describe(
+        "Link uploaded assets to this campaign (creates CampaignAsset links)"
+      ),
+      ad_group_id: z8.string().optional().describe(
+        "Link uploaded assets to this ad group (creates AdGroupAsset links). Takes priority over campaign_id."
+      ),
+      field_type: z8.enum(["IMAGE", "LANDSCAPE_LOGO", "LOGO", "MARKETING_IMAGE", "SQUARE_MARKETING_IMAGE", "PORTRAIT_MARKETING_IMAGE"]).optional().describe("Asset field type when linking to campaign/ad group (default: IMAGE)"),
+      dry_run: z8.boolean().optional().describe("Preview what would be uploaded without making changes")
+    },
+    async ({
+      customer_id,
+      images,
+      campaign_id,
+      ad_group_id,
+      field_type,
+      dry_run
+    }) => {
+      try {
+        const normalizedId = normalizeCustomerId(customer_id);
+        const effectiveFieldType = field_type ?? "IMAGE";
+        if (dry_run) {
+          let text2 = `**Dry run** \u2014 would upload ${images.length} image(s) to customer ${customer_id}
+
+`;
+          for (const img of images) {
+            const name = img.name ?? basename(img.source).replace(/\?.*$/, "") ?? "unnamed";
+            text2 += `- ${name} \u2190 ${img.source}
+`;
+          }
+          if (ad_group_id) {
+            text2 += `
+Would link to ad group ${ad_group_id} as ${effectiveFieldType}`;
+          } else if (campaign_id) {
+            text2 += `
+Would link to campaign ${campaign_id} as ${effectiveFieldType}`;
+          }
+          return { content: [{ type: "text", text: text2 }] };
+        }
+        const assetOps = [];
+        const assetNames = [];
+        for (const img of images) {
+          const name = img.name ?? basename(img.source).replace(/\?.*$/, "") ?? "unnamed";
+          assetNames.push(name);
+          const isUrl = img.source.startsWith("http://") || img.source.startsWith("https://") || img.source.startsWith("data:");
+          const data = isUrl ? await fetchAsBase64(img.source) : await readFileAsBase64(img.source);
+          assetOps.push({
+            assetOperation: {
+              create: {
+                name,
+                type: "IMAGE",
+                imageAsset: { data }
+              }
+            }
+          });
+        }
+        const assetResult = await googleAdsMutate(normalizedId, assetOps);
+        const createdResourceNames = assetResult.mutateOperationResponses.map(
+          (r) => r.assetResult?.resourceName ?? ""
+        );
+        const successCount = createdResourceNames.filter(Boolean).length;
+        let text = `**Uploaded ${successCount}/${images.length} image assets**
+
+`;
+        for (let i = 0; i < images.length; i++) {
+          const rn = createdResourceNames[i];
+          if (rn) {
+            text += `\u2713 ${assetNames[i]} \u2192 ${rn}
+`;
+          } else {
+            text += `\u2717 ${assetNames[i]} \u2014 failed
+`;
+          }
+        }
+        if (successCount > 0 && (ad_group_id || campaign_id)) {
+          const linkOps = [];
+          for (const resourceName of createdResourceNames) {
+            if (!resourceName) continue;
+            if (ad_group_id) {
+              linkOps.push({
+                adGroupAssetOperation: {
+                  create: {
+                    adGroup: `customers/${normalizedId}/adGroups/${ad_group_id}`,
+                    asset: resourceName,
+                    fieldType: effectiveFieldType
+                  }
+                }
+              });
+            } else if (campaign_id) {
+              linkOps.push({
+                campaignAssetOperation: {
+                  create: {
+                    campaign: `customers/${normalizedId}/campaigns/${campaign_id}`,
+                    asset: resourceName,
+                    fieldType: effectiveFieldType
+                  }
+                }
+              });
+            }
+          }
+          try {
+            await googleAdsMutate(normalizedId, linkOps);
+            const linkTarget = ad_group_id ? `ad group ${ad_group_id}` : `campaign ${campaign_id}`;
+            text += `
+\u2713 Linked ${successCount} assets to ${linkTarget} as ${effectiveFieldType}`;
+          } catch (linkErr) {
+            text += `
+\u26A0\uFE0F Assets uploaded but linking failed: ${linkErr instanceof Error ? linkErr.message : String(linkErr)}`;
+            text += `
+Assets exist in the account and can be linked manually.`;
+          }
+        }
+        return { content: [{ type: "text", text }] };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error: ${err instanceof Error ? err.message : String(err)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/tools/connection-status.ts
 function registerConnectionStatus(server2, status2) {
   server2.tool(
     "connection_status",
-    "Check the connection status of the knowledge base and Meta API. Call this if tools seem missing or you get unexpected errors.",
+    "Check the connection status of the knowledge base and Google Ads API. Call this if tools seem missing or you get unexpected errors.",
     {},
     async () => {
       const lines = ["# Connection Status", ""];
@@ -2201,26 +1710,11 @@ function registerConnectionStatus(server2, status2) {
         );
       }
       lines.push("");
-      if (status2.meta.tokenConfigured) {
-        lines.push(
-          "## Meta Marketing API: Configured",
-          "- Meta tools are available and ready to use"
-        );
-      } else {
-        lines.push(
-          "## Meta Marketing API: Not Connected (Optional)",
-          "- KB, suggestions, and private insights work without it",
-          "- Connect Meta to unlock live campaign data and reports",
-          "",
-          "### How to connect",
-          "Provide your Meta access token using one of these methods:",
-          '1. MCP config: add `"META_ACCESS_TOKEN": "..."` to the `"env"` block in `.mcp.json` (Claude Code/Cursor) or `claude_desktop_config.json` (Claude Desktop)',
-          "2. CLI argument: add `--meta-token=...` to the args array",
-          "3. `.env` file: add `META_ACCESS_TOKEN=...` to a `.env` file in your working directory",
-          "",
-          "Then restart your MCP client."
-        );
-      }
+      lines.push(
+        "## Meta Ads Data: Use Meta's Official AI Connector",
+        "- This MCP no longer ships Meta API tools (avoids unofficial-API risk).",
+        "- For Meta data, install Meta's official Meta Ads MCP / AI connector and let the analytical skills here interpret what it returns."
+      );
       lines.push("");
       if (status2.google.configured) {
         lines.push(
@@ -2307,7 +1801,9 @@ var TOPICS = [
   "competitive_analysis",
   "ad_copy",
   "conversion_rate",
-  "strategy"
+  "strategy",
+  "psychology",
+  "compliance"
 ];
 var APPLIES_TO = [
   "subscription_apps",
@@ -2367,15 +1863,17 @@ function registerVocabularyResource(server2) {
 }
 
 // src/resources/instructions.ts
-var INSTRUCTIONS = `# Mobile Growth MCP \u2014 Knowledge Base + Ad Platform Tools
+var INSTRUCTIONS = `# Mobile Growth MCP \u2014 Knowledge Base + Analysis Skills
 
 ## Welcome
 
-You're connected to the Mobile Growth knowledge base \u2014 curated expert insights on mobile advertising, campaign optimization, and subscription app growth \u2014 plus direct Meta and Google Ads API integration.
+You're connected to the Mobile Growth knowledge base \u2014 curated expert insights on mobile advertising, campaign optimization, and subscription app growth \u2014 plus Google Ads API integration and a library of analytical skills.
 
 **The knowledge base is always on.** Use \`search_insights\` freely \u2014 before making recommendations, when diagnosing issues, or exploring strategies. The more specific your query, the better the results.
 
-> **Note:** Connecting Meta or Google Ads is optional. The knowledge base, community suggestions, and private insights all work with just your API key. Add Meta or Google Ads credentials later if you want live campaign data and reports.
+> **For Meta Ads data**, use Meta's official Meta Ads MCP / AI connector. This MCP intentionally does **not** ship Meta API tools \u2014 instead, the analytical skills here (ad-fatigue-report, weekly-performance, audit-meta-account, etc.) interpret data fetched from Meta's official connector or pasted from CSV exports.
+>
+> Connecting Google Ads is optional. The knowledge base, community suggestions, and private insights all work with just your API key.
 
 Quick examples:
 - "subscription app creative fatigue signals"
@@ -2386,7 +1884,7 @@ Quick examples:
 If you can't find what you need, call \`submit_feedback\` to report the gap \u2014 it helps us improve the knowledge base.
 
 ## What This Is
-A curated knowledge base of mobile advertising insights + direct Meta Marketing API and Google Ads API integration. Query expert knowledge, pull live campaign data, and run pre-built reports \u2014 all from your LLM.
+A curated knowledge base of mobile advertising insights + Google Ads API integration + analytical skills (Meta + Google) that interpret data from the platforms' own MCPs/CSV exports.
 
 ---
 
@@ -2429,50 +1927,20 @@ Save knowledge that is private to your API key. Immediately searchable but only
 - Same full schema as suggest_insight
 - No admin approval needed \u2014 saved instantly
 
+### suggest_skill
+Propose a new skill (repeatable workflow) for the knowledge base. **Use this when a user describes a workflow they want automated** \u2014 recurring audits, analyses, or procedures they run regularly.
+- **Before calling**: draft the full skill .md yourself. Canonical format: "## What It Does", "## When to Use This" (bullet triggers), "## What It Needs" (data sources + exact CSV export instructions), "## Procedure" (numbered steps with tool calls or CSV column specs), "## Output".
+- Pass the draft as content_md. Only use user_description without a draft if the user wants to submit a rough idea for the admin to develop.
+- Provide when_to_use phrases and data_sources (meta_api / google_ads_api / csv / manual_input)
+- Submissions go to admin review before becoming live
+
 ---
 
-## Meta Marketing API Tools
-
-**Requires META_ACCESS_TOKEN env var** \u2014 without it, these tools return a clear error. Knowledge base tools work with just API_KEY.
-
-**Rate limit safety**: All tools default to last_7d, active-only, minimal fields. No auto-pagination. Throttle header monitored \u2014 warns at >75% utilization.
-
-### get_meta_campaigns
-List campaigns from a Meta ad account. Defaults to active campaigns.
-- **ad_account_id** (required): e.g. "act_123456789"
-- **fields, effective_status, limit, after** (optional)
-
-### get_meta_adsets
-List ad sets, optionally scoped to a campaign.
-- **ad_account_id** (required)
-- **campaign_id** (optional): Scope to specific campaign
-- **fields, effective_status, limit, after** (optional)
-
-### get_meta_ads
-List ads, optionally scoped to an ad set.
-- **ad_account_id** (required)
-- **adset_id** (optional): Scope to specific ad set
-- **fields, effective_status, limit, after** (optional)
-
-### get_meta_insights
-Pull performance insights with configurable level, breakdowns, date range.
-- **ad_account_id** (required)
-- **level** (optional): account, campaign, adset, ad (default: campaign)
-- **date_preset** (optional): default last_7d
-- **time_range** (optional): {since, until} for custom dates
-- **time_increment** (optional): "1" for daily, "7" for weekly
-- **breakdowns** (optional): e.g. "age,gender" or "publisher_platform,platform_position"
-- **conversion_event** (optional): default "mobile_app_install"
-- **fields, filtering, sort, limit, after** (optional)
-
-### get_meta_ad_fatigue
-Built-in report: detect creative fatigue via frequency, CTR decline, CPA trends.
-- **ad_account_id** (required)
-- **campaign_id** (optional): Scope to specific campaign
-- **conversion_event** (optional): default "mobile_app_install"
-- **frequency_warning** (optional): default 3
-- **frequency_critical** (optional): default 5
-- **ctr_decline_threshold** (optional): default 30%
+## Meta Ads Data \u2014 Use Meta's Official AI Connector
+
+This MCP **does not ship Meta API tools**. Use Meta's official Meta Ads MCP / AI connector to fetch campaign data, performance metrics, audiences, and catalog operations. Then run the analytical skills below to interpret what comes back.
+
+This separation keeps users out of unofficial-API risk while preserving the analytical value (KB-grounded methodology) that this MCP provides.
 
 ---
 
@@ -2539,19 +2007,19 @@ Detect creative asset fatigue by analyzing per-asset impression trends, CTR decl
 
 ## Reports (MCP Prompts)
 
-Pre-built analysis workflows for Meta accounts. Select a prompt and provide your ad_account_id to run:
+Pre-built analytical workflows. Each skill expects either Meta MCP\u2013sourced data (use Meta's official AI connector) or CSV exports from Ads Manager. Select a prompt and provide your \`ad_account_id\` to run:
 
-| Prompt | What it does | API calls |
-|--------|-------------|-----------|
-| ad-fatigue-report | Detect creative fatigue with daily granularity | 1 |
-| weekly-performance | Week-over-week health comparison with diagnosis | 2 |
-| creative-performance | Categorize ads by health status | 1 |
-| audience-composition | Age x gender heatmap with CPA analysis | 1-2 |
-| architecture-review | Campaign structure evaluation | 3 (no insights) |
-| audit-meta-account | Comprehensive account audit | 6+ |
-| campaign-comparison | Side-by-side campaign comparison | 3+ |
-| placement-audit | Detailed placement audit with examples | 1 per campaign |
-| attribution-analysis | Conversion quality validation | 2+ |
+| Prompt | What it does |
+|--------|-------------|
+| ad-fatigue-report | Detect creative fatigue with daily granularity |
+| weekly-performance | Week-over-week health comparison with diagnosis |
+| creative-performance | Categorize ads by health status |
+| audience-composition | Age \xD7 gender heatmap with CPA analysis |
+| architecture-review | Campaign structure evaluation |
+| audit-meta-account | Comprehensive account audit |
+| campaign-comparison | Side-by-side campaign comparison |
+| placement-audit | Detailed placement audit with examples |
+| attribution-analysis | Conversion quality validation |
 
 ---
 
@@ -2579,9 +2047,9 @@ When your response draws on knowledge base results, **always attribute visibly**
 5. Use \`get_google_asset_fatigue\` on specific campaigns to detect creative decay
 
 ### For Meta analysis:
-1. Start with \`get_meta_campaigns\` to see account structure
-2. Use reports (MCP prompts) for comprehensive analysis
-3. For custom analysis, use \`get_meta_insights\` with breakdowns
+1. Use Meta's official Meta Ads MCP / AI connector to fetch the data
+2. Run a report (MCP prompt) here to interpret it against the knowledge base
+3. For custom analysis, ask the user to paste a CSV export and use the skill's Option B path
 
 ### General:
 - Always \`search_insights\` before making recommendations \u2014 ground advice in expert knowledge
@@ -2605,16 +2073,9 @@ function buildStatusSection(status2) {
       "  - Fix: provide your API key via `--api-key=me_...` CLI arg, `API_KEY` env var, or `.env` file"
     );
   }
-  if (status2.meta.tokenConfigured) {
-    lines.push("- **Meta Marketing API**: Token configured");
-  } else {
-    lines.push(
-      "- **Meta Marketing API**: Not connected (optional \u2014 KB works without it)"
-    );
-    lines.push(
-      "  - To connect: provide your token via `--meta-token=...` CLI arg, `META_ACCESS_TOKEN` env var, or `.env` file"
-    );
-  }
+  lines.push(
+    "- **Meta Ads Data**: Use Meta's official Meta Ads MCP / AI connector \u2014 this MCP no longer ships Meta API tools"
+  );
   if (status2.google.configured) {
     lines.push("- **Google Ads API**: Configured");
   } else {
@@ -2689,7 +2150,7 @@ function getDotEnv() {
   }
   return dotEnvCache;
 }
-function resolve(envName, cliName) {
+function resolve2(envName, cliName) {
   const cli = getCliArg(cliName);
   if (cli) return { value: cli, source: `--${cliName} argument` };
   const env = process.env[envName]?.trim();
@@ -2699,17 +2160,14 @@ function resolve(envName, cliName) {
   return { value: void 0, source: "not configured" };
 }
 function resolveApiKey() {
-  return resolve("API_KEY", "api-key");
-}
-function resolveMetaToken() {
-  return resolve("META_ACCESS_TOKEN", "meta-token");
+  return resolve2("API_KEY", "api-key");
 }
 function resolveGoogleAdsConfig() {
-  const devToken = resolve("GOOGLE_ADS_DEVELOPER_TOKEN", "google-dev-token");
-  const clientId = resolve("GOOGLE_ADS_CLIENT_ID", "google-client-id");
-  const clientSecret = resolve("GOOGLE_ADS_CLIENT_SECRET", "google-client-secret");
-  const refreshToken = resolve("GOOGLE_ADS_REFRESH_TOKEN", "google-refresh-token");
-  const loginCustomerId = resolve("GOOGLE_ADS_LOGIN_CUSTOMER_ID", "google-login-customer-id");
+  const devToken = resolve2("GOOGLE_ADS_DEVELOPER_TOKEN", "google-dev-token");
+  const clientId = resolve2("GOOGLE_ADS_CLIENT_ID", "google-client-id");
+  const clientSecret = resolve2("GOOGLE_ADS_CLIENT_SECRET", "google-client-secret");
+  const refreshToken = resolve2("GOOGLE_ADS_REFRESH_TOKEN", "google-refresh-token");
+  const loginCustomerId = resolve2("GOOGLE_ADS_LOGIN_CUSTOMER_ID", "google-login-customer-id");
   const required = [
     { name: "GOOGLE_ADS_DEVELOPER_TOKEN", result: devToken },
     { name: "GOOGLE_ADS_CLIENT_ID", result: clientId },
@@ -2752,8 +2210,8 @@ async function maybeRunAuthCommand() {
   process.exit(0);
 }
 function prompt(rl, question) {
-  return new Promise((resolve2) => {
-    rl.question(question, (answer) => resolve2(answer.trim()));
+  return new Promise((resolve3) => {
+    rl.question(question, (answer) => resolve3(answer.trim()));
   });
 }
 function openBrowser(url) {
@@ -2841,7 +2299,7 @@ function saveToEnv(vars) {
   }
 }
 async function waitForOAuthCallback(clientId, clientSecret) {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     const server2 = createServer(
       async (req, res) => {
         const url = new URL(req.url ?? "/", `http://localhost:${OAUTH_PORT}`);
@@ -2896,7 +2354,7 @@ async function waitForOAuthCallback(clientId, clientSecret) {
             "<html><body><h2>Success!</h2><p>You can close this tab and return to the terminal.</p></body></html>"
           );
           server2.close();
-          resolve2({ refreshToken: tokenData.refresh_token });
+          resolve3({ refreshToken: tokenData.refresh_token });
         } catch (err) {
           res.writeHead(500, { "Content-Type": "text/html" });
           res.end(
@@ -3000,10 +2458,8 @@ Error: ${err instanceof Error ? err.message : String(err)}`
 // src/index.ts
 await maybeRunAuthCommand();
 var apiKeyResult = resolveApiKey();
-var metaTokenResult = resolveMetaToken();
 var googleAdsResult = resolveGoogleAdsConfig();
 if (apiKeyResult.value) process.env.API_KEY = apiKeyResult.value;
-if (metaTokenResult.value) process.env.META_ACCESS_TOKEN = metaTokenResult.value;
 if (googleAdsResult.developerToken)
   process.env.GOOGLE_ADS_DEVELOPER_TOKEN = googleAdsResult.developerToken;
 if (googleAdsResult.clientId)
@@ -3018,9 +2474,6 @@ var apiKey = apiKeyResult.value;
 console.error(
   apiKey ? `API key: ${apiKeyResult.source}` : "API key: not configured \u2014 KB tools will not be available"
 );
-console.error(
-  metaTokenResult.value ? `Meta token: ${metaTokenResult.source}` : "Meta token: not configured (optional \u2014 KB works without it)"
-);
 console.error(
   googleAdsResult.configured ? `Google Ads: configured` : `Google Ads: not configured (optional \u2014 KB works without it). Run \`npx mobile-growth-mcp auth google\` to set up`
 );
@@ -3030,7 +2483,6 @@ var server = new McpServer({
 });
 var status = {
   kb: { connected: false, toolCount: 0, promptCount: 0 },
-  meta: { tokenConfigured: !!metaTokenResult.value },
   google: {
     configured: googleAdsResult.configured,
     missing: googleAdsResult.missing
@@ -3053,17 +2505,13 @@ if (apiKey) {
 } else {
   status.kb.error = "API_KEY not configured";
 }
-registerGetMetaCampaigns(server);
-registerGetMetaAdSets(server);
-registerGetMetaAds(server);
-registerGetMetaInsights(server);
-registerGetMetaAdFatigue(server);
 registerGetGoogleAdsCampaigns(server);
 registerGetGoogleAdsAdGroups(server);
 registerGetGoogleAdsAssets(server);
 registerGetGoogleAdsInsights(server);
 registerGetGoogleAdsNetworkMix(server);
 registerGetGoogleAdsAssetFatigue(server);
+registerUploadGoogleImageAssets(server);
 registerConnectionStatus(server, status);
 registerVocabularyResource(server);
 registerInstructionsResource(server, status);