@datadive-tools/mcp 0.14.0 → 0.15.0

package/dist/lib.js

@@ -139,7 +139,7 @@ function extractMessage(body) {
 }
 
 // package.json
-var version = "0.14.0";
+var version = "0.15.0";
 
 // src/http/client.ts
 var PKG_VERSION = version;
@@ -403,6 +403,33 @@ var SUPPORTED_MARKETPLACES = [
 ];
 var RANK_RADAR_STATES = ["ACTIVE", "PAUSED", "ARCHIVED"];
 var RANK_RADAR_STATUSES = [...RANK_RADAR_STATES, "ALL"];
+var PPC_CAMPAIGN_BASE_SORT_BY = [
+  "name",
+  "state",
+  "bidStrategy",
+  "budget",
+  "impressions",
+  "clicks",
+  "ctr",
+  "cpc",
+  "spend",
+  "unitsSold",
+  "sales",
+  "acos",
+  "cvr",
+  "tosImpressionShare"
+];
+var PPC_CAMPAIGN_PLACEMENT_SORT_BY = [
+  ...["tos", "ros", "pp", "off"].flatMap(
+    (p) => ["Impressions", "Clicks", "Spend", "Sales", "UnitsSold", "Ctr", "Cpc", "Acos"].map(
+      (m) => `${p}${m}`
+    )
+  ),
+  "tosBidAdjustment",
+  "rosBidAdjustment",
+  "ppBidAdjustment"
+];
+var PPC_CAMPAIGN_STATES = ["ENABLED", "PAUSED"];
 var ALERT_STATUSES = ["active", "resolved", "all"];
 var BILLABLE_FEATURE_TYPES = [
   "DIVED_ASINS",
@@ -454,42 +481,92 @@ var listRankRadarsTool = {
   }
 };
 
-// src/tools/get-rank-radar-data.ts
+// src/tools/rank-radar-keyword-query.ts
 import { z as z7 } from "zod";
 var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
 var RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE = 100;
 var RANK_RADAR_MAX_DATE_RANGE_DAYS = 90;
-var inputSchema7 = {
+var rankRadarKeywordQueryInputSchema = {
   rankRadarId: z7.string().uuid().describe("The Rank Radar UUID (from `list_rank_radars`)."),
-  startDate: z7.string().regex(ISO_DATE, "startDate must be in yyyy-mm-dd format").describe("Start date for the ranking data range, yyyy-mm-dd (e.g. 2024-03-26)."),
+  startDate: z7.string().regex(ISO_DATE, "startDate must be in yyyy-mm-dd format").describe("Start date of the range, yyyy-mm-dd (e.g. 2024-03-26)."),
   endDate: z7.string().regex(ISO_DATE, "endDate must be in yyyy-mm-dd format").describe(
-    `End date for the ranking data range, yyyy-mm-dd (e.g. 2024-04-26). Must be on or after startDate, and at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days after it.`
+    `End date of the range, yyyy-mm-dd (e.g. 2024-04-26). Must be on or after startDate, and at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days after it.`
   ),
   currentPage: z7.number().int().min(1).optional().describe("Page of keywords, 1-indexed. Defaults to 1."),
   pageSize: z7.number().int().min(1).max(RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE).optional().describe(`Keywords per page (max ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE}). Defaults to 20.`)
 };
+var RANK_RADAR_KEYWORD_PAGING_NOTE = `Results are paged by keyword: \`data\` holds one page, and the response carries currentPage, pageSize, total, lastPage, hasNext and hasPrev. \`total\` is the Rank Radar's active keyword count; to read every keyword, call again with \`currentPage\` + 1 while \`hasNext\` is true, using \`pageSize\` ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE} for large Rank Radars. Paused keywords are not included.`;
+function rankRadarPath(rankRadarId, suffix = "") {
+  return `/v1/niches/rank-radars/${encodeURIComponent(rankRadarId)}${suffix ? `/${suffix}` : ""}`;
+}
+function rankRadarKeywordQuery(args) {
+  return {
+    startDate: args.startDate,
+    endDate: args.endDate,
+    currentPage: args.currentPage,
+    pageSize: args.pageSize
+  };
+}
+
+// src/tools/get-rank-radar-data.ts
+var inputSchema7 = rankRadarKeywordQueryInputSchema;
 var getRankRadarDataTool = {
   name: "get_rank_radar_data",
   title: "Get Keyword Rankings for a Rank Radar",
-  description: `Use this to analyze keyword ranking trends over time. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart. Retrieves historical keyword ranking data for the specified Rank Radar within the date range. Results are paged by keyword: \`data\` holds one page of tracked keywords, and the response carries currentPage, pageSize, total, lastPage, hasNext and hasPrev. \`total\` is the Rank Radar's keyword count; to read every keyword, call again with \`currentPage\` + 1 while \`hasNext\` is true, using \`pageSize\` ${RANK_RADAR_KEYWORDS_MAX_PAGE_SIZE} for large Rank Radars. Each keyword has id, keyword, searchVolume, relevancy, ranks (per-day { date, organicRank, sponsoredRank, impressionRank }), and any highlight annotations. Paused keywords are not included. Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
+  description: `Use this to analyze keyword ranking trends over time. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart. Retrieves historical keyword ranking data for the specified Rank Radar within the date range. ${RANK_RADAR_KEYWORD_PAGING_NOTE} Each keyword has id, keyword, searchVolume, relevancy, ranks (per-day { date, organicRank, sponsoredRank, impressionRank }), and any highlight annotations. A rank of 101 means the product was not in the top 100 results that day. For PPC metrics use \`get_rank_radar_ppc_data\`; for Search Query Performance use \`get_rank_radar_sqp_data\`. Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
   inputSchema: inputSchema7,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
       { config: ctx.config, toolName: "get_rank_radar_data" },
-      `/v1/niches/rank-radars/${encodeURIComponent(args.rankRadarId)}`,
-      {
-        startDate: args.startDate,
-        endDate: args.endDate,
-        currentPage: args.currentPage,
-        pageSize: args.pageSize
-      }
+      rankRadarPath(args.rankRadarId),
+      rankRadarKeywordQuery(args)
     );
   }
 };
 
-// src/tools/create-rank-radar.ts
+// src/tools/get-rank-radar-sqp-data.ts
+var inputSchema8 = rankRadarKeywordQueryInputSchema;
+var getRankRadarSqpDataTool = {
+  name: "get_rank_radar_sqp_data",
+  title: "Get Search Query Performance for a Rank Radar",
+  description: `Use this when the user asks how shoppers search, click, add to cart and buy for the keywords of a Rank Radar \u2014 Amazon's Search Query Performance (SQP) data, from Brand Analytics. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart; 30 days or less keeps it fast. Each keyword's metrics are aggregated over the range: searchQueryVolume and searchQueryScore; impressions, clicks, cart adds and purchases, each as the total across all sellers (\`*TotalCount\`), this ASIN family's count (\`*AsinCount\`) and its share (\`*AsinShare\`); click, cart-add and purchase rates; and ctr/cvr for the market (\`*Total\`) and for this ASIN family (\`*Asin\`). \`numberOfDaysWithData\` says how many days of the range had SQP data; metrics are null when there is none, which is normal for low-volume keywords, recent dates (Amazon publishes SQP with a delay) and sellers without Brand Analytics. ${RANK_RADAR_KEYWORD_PAGING_NOTE} Each call counts toward API usage and is rate limited (about 60 requests/minute). Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
+  inputSchema: inputSchema8,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "get_rank_radar_sqp_data" },
+      rankRadarPath(args.rankRadarId, "sqp"),
+      rankRadarKeywordQuery(args)
+    );
+  }
+};
+
+// src/tools/get-rank-radar-ppc-data.ts
 import { z as z8 } from "zod";
+var inputSchema9 = {
+  ...rankRadarKeywordQueryInputSchema,
+  includeCampaigns: z8.boolean().optional().describe(
+    "When true, each keyword also carries `campaigns`: the per-campaign/ad-group breakdown (campaign and ad group name, match type, targeting, spend, sales, clicks, impressions, orders, CPC, CTR, CVR, ACOS). Defaults to false; leave it off unless the user asks which campaigns drive a keyword."
+  )
+};
+var getRankRadarPpcDataTool = {
+  name: "get_rank_radar_ppc_data",
+  title: "Get PPC Data for a Rank Radar",
+  description: `Use this when the user asks about advertising (Sponsored Products) performance for the keywords of a Rank Radar. Requires startDate and endDate (yyyy-mm-dd), at most ${RANK_RADAR_MAX_DATE_RANGE_DAYS} days apart; 30 days or less keeps it fast. Each keyword's metrics are aggregated over the range: sponsoredRank (median; 101 means not in the top 100 sponsored results), impressionRank and impressionRankShare; how many exact, phrase, broad and auto campaigns target it; organicSales, ppcSales, ppcSpend, costPerClicks, clickThroughRate, conversionRate, totalClicks, totalImpressions, totalOrders and acos. Metrics are null or 0 when the seller runs no ads on a keyword. Set \`includeCampaigns\` for the per-campaign breakdown. ${RANK_RADAR_KEYWORD_PAGING_NOTE} Each call counts toward API usage and is rate limited (about 60 requests/minute). For the seller's campaigns as a whole, use \`list_ppc_campaigns\`. Use after \`list_rank_radars\` to discover a \`rankRadarId\`.`,
+  inputSchema: inputSchema9,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    return await httpGet(
+      { config: ctx.config, toolName: "get_rank_radar_ppc_data" },
+      rankRadarPath(args.rankRadarId, "ppc"),
+      { ...rankRadarKeywordQuery(args), includeCampaigns: args.includeCampaigns }
+    );
+  }
+};
+
+// src/tools/create-rank-radar.ts
+import { z as z9 } from "zod";
 
 // src/tools/confirm.ts
 function needsConfirmation(confirm, ctx) {
@@ -510,11 +587,11 @@ function requireConfirmation(confirm, ctx, costNote) {
 
 // src/tools/create-rank-radar.ts
 var PATH = "/v1/niches/rank-radars";
-var inputSchema8 = {
-  asin: z8.string().min(1).describe("The ASIN to track keyword rankings for."),
-  numberOfKeywords: z8.number().int().min(1).describe("How many keywords to track (minimum 1). More keywords = broader tracking but more Search Term tokens."),
-  nicheId: z8.string().min(1).describe("The niche this Rank Radar belongs to. Get one from `list_niches`."),
-  confirm: z8.boolean().optional().describe(
+var inputSchema10 = {
+  asin: z9.string().min(1).describe("The ASIN to track keyword rankings for."),
+  numberOfKeywords: z9.number().int().min(1).describe("How many keywords to track (minimum 1). More keywords = broader tracking but more Search Term tokens."),
+  nicheId: z9.string().min(1).describe("The niche this Rank Radar belongs to. Get one from `list_niches`."),
+  confirm: z9.boolean().optional().describe(
     "Must be true to proceed \u2014 creating a Rank Radar spends Search Term tokens. Confirm the cost with the user first."
   )
 };
@@ -522,7 +599,7 @@ var createRankRadarTool = {
   name: "create_rank_radar",
   title: "Create a Rank Radar",
   description: "Use this to start tracking organic and sponsored keyword rankings for an ASIN within a niche. \u26A0\uFE0F Spends Search Term tokens (cost scales with `numberOfKeywords`) and cannot be undone \u2014 set `confirm: true` only after the user approves the cost. Not safe to retry: each call spends tokens again and creates a separate Rank Radar \u2014 if a call errors or times out, check `list_rank_radars` instead of re-calling. The first call previews the creation and may return `warnings` alongside the cost note \u2014 for example that this product family is already tracked by another Rank Radar. Show every warning `message` to the user verbatim, before asking them to confirm; do not summarise it or decide on their behalf. A warning never blocks creation. Returns the new `rankRadarId`; read its data later with `get_rank_radar_data`. Requires `asin`, `numberOfKeywords` (min 1), and a `nicheId` from `list_niches`.",
-  inputSchema: inputSchema8,
+  inputSchema: inputSchema10,
   // destructiveHint is technically "additive" here (this creates a new Rank Radar, it
   // doesn't destroy data), but we flag it destructive so clients prompt before the
   // irreversible token spend. The confirm gate enforces this server-side regardless.
@@ -547,20 +624,20 @@ var createRankRadarTool = {
 };
 
 // src/tools/create-niche-dive.ts
-import { z as z9 } from "zod";
-var inputSchema9 = {
-  marketplace: z9.enum(SUPPORTED_MARKETPLACES).describe(
+import { z as z10 } from "zod";
+var inputSchema11 = {
+  marketplace: z10.enum(SUPPORTED_MARKETPLACES).describe(
     "Amazon marketplace of the seed ASIN. Note these are full domain suffixes: com, ca, co.uk, com.mx, in, fr, de, es, it, co.jp (e.g. UK is `co.uk`, not `uk`)."
   ),
-  asin: z9.string().min(1).describe("The seed ASIN to start the dive from (e.g. B08N5WRWNW). Competitors are built around it."),
-  numberOfCompetitors: z9.number().int().min(2).describe("How many competitors to analyze (minimum 2). More competitors = deeper niche but more dive tokens."),
-  confirm: z9.boolean().optional().describe("Must be true to proceed \u2014 creating a dive spends dive tokens. Confirm the cost with the user first.")
+  asin: z10.string().min(1).describe("The seed ASIN to start the dive from (e.g. B08N5WRWNW). Competitors are built around it."),
+  numberOfCompetitors: z10.number().int().min(2).describe("How many competitors to analyze (minimum 2). More competitors = deeper niche but more dive tokens."),
+  confirm: z10.boolean().optional().describe("Must be true to proceed \u2014 creating a dive spends dive tokens. Confirm the cost with the user first.")
 };
 var createNicheDiveTool = {
   name: "create_niche_dive",
   title: "Create a Niche Dive",
   description: "Use this to start new niche research from a seed ASIN. \u26A0\uFE0F Spends dive tokens (cost scales with `numberOfCompetitors`) and cannot be undone \u2014 set `confirm: true` only after the user approves the cost. Not safe to retry: each call spends tokens again and starts a separate dive \u2014 if a call errors or times out, poll `get_dive_status` (or check `list_niches`) instead of re-calling. The dive runs asynchronously: this returns immediately with a `diveId` and an `estimatedCompletionDate`. Poll `get_dive_status` with that `diveId` until it reports `success` (which carries the new `nicheId` for use with `list_niches`, `get_niche_keywords`, etc.). Requires `marketplace`, `asin`, and `numberOfCompetitors` (min 2).",
-  inputSchema: inputSchema9,
+  inputSchema: inputSchema11,
   // destructiveHint is technically "additive" here (a dive creates a new niche, it
   // doesn't destroy data), but we flag it destructive so clients prompt before the
   // irreversible token spend. The confirm gate enforces this server-side regardless.
@@ -585,23 +662,23 @@ var createNicheDiveTool = {
 };
 
 // src/tools/redive-niche.ts
-import { z as z10 } from "zod";
-var inputSchema10 = {
-  nicheId: z10.string().min(1).describe("The niche to re-dive. Get one from `list_niches`."),
-  mode: z10.enum(["same_competitors", "discover"]).describe(
+import { z as z11 } from "zod";
+var inputSchema12 = {
+  nicheId: z11.string().min(1).describe("The niche to re-dive. Get one from `list_niches`."),
+  mode: z11.enum(["same_competitors", "discover"]).describe(
     "How to pick the competitors for the refreshed dive. `same_competitors` re-runs the niche's current competitor set and takes no other argument \u2014 use it to refresh stale data. `discover` searches for a fresh competitor set, which is what you want when the niche has changed."
   ),
-  numberOfCompetitors: z10.number().int().min(2).optional().describe(
+  numberOfCompetitors: z11.number().int().min(2).optional().describe(
     "Total ASINs the refreshed dive should contain, including `lockedAsins`. Required in `discover` mode and rejected in `same_competitors` mode. Dive tokens are spent per ASIN."
   ),
-  heroAsin: z10.string().min(1).optional().describe(
+  heroAsin: z11.string().min(1).optional().describe(
     "`discover` mode only. Seed product the competitor discovery starts from. Defaults to the niche's highest-selling competitor, preferring one the user's own connected seller account owns."
   ),
-  lockedAsins: z10.array(z10.string().min(1)).optional().describe(
+  lockedAsins: z11.array(z11.string().min(1)).optional().describe(
     "`discover` mode only. ASINs that must stay in the competitor set regardless of what discovery finds. Cannot exceed `numberOfCompetitors`, and cannot overlap `excludedAsins`."
   ),
-  excludedAsins: z10.array(z10.string().min(1)).optional().describe("`discover` mode only. ASINs discovery must never select."),
-  confirm: z10.boolean().optional().describe(
+  excludedAsins: z11.array(z11.string().min(1)).optional().describe("`discover` mode only. ASINs discovery must never select."),
+  confirm: z11.boolean().optional().describe(
     "Must be true to proceed \u2014 a re-dive spends dive tokens. Confirm the cost with the user first."
   )
 };
@@ -609,7 +686,7 @@ var rediveNicheTool = {
   name: "redive_niche",
   title: "Re-dive an Existing Niche",
   description: "Use this to refresh an existing niche's research with current Amazon data, instead of creating a new niche with `create_niche_dive`. \u26A0\uFE0F Spends dive tokens (one batch per ASIN dived) and cannot be undone \u2014 set `confirm: true` only after the user approves the cost. Not safe to retry: each call spends tokens again and starts a separate re-dive \u2014 if a call errors or times out, poll `get_dive_status` instead of re-calling. Two modes: `same_competitors` re-dives the niche's current competitor set (no other argument needed) and `discover` finds a fresh set, sized by `numberOfCompetitors` and steerable with `heroAsin` / `lockedAsins` / `excludedAsins`. Runs asynchronously: returns a `diveId` and an `estimatedCompletionDate` \u2014 poll `get_dive_status` with that `diveId` until it reports `success`. The niche keeps its `nicheId`, so existing rank radars and reports follow the refreshed data.",
-  inputSchema: inputSchema10,
+  inputSchema: inputSchema12,
   // Same reasoning as create_niche_dive: a re-dive is additive rather than destructive, but the
   // irreversible token spend is what clients need to prompt on. The confirm gate enforces it regardless.
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
@@ -642,15 +719,15 @@ var rediveNicheTool = {
 };
 
 // src/tools/get-dive-status.ts
-import { z as z11 } from "zod";
-var inputSchema11 = {
-  diveId: z11.string().min(1).describe("The dive identifier returned by `create_niche_dive` or `redive_niche`.")
+import { z as z12 } from "zod";
+var inputSchema13 = {
+  diveId: z12.string().min(1).describe("The dive identifier returned by `create_niche_dive` or `redive_niche`.")
 };
 var getDiveStatusTool = {
   name: "get_dive_status",
   title: "Get Niche Dive Status",
   description: "Use this to poll a niche dive started with `create_niche_dive` or `redive_niche` until it finishes. Returns one of three shapes keyed by `status`: `in_progress` (with `estimatedCompletionDate`), `success` (with the `nicheId` plus `tokensUsed`/`tokensLeft`), or `error` (with an `error` message). On `success`, use the `nicheId` with `list_niches`, `get_niche_keywords`, `get_niche_competitors`, etc. (for a re-dive it is the same niche you passed in, now carrying refreshed data). Re-poll periodically \u2014 dives can take minutes; the `estimatedCompletionDate` hints at when to check.",
-  inputSchema: inputSchema11,
+  inputSchema: inputSchema13,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -661,10 +738,10 @@ var getDiveStatusTool = {
 };
 
 // src/tools/delete-niche.ts
-import { z as z12 } from "zod";
-var inputSchema12 = {
-  nicheId: z12.string().min(1).describe("The niche to delete. Get one from `list_niches`."),
-  confirm: z12.boolean().optional().describe(
+import { z as z13 } from "zod";
+var inputSchema14 = {
+  nicheId: z13.string().min(1).describe("The niche to delete. Get one from `list_niches`."),
+  confirm: z13.boolean().optional().describe(
     "Must be true to proceed \u2014 deleting a niche destroys its keywords, competitors and dive history permanently. Confirm with the user first."
   )
 };
@@ -672,7 +749,7 @@ var deleteNicheTool = {
   name: "delete_niche",
   title: "Delete a Niche",
   description: "Use this to permanently remove a niche the user no longer needs. \u26A0\uFE0F Deletes the niche and everything attached to it \u2014 keywords, competitors, all dives and diveboxes \u2014 and cannot be undone; the dive tokens already spent on it are NOT refunded. Set `confirm: true` only after the user approves. A niche used by any Rank Radar cannot be deleted: the call fails with a conflict, so delete or archive those rank radars first (`list_rank_radars` with the `nicheId` filter shows them).",
-  inputSchema: inputSchema12,
+  inputSchema: inputSchema14,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const pending = requireConfirmation(
@@ -690,15 +767,15 @@ var deleteNicheTool = {
 };
 
 // src/tools/pause-rank-radar.ts
-import { z as z13 } from "zod";
-var inputSchema13 = {
-  rankRadarId: z13.string().uuid().describe("The Rank Radar UUID to pause (from `list_rank_radars`).")
+import { z as z14 } from "zod";
+var inputSchema15 = {
+  rankRadarId: z14.string().uuid().describe("The Rank Radar UUID to pause (from `list_rank_radars`).")
 };
 var pauseRankRadarTool = {
   name: "pause_rank_radar",
   title: "Pause a Rank Radar",
   description: "Use this to pause tracking on a Rank Radar without losing anything \u2014 the action the DataDive API calls 'archiving', so when a user asks to archive a Rank Radar, this is the tool they mean. Tracking stops for all of its keywords and the Daily Tracked Keywords quota they held is freed for other Rank Radars, while the Rank Radar and its ranking history are kept. Fully reversible with `resume_rank_radar`, so it needs no `confirm` \u2014 prefer it over `delete_rank_radar` whenever the user may want the data back. Paused Rank Radars show up in `list_rank_radars` under `status: PAUSED` \u2014 not `ARCHIVED`, which covers Rank Radars removed with `delete_rank_radar`. Safe to repeat: pausing an already paused Rank Radar succeeds and changes nothing.",
-  inputSchema: inputSchema13,
+  inputSchema: inputSchema15,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -711,15 +788,15 @@ var pauseRankRadarTool = {
 };
 
 // src/tools/resume-rank-radar.ts
-import { z as z14 } from "zod";
-var inputSchema14 = {
-  rankRadarId: z14.string().uuid().describe("The Rank Radar UUID to resume (from `list_rank_radars`).")
+import { z as z15 } from "zod";
+var inputSchema16 = {
+  rankRadarId: z15.string().uuid().describe("The Rank Radar UUID to resume (from `list_rank_radars`).")
 };
 var resumeRankRadarTool = {
   name: "resume_rank_radar",
   title: "Resume a Paused Rank Radar",
   description: "Use this to restart tracking on a Rank Radar that was paused with `pause_rank_radar` (shown by `list_rank_radars` under `status: PAUSED`; a deleted, `ARCHIVED` one cannot be resumed). Keywords are resumed as far as the available Daily Tracked Keywords quota allows, most relevant first \u2014 so with a tight quota only part of the original keyword set comes back; check `get_quota` first if that matters. Reversible with `pause_rank_radar`, so it needs no `confirm`. Fails with a bad-request error when there is no quota left at all. Safe to repeat: resuming an already active Rank Radar changes nothing.",
-  inputSchema: inputSchema14,
+  inputSchema: inputSchema16,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -732,10 +809,10 @@ var resumeRankRadarTool = {
 };
 
 // src/tools/delete-rank-radar.ts
-import { z as z15 } from "zod";
-var inputSchema15 = {
-  rankRadarId: z15.string().uuid().describe("The Rank Radar UUID to delete (from `list_rank_radars`)."),
-  confirm: z15.boolean().optional().describe(
+import { z as z16 } from "zod";
+var inputSchema17 = {
+  rankRadarId: z16.string().uuid().describe("The Rank Radar UUID to delete (from `list_rank_radars`)."),
+  confirm: z16.boolean().optional().describe(
     "Must be true to proceed \u2014 deleting a Rank Radar destroys its ranking history permanently. Confirm with the user first."
   )
 };
@@ -743,7 +820,7 @@ var deleteRankRadarTool = {
   name: "delete_rank_radar",
   title: "Delete a Rank Radar",
   description: "Use this to permanently remove a Rank Radar and all of its keyword ranking history. \u26A0\uFE0F Cannot be undone \u2014 there is no restore endpoint; set `confirm: true` only after the user approves. It does free the Daily Tracked Keywords quota those keywords held. Deleted Rank Radars are what `list_rank_radars` returns for `status: ARCHIVED`. If the user only wants to stop tracking for a while and keep the history \u2014 or asks to 'archive' the Rank Radar, which is what the DataDive API calls pausing \u2014 use `pause_rank_radar` instead: it frees the same quota and is reversible with `resume_rank_radar`.",
-  inputSchema: inputSchema15,
+  inputSchema: inputSchema17,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const pending = requireConfirmation(
@@ -761,10 +838,10 @@ var deleteRankRadarTool = {
 };
 
 // src/tools/add-rank-radar-search-terms.ts
-import { z as z16 } from "zod";
-var inputSchema16 = {
-  rankRadarId: z16.string().uuid().describe("The Rank Radar UUID to add the search terms to (from `list_rank_radars`)."),
-  searchTerms: z16.array(z16.string().min(1)).min(1).max(ADD_SEARCH_TERMS_MAX).describe(
+import { z as z17 } from "zod";
+var inputSchema18 = {
+  rankRadarId: z17.string().uuid().describe("The Rank Radar UUID to add the search terms to (from `list_rank_radars`)."),
+  searchTerms: z17.array(z17.string().min(1)).min(1).max(ADD_SEARCH_TERMS_MAX).describe(
     `The keywords to start tracking, 1\u2013${ADD_SEARCH_TERMS_MAX} per call. Must be unique. Amazon-ignored special characters (@, #, _, parentheses, \u2026) are rejected.`
   )
 };
@@ -772,7 +849,7 @@ var addRankRadarSearchTermsTool = {
   name: "add_rank_radar_search_terms",
   title: "Add Search Terms to a Rank Radar",
   description: "Use this to start tracking extra keywords on an existing Rank Radar, instead of creating a new one with `create_rank_radar`. New keywords are added to the niche and tracked from now on; any matching keyword that was previously paused is resumed. Each newly tracked keyword takes one Daily Tracked Keywords slot, and the call fails if the quota is exhausted \u2014 check `get_quota` first. Reversible with `pause_rank_radar_search_terms`, which frees the slots again, so it needs no `confirm`. Returns `originBreakdown` (where each submitted term ended up) and `keywordToRankRadarKeywordIdMap`, whose ids are what the pause/resume search-term tools take.",
-  inputSchema: inputSchema16,
+  inputSchema: inputSchema18,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     return await httpPost(
@@ -784,10 +861,10 @@ var addRankRadarSearchTermsTool = {
 };
 
 // src/tools/pause-rank-radar-search-terms.ts
-import { z as z17 } from "zod";
-var inputSchema17 = {
-  rankRadarId: z17.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
-  rankRadarKeywordIds: z17.array(z17.string().uuid()).min(1).describe(
+import { z as z18 } from "zod";
+var inputSchema19 = {
+  rankRadarId: z18.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
+  rankRadarKeywordIds: z18.array(z18.string().uuid()).min(1).describe(
     "The Rank Radar keyword ids to pause. These are the `id` values from `get_rank_radar_data`, or the values of `keywordToRankRadarKeywordIdMap` returned by `add_rank_radar_search_terms` \u2014 not the keyword text."
   )
 };
@@ -795,7 +872,7 @@ var pauseRankRadarSearchTermsTool = {
   name: "pause_rank_radar_search_terms",
   title: "Pause Search Terms of a Rank Radar",
   description: "Use this to stop tracking individual keywords on a Rank Radar while keeping the Rank Radar itself active \u2014 the way to trim a keyword set the user finds too broad. The DataDive API calls this 'archiving' the search terms; nothing is lost. The paused keywords keep their history and their Daily Tracked Keywords slots are freed for other keywords. Reversible with `resume_rank_radar_search_terms`, so it needs no `confirm`. Takes keyword ids, not keyword text: get them from `get_rank_radar_data`. Safe to repeat: already-paused terms are left unchanged.",
-  inputSchema: inputSchema17,
+  inputSchema: inputSchema19,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -812,10 +889,10 @@ var pauseRankRadarSearchTermsTool = {
 };
 
 // src/tools/resume-rank-radar-search-terms.ts
-import { z as z18 } from "zod";
-var inputSchema18 = {
-  rankRadarId: z18.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
-  rankRadarKeywordIds: z18.array(z18.string().uuid()).min(1).describe(
+import { z as z19 } from "zod";
+var inputSchema20 = {
+  rankRadarId: z19.string().uuid().describe("The Rank Radar UUID the search terms belong to."),
+  rankRadarKeywordIds: z19.array(z19.string().uuid()).min(1).describe(
     "The Rank Radar keyword ids to resume. These are the `id` values from `get_rank_radar_data`, or the values of `keywordToRankRadarKeywordIdMap` returned by `add_rank_radar_search_terms` \u2014 not the keyword text."
   )
 };
@@ -823,7 +900,7 @@ var resumeRankRadarSearchTermsTool = {
   name: "resume_rank_radar_search_terms",
   title: "Resume Paused Search Terms of a Rank Radar",
   description: "Use this to start tracking keywords again that were paused with `pause_rank_radar_search_terms`. Each resumed keyword takes back one Daily Tracked Keywords slot, and the call fails if the quota is exhausted \u2014 check `get_quota` first. Reversible with `pause_rank_radar_search_terms`, so it needs no `confirm`. Takes keyword ids, not keyword text: get them from `get_rank_radar_data`. Safe to repeat: already-active terms are left unchanged.",
-  inputSchema: inputSchema18,
+  inputSchema: inputSchema20,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     await httpPost(
@@ -840,16 +917,16 @@ var resumeRankRadarSearchTermsTool = {
 };
 
 // src/tools/generate-listing-copy.ts
-import { z as z19 } from "zod";
-var inputSchema19 = {
-  nicheId: z19.string().min(1).describe("The niche whose keyword data the copy is written from. Get one from `list_niches`."),
-  strategy: z19.enum(LISTING_COPY_STRATEGIES).describe(
+import { z as z20 } from "zod";
+var inputSchema21 = {
+  nicheId: z20.string().min(1).describe("The niche whose keyword data the copy is written from. Get one from `list_niches`."),
+  strategy: z20.enum(LISTING_COPY_STRATEGIES).describe(
     "Which generation strategy to use. `cosmo` targets Amazon's COSMO relevance model, `ranking-juice` optimises for DataDive's ranking-juice score, `nlp` writes for keyword coverage, and `cosmo-rufus` targets COSMO plus the Rufus shopping assistant. Ask the user if they have no preference."
   ),
-  currentListing: z19.record(z19.union([z19.string(), z19.array(z19.string())])).describe(
+  currentListing: z20.record(z20.union([z20.string(), z20.array(z20.string())])).describe(
     'The seller\'s existing listing to rewrite, as an object \u2014 e.g. `{ "title": "...", "description": "...", "bullets": ["...", "..."] }`. Pass what the user has; it is the starting point the generated copy builds on.'
   ),
-  confirm: z19.boolean().optional().describe(
+  confirm: z20.boolean().optional().describe(
     "Must be true to proceed \u2014 each generation spends one AI Copywriter prompt from the quota. Confirm the cost with the user first."
   )
 };
@@ -857,7 +934,7 @@ var generateListingCopyTool = {
   name: "generate_listing_copy",
   title: "Generate Listing Copy for a Niche",
   description: "Use this to draft an optimised Amazon listing \u2014 title, bullets and description \u2014 from a niche's keyword research and the seller's current listing. It writes text only: nothing is published to Amazon, and the user still has to paste the result into Seller Central. \u26A0\uFE0F Spends one AI Copywriter prompt from the quota per call and cannot be undone \u2014 set `confirm: true` only after the user approves. Not safe to retry: each call spends another prompt, so if a call errors or times out, poll `get_listing_copy_generation_status` instead of re-calling. Runs asynchronously: returns a `generationId` \u2014 poll `get_listing_copy_generation_status` with it until the status is `complete`.",
-  inputSchema: inputSchema19,
+  inputSchema: inputSchema21,
   annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
   handler: async (args, ctx) => {
     const pending = requireConfirmation(
@@ -875,16 +952,16 @@ var generateListingCopyTool = {
 };
 
 // src/tools/get-listing-copy-generation-status.ts
-import { z as z20 } from "zod";
-var inputSchema20 = {
-  nicheId: z20.string().min(1).describe("The niche the generation was started for."),
-  generationId: z20.string().min(1).describe("The `generationId` returned by `generate_listing_copy`.")
+import { z as z21 } from "zod";
+var inputSchema22 = {
+  nicheId: z21.string().min(1).describe("The niche the generation was started for."),
+  generationId: z21.string().min(1).describe("The `generationId` returned by `generate_listing_copy`.")
 };
 var getListingCopyGenerationStatusTool = {
   name: "get_listing_copy_generation_status",
   title: "Get Listing Copy Generation Status",
   description: "Use this to poll a listing-copy draft started with `generate_listing_copy` until it finishes. Returns one of three shapes keyed by `status`: `generating` (still running \u2014 poll again in a few seconds), `complete` (with `result`, carrying the generated `title`, `bullets`, `description`, `itemHighlights` and its `rankingJuice` score), or `failed` (with an `error` message). Polling is free \u2014 it does not spend another AI Copywriter prompt, so always poll rather than re-calling `generate_listing_copy`.",
-  inputSchema: inputSchema20,
+  inputSchema: inputSchema22,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -895,16 +972,16 @@ var getListingCopyGenerationStatusTool = {
 };
 
 // src/tools/list-seller-profiles.ts
-import { z as z21 } from "zod";
-var inputSchema21 = {
-  currentPage: z21.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z21.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+import { z as z22 } from "zod";
+var inputSchema23 = {
+  currentPage: z22.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z22.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 var listSellerProfilesTool = {
   name: "list_seller_profiles",
   title: "List Connected Amazon Seller Profiles",
   description: 'Use this when the user asks which Amazon seller accounts are connected, or as the discovery step to find the `sellerId` and `marketplace` required by `get_asin_inventory_distribution`, `get_seller_catalog`, `get_seller_listing_changes`, and the alert tools. Returns a paginated list of the organization\'s connected seller profiles \u2014 each item has sellerId, sellerName, marketplace (e.g. "com", "co.uk"), hasAdApi (whether Advertising API credentials are connected), and createdAt \u2014 plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).',
-  inputSchema: inputSchema21,
+  inputSchema: inputSchema23,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -919,15 +996,15 @@ var listSellerProfilesTool = {
 };
 
 // src/tools/get-seller-catalog.ts
-import { z as z23 } from "zod";
+import { z as z24 } from "zod";
 
 // src/tools/seller-scoped.ts
-import { z as z22 } from "zod";
+import { z as z23 } from "zod";
 var sellerScopedInputSchema = {
-  sellerId: z22.string().min(1).describe(
+  sellerId: z23.string().min(1).describe(
     "Amazon seller account ID. Get it from `list_seller_profiles`, or find it on the Connections page at https://2.datadive.tools."
   ),
-  marketplace: z22.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.')
+  marketplace: z23.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.')
 };
 function sellerMarketplacePath(sellerId, marketplace, suffix) {
   return `/v1/seller_profiles/${encodeURIComponent(sellerId)}/marketplaces/${encodeURIComponent(
@@ -936,19 +1013,19 @@ function sellerMarketplacePath(sellerId, marketplace, suffix) {
 }
 
 // src/tools/get-seller-catalog.ts
-var inputSchema22 = {
+var inputSchema24 = {
   ...sellerScopedInputSchema,
-  search: z23.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
-  brand: z23.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
-  status: z23.enum(CATALOG_STATUSES).optional().describe('Listing status filter. "Active" (default) or "all".'),
-  currentPage: z23.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z23.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+  search: z24.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
+  brand: z24.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
+  status: z24.enum(CATALOG_STATUSES).optional().describe('Listing status filter. "Active" (default) or "all".'),
+  currentPage: z24.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z24.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 var getSellerCatalogTool = {
   name: "get_seller_catalog",
   title: "List Catalog ASINs for a Seller",
   description: "Use this when the user wants to browse or search a seller's own Amazon catalog \u2014 the products they sell on a given marketplace. Requires a `sellerId` + `marketplace` (use `list_seller_profiles` to discover them). Filter by `search` (title/brand), `brand`, and `status` (Active by default, or all). Returns a paginated list where each item has asin, title, parentAsin, brand, status, imageUrl, and hasVariations, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).",
-  inputSchema: inputSchema22,
+  inputSchema: inputSchema24,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -966,28 +1043,28 @@ var getSellerCatalogTool = {
 };
 
 // src/tools/get-seller-listing-changes.ts
-import { z as z24 } from "zod";
-var inputSchema23 = {
+import { z as z25 } from "zod";
+var inputSchema25 = {
   ...sellerScopedInputSchema,
-  types: z24.array(z24.enum(LISTING_CHANGE_TYPES)).min(1).optional().describe('Filter to specific change types. Omit for all. Any of "Price", "Content", "Image".'),
-  asin: z24.string().min(1).optional().describe("Filter to an exact ASIN or parent ASIN."),
-  brand: z24.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
-  search: z24.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
-  startDate: z24.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or after this time."),
-  endDate: z24.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or before this time."),
-  sortBy: z24.enum(LISTING_CHANGE_SORT_BY).optional().describe('Sort field. "date" (default) or "type".'),
-  sortOrder: z24.enum(SORT_ORDER).optional().describe('Sort direction. "DESC" (default) or "ASC".'),
-  includeCorrelations: z24.boolean().optional().describe(
+  types: z25.array(z25.enum(LISTING_CHANGE_TYPES)).min(1).optional().describe('Filter to specific change types. Omit for all. Any of "Price", "Content", "Image".'),
+  asin: z25.string().min(1).optional().describe("Filter to an exact ASIN or parent ASIN."),
+  brand: z25.string().min(1).optional().describe("Case-insensitive partial match on brand name."),
+  search: z25.string().min(1).optional().describe("Case-insensitive partial match on product title or brand."),
+  startDate: z25.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or after this time."),
+  endDate: z25.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only changes detected on or before this time."),
+  sortBy: z25.enum(LISTING_CHANGE_SORT_BY).optional().describe('Sort field. "date" (default) or "type".'),
+  sortOrder: z25.enum(SORT_ORDER).optional().describe('Sort direction. "DESC" (default) or "ASC".'),
+  includeCorrelations: z25.boolean().optional().describe(
     "When true, include the ranking/conversion `correlation` object per change (CVR and search-term movement before vs after). Defaults to false."
   ),
-  currentPage: z24.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z24.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+  currentPage: z25.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z25.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 var getSellerListingChangesTool = {
   name: "get_seller_listing_changes",
   title: "List Listing Changes for a Seller",
   description: "Use this when the user asks what changed on their Amazon listings \u2014 price, content (title/bullets/description), or image edits \u2014 for a seller account. Requires a `sellerId` + `marketplace` (use `list_seller_profiles` to discover them). Filter by `types`, `asin`/parent ASIN, `brand`, `search`, and a `startDate`/`endDate` range; sort with `sortBy`/`sortOrder`. Set `includeCorrelations: true` to attach the ranking/conversion impact per change. Returns a paginated list where each item has asin, title, imageUrl, date, type, contentType, description, previousValue, newValue, and (optionally) correlation, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).",
-  inputSchema: inputSchema23,
+  inputSchema: inputSchema25,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1011,14 +1088,78 @@ var getSellerListingChangesTool = {
   }
 };
 
+// src/tools/list-ppc-campaigns.ts
+import { z as z26 } from "zod";
+var PPC_CAMPAIGNS_MAX_WINDOW_DAYS = 90;
+var PPC_CAMPAIGNS_MAX_PAGE_SIZE = 50;
+var inputSchema26 = {
+  ...sellerScopedInputSchema,
+  startDate: z26.string().regex(
+    ISO_8601,
+    "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)"
+  ).optional().describe("Start of the reporting window, ISO-8601. Defaults to 30 days before endDate."),
+  endDate: z26.string().regex(
+    ISO_8601,
+    "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)"
+  ).optional().describe(
+    `End of the reporting window, ISO-8601. Defaults to now. At most ${PPC_CAMPAIGNS_MAX_WINDOW_DAYS} days after startDate.`
+  ),
+  asin: z26.string().min(1).optional().describe("Only campaigns advertising this ASIN. Cannot be combined with parentAsin."),
+  parentAsin: z26.string().min(1).optional().describe("Only campaigns advertising any ASIN of this variation family. Cannot be combined with asin."),
+  search: z26.string().min(3).max(200).optional().describe("Partial match on campaign name or advertised ASIN. At least 3 characters."),
+  includePlacements: z26.boolean().optional().describe(
+    "Include the per-placement breakdown (topOfSearch, restOfSearch, productPage, offAmazon, each with its bid adjustment). Defaults to true; set false for a smaller response when placements are not needed."
+  ),
+  sortBy: z26.enum([...PPC_CAMPAIGN_BASE_SORT_BY, ...PPC_CAMPAIGN_PLACEMENT_SORT_BY]).optional().describe(
+    `Sort field. Defaults to "name". Any of ${PPC_CAMPAIGN_BASE_SORT_BY.join(", ")}. The placement fields (e.g. "tosSpend", "tosAcos", "ppBidAdjustment") are only accepted when includePlacements is not false.`
+  ),
+  sortOrder: z26.enum(SORT_ORDER).optional().describe('Sort direction. "ASC" (default) or "DESC".'),
+  state: z26.enum(PPC_CAMPAIGN_STATES).optional().describe("Only ENABLED or only PAUSED campaigns. Omit for both."),
+  currentPage: z26.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z26.number().int().min(1).max(PPC_CAMPAIGNS_MAX_PAGE_SIZE).optional().describe(`Campaigns per page (max ${PPC_CAMPAIGNS_MAX_PAGE_SIZE}). Defaults to 20.`)
+};
+var listPpcCampaignsTool = {
+  name: "list_ppc_campaigns",
+  title: "List PPC Campaigns for a Seller",
+  description: `Use this when the user asks about their Sponsored Products campaigns \u2014 which campaigns spend the most, which have a high ACOS, how placements (top of search, rest of search, product pages) perform, or which campaigns advertise a given product. Requires a \`sellerId\` + \`marketplace\` (use \`list_seller_profiles\` to discover them). Narrow to one product with \`asin\`, or to a variation family with \`parentAsin\` (not both). The reporting window defaults to the last 30 days and cannot exceed ${PPC_CAMPAIGNS_MAX_WINDOW_DAYS} days. Returns a paginated list where each campaign has campaignId, name, type, state, targetingType, bidStrategy, budget { type, amount, currencyCode }, window totals (impressions, clicks, ctr, cpc, cvr, spend, unitsSold, orders, sales, tosImpressionShare, acos, roas, tacos), asinCount and, unless includePlacements is false, \`placements\`; plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev). To find the biggest spenders, sort with \`sortBy: "spend", sortOrder: "DESC"\` rather than paging through every campaign. Each call counts toward API usage and is rate limited (about 60 requests/minute). For per-keyword ad data of a Rank Radar, use \`get_rank_radar_ppc_data\`.`,
+  inputSchema: inputSchema26,
+  annotations: { readOnlyHint: true },
+  handler: async (args, ctx) => {
+    if (args.asin && args.parentAsin) {
+      throw new ApiError(
+        "bad_request",
+        400,
+        "Pass either `asin` (one product) or `parentAsin` (its whole variation family), not both."
+      );
+    }
+    return await httpGet(
+      { config: ctx.config, toolName: "list_ppc_campaigns" },
+      sellerMarketplacePath(args.sellerId, args.marketplace, "ppc/campaigns"),
+      {
+        startDate: args.startDate,
+        endDate: args.endDate,
+        asin: args.asin,
+        parentAsin: args.parentAsin,
+        search: args.search,
+        includePlacements: args.includePlacements,
+        sortBy: args.sortBy,
+        sortOrder: args.sortOrder,
+        state: args.state,
+        currentPage: args.currentPage,
+        pageSize: args.pageSize
+      }
+    );
+  }
+};
+
 // src/tools/get-asin-inventory-distribution.ts
-import { z as z25 } from "zod";
-var inputSchema24 = {
-  sellerId: z25.string().min(1).describe(
+import { z as z27 } from "zod";
+var inputSchema27 = {
+  sellerId: z27.string().min(1).describe(
     "Amazon seller account ID as connected to DataDive. Get it from `list_seller_profiles`, or find it on the Connections page at https://2.datadive.tools."
   ),
-  marketplace: z25.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
-  asin: z25.string().regex(/^[A-Z0-9]{10}$/, "ASIN must be 10 uppercase alphanumeric characters (e.g. B08XYZ1234).").describe(
+  marketplace: z27.enum(SUPPORTED_MARKETPLACES).describe('Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
+  asin: z27.string().regex(/^[A-Z0-9]{10}$/, "ASIN must be 10 uppercase alphanumeric characters (e.g. B08XYZ1234).").describe(
     "Amazon Standard Identification Number (10 uppercase alphanumeric characters, e.g. B08XYZ1234)."
   )
 };
@@ -1026,7 +1167,7 @@ var getAsinInventoryDistributionTool = {
   name: "get_asin_inventory_distribution",
   title: "Get Per-Fulfillment-Center Inventory Distribution for an ASIN",
   description: "Use this when the user asks about inventory levels, stock by fulfillment center, or where their units are sitting across Amazon's fulfillment network for a specific ASIN. Requires the Amazon sellerId (from `list_seller_profiles` or the user's DataDive Connections page at https://2.datadive.tools), the marketplace code, and the ASIN. Returns totalSellableUnits and a per-FC `distribution` array (fc, state, availableStock, availableStockPercentage). `lastUpdatedAt` may be null when no successful inventory ingestion has occurred in the last 30 days.",
-  inputSchema: inputSchema24,
+  inputSchema: inputSchema27,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1039,18 +1180,18 @@ var getAsinInventoryDistributionTool = {
 };
 
 // src/tools/alert-query.ts
-import { z as z26 } from "zod";
+import { z as z28 } from "zod";
 var alertsQueryInputSchema = {
-  sellerId: z26.string().min(1).max(50).optional().describe('Filter to a single connected Amazon seller account ID, e.g. "A1B2C3D4E5".'),
-  marketplace: z26.enum(SUPPORTED_MARKETPLACES).optional().describe('Filter to a single Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
-  status: z26.enum(ALERT_STATUSES).optional().describe(
+  sellerId: z28.string().min(1).max(50).optional().describe('Filter to a single connected Amazon seller account ID, e.g. "A1B2C3D4E5".'),
+  marketplace: z28.enum(SUPPORTED_MARKETPLACES).optional().describe('Filter to a single Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk.'),
+  status: z28.enum(ALERT_STATUSES).optional().describe(
     "Lifecycle filter. `active` (default) returns unresolved alerts, `resolved` returns resolved alerts, `all` returns both. Dismissed alerts are never returned."
   ),
-  updatedSince: z26.string().regex(ISO_8601, "updatedSince must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe(
+  updatedSince: z28.string().regex(ISO_8601, "updatedSince must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe(
     "ISO-8601 timestamp; return only alerts surfaced at or after this time (filters on `lastAlertedAt`). Use it to incrementally sync since your last poll. Defaults to the last 30 days when omitted."
   ),
-  currentPage: z26.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z26.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
+  currentPage: z28.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z28.number().int().min(1).max(50).optional().describe("Items per page (max 50). Defaults to 20.")
 };
 
 // src/tools/list-indexing-issue-alerts.ts
@@ -1100,12 +1241,12 @@ var listBlindSpendAlertsTool = {
 };
 
 // src/tools/get-quota.ts
-var inputSchema25 = {};
+var inputSchema28 = {};
 var getQuotaTool = {
   name: "get_quota",
   title: "Get Quota Usage",
   description: "Use this when the user asks how much quota or how many tokens they have left, or before creating a Niche Dive or Rank Radar to check remaining headroom. Returns current quota usage and capacity for each billable feature \u2014 DIVED_ASINS (Dive tokens), RANK_RADAR_KEYWORDS (tracked keywords), PRODUCT_BRIEF_ASINS, and AI_COPYWRITER_PROMPTS \u2014 each with `used` and `capacity` (null when unlimited / not applicable), plus `nextRefreshDate` (ISO-8601 timestamp of the next quota reset, or null). Takes no arguments.",
-  inputSchema: inputSchema25,
+  inputSchema: inputSchema28,
   annotations: { readOnlyHint: true },
   handler: async (_args, ctx) => {
     return await httpGet({ config: ctx.config, toolName: "get_quota" }, "/v1/quota");
@@ -1113,20 +1254,20 @@ var getQuotaTool = {
 };
 
 // src/tools/list-usage.ts
-import { z as z27 } from "zod";
-var inputSchema26 = {
-  type: z27.enum(BILLABLE_FEATURE_TYPES).optional().describe("Filter to a single billable feature type. Omit to return all types."),
-  search: z27.string().min(1).optional().describe("Case-insensitive partial match on the user's name or email."),
-  startDate: z27.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or after this time."),
-  endDate: z27.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or before this time."),
-  currentPage: z27.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
-  pageSize: z27.number().int().min(1).max(200).optional().describe("Items per page (max 200). Defaults to 50.")
+import { z as z29 } from "zod";
+var inputSchema29 = {
+  type: z29.enum(BILLABLE_FEATURE_TYPES).optional().describe("Filter to a single billable feature type. Omit to return all types."),
+  search: z29.string().min(1).optional().describe("Case-insensitive partial match on the user's name or email."),
+  startDate: z29.string().regex(ISO_8601, "startDate must be an ISO-8601 date or timestamp (e.g. 2026-05-01 or 2026-05-01T00:00:00Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or after this time."),
+  endDate: z29.string().regex(ISO_8601, "endDate must be an ISO-8601 date or timestamp (e.g. 2026-05-31 or 2026-05-31T23:59:59Z)").optional().describe("ISO-8601 date/timestamp; return only usage logs recorded on or before this time."),
+  currentPage: z29.number().int().min(1).optional().describe("Page number, 1-indexed. Defaults to 1."),
+  pageSize: z29.number().int().min(1).max(200).optional().describe("Items per page (max 200). Defaults to 50.")
 };
 var listUsageTool = {
   name: "list_usage",
   title: "List Billable Usage Logs",
   description: "Use this when the user asks who consumed tokens, how their quota was spent, or wants an audit of billable activity over a date range. Retrieves a paginated list of billable feature usage logs for the organization \u2014 each entry is a token-consumption event (a dive, rank-radar creation, AI copywriter prompt, etc.). Filter by `type` (billable feature), `search` (user name/email), and `startDate`/`endDate`. Each item includes name, email, qty (tokens consumed), type, action (specific operation), nicheId/nicheName, rankRadarId, and date, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).",
-  inputSchema: inputSchema26,
+  inputSchema: inputSchema29,
   annotations: { readOnlyHint: true },
   handler: async (args, ctx) => {
     return await httpGet(
@@ -1153,6 +1294,8 @@ var allTools = [
   getRankingJuiceTool,
   listRankRadarsTool,
   getRankRadarDataTool,
+  getRankRadarSqpDataTool,
+  getRankRadarPpcDataTool,
   createRankRadarTool,
   createNicheDiveTool,
   rediveNicheTool,
@@ -1169,6 +1312,7 @@ var allTools = [
   listSellerProfilesTool,
   getSellerCatalogTool,
   getSellerListingChangesTool,
+  listPpcCampaignsTool,
   getAsinInventoryDistributionTool,
   listIndexingIssueAlertsTool,
   listBlindSpendAlertsTool,
@@ -1176,15 +1320,80 @@ var allTools = [
   listUsageTool
 ];
 
+// src/whats-new.ts
+var WHATS_NEW = [
+  {
+    version: "0.15.0",
+    released: "2026-09-28",
+    items: [
+      "Search Query Performance for Rank Radar keywords (`get_rank_radar_sqp_data`): how shoppers search, click, add to cart and buy, for the whole market and for your product.",
+      "PPC data for Rank Radar keywords (`get_rank_radar_ppc_data`): sponsored rank, spend, sales, ACOS and CPC per keyword, optionally broken down by campaign.",
+      "Your Sponsored Products campaigns (`list_ppc_campaigns`): totals and placement performance per campaign, sortable by any metric, e.g. the top spenders first."
+    ]
+  },
+  {
+    version: "0.14.0",
+    released: "2026-09-25",
+    items: [
+      "Rank Radar keywords are now read page by page (`get_rank_radar_data`, up to 100 keywords per page), so large Rank Radars load reliably."
+    ]
+  },
+  {
+    version: "0.13.0",
+    released: "2026-09-09",
+    items: [
+      "Before creating a Rank Radar, you are warned when the same product family is already tracked by another of your Rank Radars."
+    ]
+  },
+  {
+    version: "0.12.0",
+    released: "2026-09-07",
+    items: ["Search and sort your niches by name, hero keyword or ASIN (`list_niches`)."]
+  }
+];
+var INSTRUCTIONS_RELEASES = 2;
+function formatEntries(entries) {
+  return entries.map((e) => `${e.released} (v${e.version}):
+${e.items.map((i) => `- ${i}`).join("\n")}`).join("\n\n");
+}
+var SERVER_INSTRUCTIONS = `DataDive tools for Amazon sellers: niche research (niches, keywords, roots, competitors, Ranking Juice), Rank Radar keyword rank tracking with SQP and PPC data, the seller's catalog, listing changes, inventory, PPC campaigns and alerts. Start with a discovery tool: \`list_niches\`, \`list_rank_radars\` or \`list_seller_profiles\`. Tools that spend tokens ask for confirmation first.
+
+Recently added:
+${formatEntries(WHATS_NEW.slice(0, INSTRUCTIONS_RELEASES))}
+
+When one of these additions fits what the user is doing, mention it once. The user can see the full list with the \`whats_new\` prompt.`;
+var WHATS_NEW_PROMPT = {
+  name: "whats_new",
+  title: "What's new in DataDive",
+  description: "Recent additions to the DataDive tools, newest first."
+};
+function whatsNewPromptText() {
+  return `Here is what is new in the DataDive tools, newest first:
+
+${formatEntries(WHATS_NEW)}
+
+Summarize this for me in a few short lines, and for each addition give one example question I could ask you.`;
+}
+
 // src/server.ts
 function requiredScope(tool) {
   return tool.annotations?.readOnlyHint === true ? SCOPE_READ : SCOPE_WRITE;
 }
 function buildServer(config) {
-  const server = new McpServer({
-    name: "datadive",
-    version: PKG_VERSION
-  });
+  const server = new McpServer(
+    {
+      name: "datadive",
+      version: PKG_VERSION
+    },
+    { instructions: SERVER_INSTRUCTIONS }
+  );
+  server.registerPrompt(
+    WHATS_NEW_PROMPT.name,
+    { title: WHATS_NEW_PROMPT.title, description: WHATS_NEW_PROMPT.description },
+    () => ({
+      messages: [{ role: "user", content: { type: "text", text: whatsNewPromptText() } }]
+    })
+  );
   for (const tool of allTools) {
     server.registerTool(
       tool.name,
@@ -1244,9 +1453,13 @@ export {
   PKG_VERSION,
   SCOPE_READ,
   SCOPE_WRITE,
+  SERVER_INSTRUCTIONS,
+  WHATS_NEW,
+  WHATS_NEW_PROMPT,
   allTools,
   buildServer,
   loadConfig,
-  requiredScope
+  requiredScope,
+  whatsNewPromptText
 };
 //# sourceMappingURL=lib.js.map