@productmaker/mcp 1.16.3 → 1.17.0

package/README.md

@@ -86,6 +86,9 @@ Sign up at [productmaker.app](https://productmaker.app) and create a key (prefix
 | `publish_to_tiktok` | Create a TikTok Ads campaign from a task (always created PAUSED). Same `angleIndexes` + `campaignConfig` shape as Meta |
 | `get_meta_campaign_status` | Read-only status + lifetime insights (spend/impressions/clicks/reach) of a Meta campaign |
 | `get_tiktok_campaign_status` | Read-only status + lifetime report of a TikTok campaign (requires `advertiserId`) |
+| `find_winning_products` | Research winning dropshipping products for a country/category with AI-explained reasons, risks, and real Meta Ads evidence. **Costs 2000 credits per run** — requires explicit user confirmation (`confirmed: true`) before charging. Covers CO, MX, PE, EC, CL |
+| `get_product_research_run` | Read the full report (score, verdict, confidence, reasons, risks, ad evidence) of a research run by `runId`. Free |
+| `list_product_research_runs` | List the user's past research runs, most recent first. Free |
 
 ## Video duration and winner review
 

package/dist/http.js

@@ -12,6 +12,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/api-client.ts
+import { createHash } from "crypto";
 var ApiHttpError = class extends Error {
   static {
     __name(this, "ApiHttpError");
@@ -38,6 +39,15 @@ var ApiClient = class {
       Authorization: `Bearer ${this.apiKey}`
     };
   }
+  /**
+  * Stable per-key identifier. The MCP never sees the userId — the API key is
+  * the only per-user handle it holds — so this stands in as the user
+  * component of derived idempotency keys. Never log or return it raw to a
+  * caller: it is derived from a secret.
+  */
+  fingerprint() {
+    return createHash("sha256").update(this.apiKey).digest("hex").slice(0, 32);
+  }
   async getJson(path3) {
     const res = await fetch(`${this.baseUrl}${path3}`, {
       headers: this.authHeaders()
@@ -132,7 +142,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "1.16.3";
+var MCP_VERSION = "1.17.0";
 
 // src/tools/tasks.ts
 import { z as z39 } from "zod";
@@ -3149,6 +3159,125 @@ var AdminQualityReportListResponse = z24.object({
 var UpdateQualityReportStatusRequest = z24.object({
   status: QualityReportStatus
 });
+var AdminSupportConversationStatus = z24.enum([
+  "bot_active",
+  "human_pending",
+  "human_active",
+  "closed"
+]);
+var AdminSupportDeliveryStatus = z24.enum([
+  "draft",
+  "pending",
+  "sent",
+  "delivered",
+  "read",
+  "failed",
+  "blocked"
+]);
+var AdminSupportMessage = z24.object({
+  id: z24.string().uuid(),
+  direction: z24.enum([
+    "inbound",
+    "outbound"
+  ]),
+  senderKind: z24.enum([
+    "user",
+    "bot",
+    "admin",
+    "system"
+  ]),
+  messageType: z24.enum([
+    "text",
+    "image",
+    "audio",
+    "document",
+    "interactive",
+    "status"
+  ]),
+  bodyRedacted: z24.string().nullable(),
+  deliveryStatus: AdminSupportDeliveryStatus.nullable(),
+  createdAt: z24.string().datetime()
+});
+var AdminSupportTicket = z24.object({
+  id: z24.string().uuid(),
+  category: z24.enum([
+    "how_to",
+    "credits",
+    "billing",
+    "task_status",
+    "task_error",
+    "video_quality",
+    "landing_quality",
+    "image_quality",
+    "feature_request",
+    "other"
+  ]),
+  failureMode: z24.string().nullable(),
+  status: z24.enum([
+    "open",
+    "triaged",
+    "resolved",
+    "rejected"
+  ]),
+  summary: z24.string(),
+  taskId: z24.string().nullable(),
+  mixTaskId: z24.string().nullable(),
+  qualityReportId: z24.string().nullable(),
+  handoffReason: z24.string().nullable(),
+  createdAt: z24.string().datetime(),
+  updatedAt: z24.string().datetime()
+});
+var AdminSupportConversation = z24.object({
+  id: z24.string().uuid(),
+  status: AdminSupportConversationStatus,
+  priority: z24.enum([
+    "low",
+    "normal",
+    "high",
+    "urgent"
+  ]),
+  currentIntent: z24.string().nullable(),
+  assignedAdminId: z24.string().nullable(),
+  customerServiceWindowEndsAt: z24.string().datetime().nullable(),
+  lastInboundAt: z24.string().datetime().nullable(),
+  createdAt: z24.string().datetime(),
+  updatedAt: z24.string().datetime(),
+  contact: z24.object({
+    id: z24.string().uuid(),
+    userId: z24.string().nullable(),
+    verifiedAt: z24.string().datetime().nullable(),
+    botMode: z24.enum([
+      "enabled",
+      "paused",
+      "opted_out"
+    ]),
+    locale: z24.string()
+  }),
+  messages: z24.array(AdminSupportMessage),
+  tickets: z24.array(AdminSupportTicket)
+});
+var AdminSupportListQuery = z24.object({
+  status: AdminSupportConversationStatus.optional(),
+  take: z24.coerce.number().int().min(1).max(100).default(50),
+  cursorId: z24.string().uuid().optional()
+}).strict();
+var AdminSupportListResponse = z24.object({
+  conversations: z24.array(AdminSupportConversation),
+  nextCursor: z24.string().uuid().nullable()
+});
+var AdminSupportReplyRequest = z24.object({
+  body: z24.string().trim().min(1).max(4096),
+  idempotencyKey: z24.string().regex(/^[A-Za-z0-9_-]{8,128}$/)
+}).strict();
+var AdminSupportEmptyActionRequest = z24.object({}).strict();
+var AdminSupportActionResponse = z24.object({
+  conversation: AdminSupportConversation
+});
+var AdminSupportReplyResponse = z24.object({
+  messageId: z24.string().uuid(),
+  deliveryStatus: AdminSupportDeliveryStatus,
+  duplicate: z24.boolean()
+});
 
 // ../../packages/types/src/promo.ts
 import { z as z25 } from "zod";
@@ -3984,6 +4113,23 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.4,
     userPriceCents: 0.8
   },
+  // WhatsApp ProductMaker intent proposal. Real OpenRouter usage.cost wins;
+  // this is only the fallback when the relay omits cost.
+  "openrouter:whatsapp-product-agent-intent": {
+    ourCostCents: 0.4,
+    userPriceCents: 0.8
+  },
+  // Internal support calls are cost-only: callers explicitly override user
+  // price to zero. Static COGS estimates apply because OpenAI Responses exposes
+  // token counts but not the provider's dollar charge.
+  "openai:whatsapp-support-classifier": {
+    ourCostCents: 0.1,
+    userPriceCents: 0.2
+  },
+  "openai:whatsapp-support-draft": {
+    ourCostCents: 0.4,
+    userPriceCents: 0.8
+  },
   // Task-derived creative recommendation (angle/persona/script/landing-section).
   // OpenRouter usage normally supplies the exact COGS and the call layer charges
   // 2x. This rule is the fail-closed fallback when usage.cost is unavailable.
@@ -6930,6 +7076,28 @@ async function submitCreative(api, opts) {
   });
 }
 __name(submitCreative, "submitCreative");
+var ResearchTargetCountryEnum = z38.enum([
+  "CO",
+  "MX",
+  "PE",
+  "EC",
+  "CL"
+]);
+var ResearchCategoryEnum = z38.enum([
+  "auto",
+  "automotive",
+  "kitchen",
+  "pets",
+  "home_organization",
+  "beauty",
+  "wellness",
+  "fitness",
+  "baby",
+  "tech",
+  "tools",
+  "garden",
+  "cleaning"
+]);
 
 // src/errors.ts
 var McpErrorCode = {
@@ -6961,6 +7129,7 @@ var McpErrorCode = {
   TASK_NOT_READY: "TASK_NOT_READY",
   CREATIVE_VARIANT_FAILED: "CREATIVE_VARIANT_FAILED",
   CREATIVE_VARIANT_DISPATCH_FAILED: "CREATIVE_VARIANT_DISPATCH_FAILED",
+  PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT: "PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT",
   // Connection presence
   NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
   NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
@@ -7082,12 +7251,13 @@ var CODE_MESSAGES = {
   TASK_NOT_READY: "The task is not ready for this action yet. Wait for it to finish and retry.",
   CREATIVE_VARIANT_FAILED: "The previous creative variant attempt failed. Ask for confirmation before starting a new paid attempt with a new clientRequestId.",
   CREATIVE_VARIANT_DISPATCH_FAILED: "The creative variant could not be queued. Retry as a new paid attempt with a new clientRequestId.",
+  PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT: "A product research run with the same country and category is already running. Check it with `list_product_research_runs` instead of starting a new paid run.",
   // API key
   INVALID_API_KEY: "Invalid API key. Check your PM_API_KEY in the MCP client configuration.",
   REVOKED_API_KEY: "API key revoked. Generate a new one at https://productmaker.app/account/api-keys.",
   // Rate
   RATE_LIMITED: "Too many requests. Wait a few seconds.",
-  INSUFFICIENT_CREDITS: "Insufficient credits to create this variant. Check your balance and retry after adding credits.",
+  INSUFFICIENT_CREDITS: "Insufficient credits for this action. Check your balance and add credits at https://productmaker.app before retrying.",
   TASK_QUOTA_EXCEEDED: "You reached the active-task limit. Wait for a task to finish before creating another variant.",
   // Generic
   UPSTREAM_UNAVAILABLE: "The Product Maker service did not respond. Try again shortly.",
@@ -7100,6 +7270,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.INVALID_INPUT,
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
+  McpErrorCode.PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT,
   McpErrorCode.INVALID_API_KEY,
   McpErrorCode.REVOKED_API_KEY,
   McpErrorCode.IMAGE_PATH_NOT_FOUND,
@@ -7162,6 +7333,7 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
   McpErrorCode.CREATIVE_VARIANT_DISPATCH_FAILED,
+  McpErrorCode.PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT,
   // Shopify
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
@@ -7275,9 +7447,11 @@ function translateError(err) {
     const body = isRecord(err.body) ? err.body : {};
     if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
       const code = body.code;
-      return mcp(code, resolveMessage(code, body.message), body.helpUrl ? {
-        helpUrl: body.helpUrl
-      } : {});
+      const extra = {};
+      if (body.helpUrl !== void 0) extra.helpUrl = body.helpUrl;
+      if (typeof body.requiredCredits === "number") extra.requiredCredits = body.requiredCredits;
+      if (typeof body.availableCredits === "number") extra.availableCredits = body.availableCredits;
+      return mcp(code, resolveMessage(code, body.message), extra);
     }
     if (err.status === 401) {
       return mcp(McpErrorCode.INVALID_API_KEY, resolveMessage(McpErrorCode.INVALID_API_KEY, void 0));
@@ -9645,6 +9819,224 @@ function formatPercent(value) {
 }
 __name(formatPercent, "formatPercent");
 
+// src/tools/product-research.ts
+import { z as z49 } from "zod";
+
+// src/tools/product-research-idempotency.ts
+import { createHash as createHash2 } from "crypto";
+var RESEARCH_IDEMPOTENCY_WINDOW_MS = 2 * 60 * 60 * 1e3;
+var NAMESPACE = "6f9d3a1e-8c47-4b52-9f10-2d7e5a3c8b64";
+function uuidV5(name, namespace) {
+  const namespaceBytes = Buffer.from(namespace.replace(/-/g, ""), "hex");
+  const digest = createHash2("sha1").update(namespaceBytes).update(name, "utf8").digest();
+  const bytes = Buffer.from(digest.subarray(0, 16));
+  bytes[6] = (bytes[6] ?? 0) & 15 | 80;
+  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+  const hex = bytes.toString("hex");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20)
+  ].join("-");
+}
+__name(uuidV5, "uuidV5");
+function deriveIdempotencyKey(input) {
+  const window = Math.floor(input.nowMs / RESEARCH_IDEMPOTENCY_WINDOW_MS);
+  const name = `${input.fingerprint}:${input.targetCountry}:${input.categoryKey}:${window}`;
+  return uuidV5(name, NAMESPACE);
+}
+__name(deriveIdempotencyKey, "deriveIdempotencyKey");
+
+// src/tools/product-research-render.ts
+var num = /* @__PURE__ */ __name((value, suffix = "") => value === void 0 ? "\u2014" : `${Math.round(value * 100) / 100}${suffix}`, "num");
+function renderMeta(meta) {
+  if (meta.status === "evidence_failed") {
+    return [
+      "- \u26A0\uFE0F **Sin evidencia publicitaria:** no se pudo consultar Meta Ads para este producto. La puntuaci\xF3n se apoya s\xF3lo en datos de venta."
+    ];
+  }
+  if (meta.status === "evidence_empty") {
+    return [
+      "- \u26A0\uFE0F **Sin evidencia publicitaria:** no se encontraron anuncios activos en Meta. Puede ser un mercado virgen o una b\xFAsqueda sin cobertura; la puntuaci\xF3n se apoya s\xF3lo en datos de venta."
+    ];
+  }
+  return [
+    `- **Evidencia en Meta Ads:** ${meta.totalAds} anuncios de ${meta.distinctAdvertisers} anunciantes, m\xE1ximo ${meta.maxActiveDays} d\xEDas activos, oportunidad de \xE1ngulo ${meta.angleOpportunity}/100.`,
+    meta.summary ? `  ${meta.summary}` : ""
+  ].filter(Boolean);
+}
+__name(renderMeta, "renderMeta");
+function renderCandidate(candidate, index) {
+  const name = candidate.nameLocal ?? candidate.nameOriginal;
+  const lines = [
+    `### ${index + 1}. ${name}`,
+    `**${candidate.score}/100 \xB7 ${candidate.label} \xB7 confianza ${candidate.confidence}**`
+  ];
+  if (candidate.insight) lines.push("", candidate.insight);
+  lines.push("", "**Por qu\xE9:**");
+  lines.push(...candidate.reasons.map((reason) => `- ${reason}`));
+  lines.push("", "**Riesgos:**");
+  lines.push(...candidate.risks.length > 0 ? candidate.risks.map((risk) => `- ${risk}`) : [
+    "- No se identificaron riesgos espec\xEDficos."
+  ]);
+  lines.push("", ...renderMeta(candidate.meta));
+  lines.push("", `- **Venta (30d):** ${num(candidate.units30d)} unidades \xB7 ${num(candidate.revenueUsd30d, " USD")} \xB7 crecimiento ${num(candidate.growthPct30d, "%")} \xB7 precio ${num(candidate.priceUsd, " USD")}`);
+  if (candidate.productUrl) lines.push(`- [Ver producto](${candidate.productUrl})`);
+  return lines.join("\n");
+}
+__name(renderCandidate, "renderCandidate");
+function renderResearchReport(run) {
+  if (run.status === "failed" || run.status === "refunded") {
+    return [
+      `\u274C **La investigaci\xF3n no pudo completarse** (estado: ${run.status}).`,
+      run.errorCode ? `C\xF3digo: \`${run.errorCode}\`` : "",
+      run.refunded ? `Los ${run.priceCredits} cr\xE9ditos fueron reembolsados.` : "\u26A0\uFE0F No consta reembolso \u2014 rev\xEDsalo antes de reintentar."
+    ].filter(Boolean).join("\n");
+  }
+  if (run.status === "ready" && run.result === null) {
+    return [
+      `\u274C **No se pudo leer el reporte** (estado: ${run.status}).`,
+      `El cargo de ${run.priceCredits} cr\xE9ditos ya se realiz\xF3, pero el reporte qued\xF3 corrupto y no puede recuperarse.`,
+      `Contacta a soporte con este runId para revisar un reembolso: \`${run.id}\`.`
+    ].join("\n");
+  }
+  if (run.result === null) {
+    return [
+      `\u23F3 **La investigaci\xF3n sigue en curso** (estado: ${run.status}, etapa: ${run.progressStage}).`,
+      `El cargo de ${run.priceCredits} cr\xE9ditos ya se realiz\xF3; el reporte no se pierde.`,
+      `Cons\xFAltalo con \`get_product_research_run\` usando runId \`${run.id}\`.`
+    ].join("\n");
+  }
+  const { result } = run;
+  const degraded = result.candidates.filter((candidate) => candidate.meta.status !== "evidence_available").length;
+  const header = [
+    `\u2705 **Productos ganadores \xB7 ${result.targetCountry} \xB7 ${result.categoryKey}**`,
+    "",
+    `Analizados ${result.methodology.kaloCandidateCount} candidatos del mercado ${result.sourceMarket}; ${result.methodology.metaCoveredCandidateCount} con cobertura de Meta Ads. Datos con ${num(result.freshnessHours, " h")} de antig\xFCedad.`
+  ];
+  if (degraded > 0) {
+    header.push("", `\u26A0\uFE0F ${degraded} de ${result.candidates.length} productos no tienen evidencia publicitaria. Su puntuaci\xF3n se apoya s\xF3lo en datos de venta.`);
+  }
+  return [
+    ...header,
+    "",
+    ...result.candidates.map((candidate, index) => renderCandidate(candidate, index))
+  ].join("\n\n");
+}
+__name(renderResearchReport, "renderResearchReport");
+
+// src/tools/product-research.ts
+var PRICE_CREDITS = 2e3;
+var TERMINAL2 = /* @__PURE__ */ new Set([
+  "ready",
+  "failed",
+  "refunded"
+]);
+var POLL_INTERVAL_MS = 5e3;
+var MAX_WAIT_SECONDS = 120;
+var FindInput = z49.object({
+  targetCountry: ResearchTargetCountryEnum.describe("Pa\xEDs objetivo. S\xF3lo CO, MX, PE, EC y CL tienen cobertura de investigaci\xF3n."),
+  categoryKey: ResearchCategoryEnum.default("auto").describe('Categor\xEDa a investigar. Usa "auto" para que la IA elija seg\xFAn el mercado.'),
+  confirmed: z49.boolean().describe(`Ponlo en true SOLO despu\xE9s de que el usuario haya aceptado el cargo de ${PRICE_CREDITS} cr\xE9ditos. No lo asumas.`),
+  waitSeconds: z49.number().int().min(0).max(MAX_WAIT_SECONDS).optional().describe("Segundos a esperar el reporte antes de devolver el runId. M\xE1ximo 120.")
+});
+var GetInput = z49.object({
+  runId: z49.string().uuid().describe("ID del run devuelto por find_winning_products.")
+});
+var ListInput = z49.object({
+  limit: z49.number().int().min(1).max(20).default(10)
+});
+function textResult(text) {
+  return {
+    content: [
+      {
+        type: "text",
+        text
+      }
+    ]
+  };
+}
+__name(textResult, "textResult");
+var sleep2 = /* @__PURE__ */ __name((ms) => new Promise((resolve3) => setTimeout(resolve3, ms)), "sleep");
+async function pollUntilTerminal(api, runId, waitSeconds) {
+  const deadline = Date.now() + Math.min(waitSeconds, MAX_WAIT_SECONDS) * 1e3;
+  let run = await api.getJson(`/v1/product-research/runs/${runId}`);
+  while (!TERMINAL2.has(run.status) && Date.now() < deadline) {
+    await sleep2(POLL_INTERVAL_MS);
+    run = await api.getJson(`/v1/product-research/runs/${runId}`);
+  }
+  return run;
+}
+__name(pollUntilTerminal, "pollUntilTerminal");
+function registerProductResearchTools(server, api) {
+  server.tool("find_winning_products", `Busca productos ganadores de dropshipping para un pa\xEDs y categor\xEDa, y explica POR QU\xC9 la IA eligi\xF3 cada uno (razones, riesgos y evidencia real de anuncios en Meta Ads). CUESTA ${PRICE_CREDITS} CR\xC9DITOS por ejecuci\xF3n. ANTES de invocar, dile al usuario el costo y espera su aceptaci\xF3n expl\xEDcita; s\xF3lo entonces pasa confirmed: true. Consulta primero list_product_research_runs (GRATIS) \u2014 puede que el usuario ya tenga un reporte pagado para ese pa\xEDs/categor\xEDa y no necesites cobrar de nuevo. Pa\xEDses disponibles: CO, MX, PE, EC, CL. Tarda varios minutos: usa waitSeconds para esperar, y si expira consulta el resultado con get_product_research_run \u2014 el reporte NO se pierde.`, FindInput.shape, async (input) => {
+    const parsed = FindInput.parse(input);
+    if (!parsed.confirmed) {
+      throw mcp(McpErrorCode.INVALID_INPUT, `This research run costs ${PRICE_CREDITS} credits. Tell the user the cost, get an explicit yes, then call again with confirmed: true.`);
+    }
+    try {
+      const idempotencyKey = deriveIdempotencyKey({
+        fingerprint: api.fingerprint(),
+        targetCountry: parsed.targetCountry,
+        categoryKey: parsed.categoryKey,
+        nowMs: Date.now()
+      });
+      const created = await api.postJson("/v1/product-research/runs", {
+        targetCountry: parsed.targetCountry,
+        categoryKey: parsed.categoryKey,
+        idempotencyKey
+      });
+      const waitSeconds = parsed.waitSeconds ?? 0;
+      let run = created;
+      if (waitSeconds > 0 && !TERMINAL2.has(created.status)) {
+        try {
+          run = await pollUntilTerminal(api, created.id, waitSeconds);
+        } catch {
+          run = created;
+        }
+      }
+      const notice = created.reused ? `
+
+_Esta llamada no cobr\xF3 cr\xE9ditos: se reutiliz\xF3 una investigaci\xF3n reciente con los mismos par\xE1metros. Para investigar una categor\xEDa distinta, vuelve a llamar con un \`categoryKey\` expl\xEDcito \u2014 eso inicia una investigaci\xF3n NUEVA con un cargo NUEVO de ${PRICE_CREDITS} cr\xE9ditos, as\xED que pide confirmaci\xF3n expl\xEDcita al usuario antes de hacerlo._` : "";
+      return textResult(`${renderResearchReport(run)}${notice}`);
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
+  server.tool("get_product_research_run", "Devuelve el reporte completo de una investigaci\xF3n de productos ganadores: score, veredicto, confianza, razones, riesgos y evidencia de Meta Ads por producto. GRATIS y read-only. \xDAsalo cuando find_winning_products expir\xF3 la espera, o para releer un reporte anterior encontrado con list_product_research_runs.", GetInput.shape, async (input) => {
+    const parsed = GetInput.parse(input);
+    try {
+      const run = await api.getJson(`/v1/product-research/runs/${parsed.runId}`);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(run)
+          },
+          {
+            type: "text",
+            text: renderResearchReport(run)
+          }
+        ]
+      };
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
+  server.tool("list_product_research_runs", "Lista las investigaciones de productos ganadores ya pagadas por el usuario, de la m\xE1s reciente a la m\xE1s antigua. GRATIS y read-only. Cons\xFAltalo ANTES de lanzar una nueva: un reporte ya pagado se relee gratis con get_product_research_run.", ListInput.shape, async (input) => {
+    const parsed = ListInput.parse(input);
+    try {
+      const runs = await api.getJson(`/v1/product-research/runs?limit=${parsed.limit}`);
+      return textResult(JSON.stringify(runs));
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
+}
+__name(registerProductResearchTools, "registerProductResearchTools");
+
 // src/server.ts
 function createServer(opts) {
   const { apiKey, apiBaseUrl, proxyBaseUrl = null, transport = "http" } = opts;
@@ -9661,6 +10053,7 @@ function createServer(opts) {
   });
   const api = new ApiClient(apiBaseUrl, apiKey);
   registerProductCostingTools(server);
+  registerProductResearchTools(server, api);
   registerTaskTools(server, api, {
     proxyBaseUrl,
     transport

package/dist/stdio.js

@@ -9,6 +9,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/api-client.ts
+import { createHash } from "crypto";
 var ApiHttpError = class extends Error {
   static {
     __name(this, "ApiHttpError");
@@ -35,6 +36,15 @@ var ApiClient = class {
       Authorization: `Bearer ${this.apiKey}`
     };
   }
+  /**
+  * Stable per-key identifier. The MCP never sees the userId — the API key is
+  * the only per-user handle it holds — so this stands in as the user
+  * component of derived idempotency keys. Never log or return it raw to a
+  * caller: it is derived from a secret.
+  */
+  fingerprint() {
+    return createHash("sha256").update(this.apiKey).digest("hex").slice(0, 32);
+  }
   async getJson(path3) {
     const res = await fetch(`${this.baseUrl}${path3}`, {
       headers: this.authHeaders()
@@ -129,7 +139,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "1.16.3";
+var MCP_VERSION = "1.17.0";
 
 // src/tools/tasks.ts
 import { z as z39 } from "zod";
@@ -3146,6 +3156,125 @@ var AdminQualityReportListResponse = z24.object({
 var UpdateQualityReportStatusRequest = z24.object({
   status: QualityReportStatus
 });
+var AdminSupportConversationStatus = z24.enum([
+  "bot_active",
+  "human_pending",
+  "human_active",
+  "closed"
+]);
+var AdminSupportDeliveryStatus = z24.enum([
+  "draft",
+  "pending",
+  "sent",
+  "delivered",
+  "read",
+  "failed",
+  "blocked"
+]);
+var AdminSupportMessage = z24.object({
+  id: z24.string().uuid(),
+  direction: z24.enum([
+    "inbound",
+    "outbound"
+  ]),
+  senderKind: z24.enum([
+    "user",
+    "bot",
+    "admin",
+    "system"
+  ]),
+  messageType: z24.enum([
+    "text",
+    "image",
+    "audio",
+    "document",
+    "interactive",
+    "status"
+  ]),
+  bodyRedacted: z24.string().nullable(),
+  deliveryStatus: AdminSupportDeliveryStatus.nullable(),
+  createdAt: z24.string().datetime()
+});
+var AdminSupportTicket = z24.object({
+  id: z24.string().uuid(),
+  category: z24.enum([
+    "how_to",
+    "credits",
+    "billing",
+    "task_status",
+    "task_error",
+    "video_quality",
+    "landing_quality",
+    "image_quality",
+    "feature_request",
+    "other"
+  ]),
+  failureMode: z24.string().nullable(),
+  status: z24.enum([
+    "open",
+    "triaged",
+    "resolved",
+    "rejected"
+  ]),
+  summary: z24.string(),
+  taskId: z24.string().nullable(),
+  mixTaskId: z24.string().nullable(),
+  qualityReportId: z24.string().nullable(),
+  handoffReason: z24.string().nullable(),
+  createdAt: z24.string().datetime(),
+  updatedAt: z24.string().datetime()
+});
+var AdminSupportConversation = z24.object({
+  id: z24.string().uuid(),
+  status: AdminSupportConversationStatus,
+  priority: z24.enum([
+    "low",
+    "normal",
+    "high",
+    "urgent"
+  ]),
+  currentIntent: z24.string().nullable(),
+  assignedAdminId: z24.string().nullable(),
+  customerServiceWindowEndsAt: z24.string().datetime().nullable(),
+  lastInboundAt: z24.string().datetime().nullable(),
+  createdAt: z24.string().datetime(),
+  updatedAt: z24.string().datetime(),
+  contact: z24.object({
+    id: z24.string().uuid(),
+    userId: z24.string().nullable(),
+    verifiedAt: z24.string().datetime().nullable(),
+    botMode: z24.enum([
+      "enabled",
+      "paused",
+      "opted_out"
+    ]),
+    locale: z24.string()
+  }),
+  messages: z24.array(AdminSupportMessage),
+  tickets: z24.array(AdminSupportTicket)
+});
+var AdminSupportListQuery = z24.object({
+  status: AdminSupportConversationStatus.optional(),
+  take: z24.coerce.number().int().min(1).max(100).default(50),
+  cursorId: z24.string().uuid().optional()
+}).strict();
+var AdminSupportListResponse = z24.object({
+  conversations: z24.array(AdminSupportConversation),
+  nextCursor: z24.string().uuid().nullable()
+});
+var AdminSupportReplyRequest = z24.object({
+  body: z24.string().trim().min(1).max(4096),
+  idempotencyKey: z24.string().regex(/^[A-Za-z0-9_-]{8,128}$/)
+}).strict();
+var AdminSupportEmptyActionRequest = z24.object({}).strict();
+var AdminSupportActionResponse = z24.object({
+  conversation: AdminSupportConversation
+});
+var AdminSupportReplyResponse = z24.object({
+  messageId: z24.string().uuid(),
+  deliveryStatus: AdminSupportDeliveryStatus,
+  duplicate: z24.boolean()
+});
 
 // ../../packages/types/src/promo.ts
 import { z as z25 } from "zod";
@@ -3981,6 +4110,23 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.4,
     userPriceCents: 0.8
   },
+  // WhatsApp ProductMaker intent proposal. Real OpenRouter usage.cost wins;
+  // this is only the fallback when the relay omits cost.
+  "openrouter:whatsapp-product-agent-intent": {
+    ourCostCents: 0.4,
+    userPriceCents: 0.8
+  },
+  // Internal support calls are cost-only: callers explicitly override user
+  // price to zero. Static COGS estimates apply because OpenAI Responses exposes
+  // token counts but not the provider's dollar charge.
+  "openai:whatsapp-support-classifier": {
+    ourCostCents: 0.1,
+    userPriceCents: 0.2
+  },
+  "openai:whatsapp-support-draft": {
+    ourCostCents: 0.4,
+    userPriceCents: 0.8
+  },
   // Task-derived creative recommendation (angle/persona/script/landing-section).
   // OpenRouter usage normally supplies the exact COGS and the call layer charges
   // 2x. This rule is the fail-closed fallback when usage.cost is unavailable.
@@ -6927,6 +7073,28 @@ async function submitCreative(api, opts) {
   });
 }
 __name(submitCreative, "submitCreative");
+var ResearchTargetCountryEnum = z38.enum([
+  "CO",
+  "MX",
+  "PE",
+  "EC",
+  "CL"
+]);
+var ResearchCategoryEnum = z38.enum([
+  "auto",
+  "automotive",
+  "kitchen",
+  "pets",
+  "home_organization",
+  "beauty",
+  "wellness",
+  "fitness",
+  "baby",
+  "tech",
+  "tools",
+  "garden",
+  "cleaning"
+]);
 
 // src/errors.ts
 var McpErrorCode = {
@@ -6958,6 +7126,7 @@ var McpErrorCode = {
   TASK_NOT_READY: "TASK_NOT_READY",
   CREATIVE_VARIANT_FAILED: "CREATIVE_VARIANT_FAILED",
   CREATIVE_VARIANT_DISPATCH_FAILED: "CREATIVE_VARIANT_DISPATCH_FAILED",
+  PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT: "PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT",
   // Connection presence
   NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
   NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
@@ -7079,12 +7248,13 @@ var CODE_MESSAGES = {
   TASK_NOT_READY: "The task is not ready for this action yet. Wait for it to finish and retry.",
   CREATIVE_VARIANT_FAILED: "The previous creative variant attempt failed. Ask for confirmation before starting a new paid attempt with a new clientRequestId.",
   CREATIVE_VARIANT_DISPATCH_FAILED: "The creative variant could not be queued. Retry as a new paid attempt with a new clientRequestId.",
+  PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT: "A product research run with the same country and category is already running. Check it with `list_product_research_runs` instead of starting a new paid run.",
   // API key
   INVALID_API_KEY: "Invalid API key. Check your PM_API_KEY in the MCP client configuration.",
   REVOKED_API_KEY: "API key revoked. Generate a new one at https://productmaker.app/account/api-keys.",
   // Rate
   RATE_LIMITED: "Too many requests. Wait a few seconds.",
-  INSUFFICIENT_CREDITS: "Insufficient credits to create this variant. Check your balance and retry after adding credits.",
+  INSUFFICIENT_CREDITS: "Insufficient credits for this action. Check your balance and add credits at https://productmaker.app before retrying.",
   TASK_QUOTA_EXCEEDED: "You reached the active-task limit. Wait for a task to finish before creating another variant.",
   // Generic
   UPSTREAM_UNAVAILABLE: "The Product Maker service did not respond. Try again shortly.",
@@ -7097,6 +7267,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.INVALID_INPUT,
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
+  McpErrorCode.PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT,
   McpErrorCode.INVALID_API_KEY,
   McpErrorCode.REVOKED_API_KEY,
   McpErrorCode.IMAGE_PATH_NOT_FOUND,
@@ -7159,6 +7330,7 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
   McpErrorCode.CREATIVE_VARIANT_DISPATCH_FAILED,
+  McpErrorCode.PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT,
   // Shopify
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
@@ -7272,9 +7444,11 @@ function translateError(err) {
     const body = isRecord(err.body) ? err.body : {};
     if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
       const code = body.code;
-      return mcp(code, resolveMessage(code, body.message), body.helpUrl ? {
-        helpUrl: body.helpUrl
-      } : {});
+      const extra = {};
+      if (body.helpUrl !== void 0) extra.helpUrl = body.helpUrl;
+      if (typeof body.requiredCredits === "number") extra.requiredCredits = body.requiredCredits;
+      if (typeof body.availableCredits === "number") extra.availableCredits = body.availableCredits;
+      return mcp(code, resolveMessage(code, body.message), extra);
     }
     if (err.status === 401) {
       return mcp(McpErrorCode.INVALID_API_KEY, resolveMessage(McpErrorCode.INVALID_API_KEY, void 0));
@@ -9601,6 +9775,224 @@ function formatPercent(value) {
 }
 __name(formatPercent, "formatPercent");
 
+// src/tools/product-research.ts
+import { z as z49 } from "zod";
+
+// src/tools/product-research-idempotency.ts
+import { createHash as createHash2 } from "crypto";
+var RESEARCH_IDEMPOTENCY_WINDOW_MS = 2 * 60 * 60 * 1e3;
+var NAMESPACE = "6f9d3a1e-8c47-4b52-9f10-2d7e5a3c8b64";
+function uuidV5(name, namespace) {
+  const namespaceBytes = Buffer.from(namespace.replace(/-/g, ""), "hex");
+  const digest = createHash2("sha1").update(namespaceBytes).update(name, "utf8").digest();
+  const bytes = Buffer.from(digest.subarray(0, 16));
+  bytes[6] = (bytes[6] ?? 0) & 15 | 80;
+  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+  const hex = bytes.toString("hex");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20)
+  ].join("-");
+}
+__name(uuidV5, "uuidV5");
+function deriveIdempotencyKey(input) {
+  const window = Math.floor(input.nowMs / RESEARCH_IDEMPOTENCY_WINDOW_MS);
+  const name = `${input.fingerprint}:${input.targetCountry}:${input.categoryKey}:${window}`;
+  return uuidV5(name, NAMESPACE);
+}
+__name(deriveIdempotencyKey, "deriveIdempotencyKey");
+
+// src/tools/product-research-render.ts
+var num = /* @__PURE__ */ __name((value, suffix = "") => value === void 0 ? "\u2014" : `${Math.round(value * 100) / 100}${suffix}`, "num");
+function renderMeta(meta) {
+  if (meta.status === "evidence_failed") {
+    return [
+      "- \u26A0\uFE0F **Sin evidencia publicitaria:** no se pudo consultar Meta Ads para este producto. La puntuaci\xF3n se apoya s\xF3lo en datos de venta."
+    ];
+  }
+  if (meta.status === "evidence_empty") {
+    return [
+      "- \u26A0\uFE0F **Sin evidencia publicitaria:** no se encontraron anuncios activos en Meta. Puede ser un mercado virgen o una b\xFAsqueda sin cobertura; la puntuaci\xF3n se apoya s\xF3lo en datos de venta."
+    ];
+  }
+  return [
+    `- **Evidencia en Meta Ads:** ${meta.totalAds} anuncios de ${meta.distinctAdvertisers} anunciantes, m\xE1ximo ${meta.maxActiveDays} d\xEDas activos, oportunidad de \xE1ngulo ${meta.angleOpportunity}/100.`,
+    meta.summary ? `  ${meta.summary}` : ""
+  ].filter(Boolean);
+}
+__name(renderMeta, "renderMeta");
+function renderCandidate(candidate, index) {
+  const name = candidate.nameLocal ?? candidate.nameOriginal;
+  const lines = [
+    `### ${index + 1}. ${name}`,
+    `**${candidate.score}/100 \xB7 ${candidate.label} \xB7 confianza ${candidate.confidence}**`
+  ];
+  if (candidate.insight) lines.push("", candidate.insight);
+  lines.push("", "**Por qu\xE9:**");
+  lines.push(...candidate.reasons.map((reason) => `- ${reason}`));
+  lines.push("", "**Riesgos:**");
+  lines.push(...candidate.risks.length > 0 ? candidate.risks.map((risk) => `- ${risk}`) : [
+    "- No se identificaron riesgos espec\xEDficos."
+  ]);
+  lines.push("", ...renderMeta(candidate.meta));
+  lines.push("", `- **Venta (30d):** ${num(candidate.units30d)} unidades \xB7 ${num(candidate.revenueUsd30d, " USD")} \xB7 crecimiento ${num(candidate.growthPct30d, "%")} \xB7 precio ${num(candidate.priceUsd, " USD")}`);
+  if (candidate.productUrl) lines.push(`- [Ver producto](${candidate.productUrl})`);
+  return lines.join("\n");
+}
+__name(renderCandidate, "renderCandidate");
+function renderResearchReport(run) {
+  if (run.status === "failed" || run.status === "refunded") {
+    return [
+      `\u274C **La investigaci\xF3n no pudo completarse** (estado: ${run.status}).`,
+      run.errorCode ? `C\xF3digo: \`${run.errorCode}\`` : "",
+      run.refunded ? `Los ${run.priceCredits} cr\xE9ditos fueron reembolsados.` : "\u26A0\uFE0F No consta reembolso \u2014 rev\xEDsalo antes de reintentar."
+    ].filter(Boolean).join("\n");
+  }
+  if (run.status === "ready" && run.result === null) {
+    return [
+      `\u274C **No se pudo leer el reporte** (estado: ${run.status}).`,
+      `El cargo de ${run.priceCredits} cr\xE9ditos ya se realiz\xF3, pero el reporte qued\xF3 corrupto y no puede recuperarse.`,
+      `Contacta a soporte con este runId para revisar un reembolso: \`${run.id}\`.`
+    ].join("\n");
+  }
+  if (run.result === null) {
+    return [
+      `\u23F3 **La investigaci\xF3n sigue en curso** (estado: ${run.status}, etapa: ${run.progressStage}).`,
+      `El cargo de ${run.priceCredits} cr\xE9ditos ya se realiz\xF3; el reporte no se pierde.`,
+      `Cons\xFAltalo con \`get_product_research_run\` usando runId \`${run.id}\`.`
+    ].join("\n");
+  }
+  const { result } = run;
+  const degraded = result.candidates.filter((candidate) => candidate.meta.status !== "evidence_available").length;
+  const header = [
+    `\u2705 **Productos ganadores \xB7 ${result.targetCountry} \xB7 ${result.categoryKey}**`,
+    "",
+    `Analizados ${result.methodology.kaloCandidateCount} candidatos del mercado ${result.sourceMarket}; ${result.methodology.metaCoveredCandidateCount} con cobertura de Meta Ads. Datos con ${num(result.freshnessHours, " h")} de antig\xFCedad.`
+  ];
+  if (degraded > 0) {
+    header.push("", `\u26A0\uFE0F ${degraded} de ${result.candidates.length} productos no tienen evidencia publicitaria. Su puntuaci\xF3n se apoya s\xF3lo en datos de venta.`);
+  }
+  return [
+    ...header,
+    "",
+    ...result.candidates.map((candidate, index) => renderCandidate(candidate, index))
+  ].join("\n\n");
+}
+__name(renderResearchReport, "renderResearchReport");
+
+// src/tools/product-research.ts
+var PRICE_CREDITS = 2e3;
+var TERMINAL2 = /* @__PURE__ */ new Set([
+  "ready",
+  "failed",
+  "refunded"
+]);
+var POLL_INTERVAL_MS = 5e3;
+var MAX_WAIT_SECONDS = 120;
+var FindInput = z49.object({
+  targetCountry: ResearchTargetCountryEnum.describe("Pa\xEDs objetivo. S\xF3lo CO, MX, PE, EC y CL tienen cobertura de investigaci\xF3n."),
+  categoryKey: ResearchCategoryEnum.default("auto").describe('Categor\xEDa a investigar. Usa "auto" para que la IA elija seg\xFAn el mercado.'),
+  confirmed: z49.boolean().describe(`Ponlo en true SOLO despu\xE9s de que el usuario haya aceptado el cargo de ${PRICE_CREDITS} cr\xE9ditos. No lo asumas.`),
+  waitSeconds: z49.number().int().min(0).max(MAX_WAIT_SECONDS).optional().describe("Segundos a esperar el reporte antes de devolver el runId. M\xE1ximo 120.")
+});
+var GetInput = z49.object({
+  runId: z49.string().uuid().describe("ID del run devuelto por find_winning_products.")
+});
+var ListInput = z49.object({
+  limit: z49.number().int().min(1).max(20).default(10)
+});
+function textResult(text) {
+  return {
+    content: [
+      {
+        type: "text",
+        text
+      }
+    ]
+  };
+}
+__name(textResult, "textResult");
+var sleep2 = /* @__PURE__ */ __name((ms) => new Promise((resolve3) => setTimeout(resolve3, ms)), "sleep");
+async function pollUntilTerminal(api, runId, waitSeconds) {
+  const deadline = Date.now() + Math.min(waitSeconds, MAX_WAIT_SECONDS) * 1e3;
+  let run = await api.getJson(`/v1/product-research/runs/${runId}`);
+  while (!TERMINAL2.has(run.status) && Date.now() < deadline) {
+    await sleep2(POLL_INTERVAL_MS);
+    run = await api.getJson(`/v1/product-research/runs/${runId}`);
+  }
+  return run;
+}
+__name(pollUntilTerminal, "pollUntilTerminal");
+function registerProductResearchTools(server, api) {
+  server.tool("find_winning_products", `Busca productos ganadores de dropshipping para un pa\xEDs y categor\xEDa, y explica POR QU\xC9 la IA eligi\xF3 cada uno (razones, riesgos y evidencia real de anuncios en Meta Ads). CUESTA ${PRICE_CREDITS} CR\xC9DITOS por ejecuci\xF3n. ANTES de invocar, dile al usuario el costo y espera su aceptaci\xF3n expl\xEDcita; s\xF3lo entonces pasa confirmed: true. Consulta primero list_product_research_runs (GRATIS) \u2014 puede que el usuario ya tenga un reporte pagado para ese pa\xEDs/categor\xEDa y no necesites cobrar de nuevo. Pa\xEDses disponibles: CO, MX, PE, EC, CL. Tarda varios minutos: usa waitSeconds para esperar, y si expira consulta el resultado con get_product_research_run \u2014 el reporte NO se pierde.`, FindInput.shape, async (input) => {
+    const parsed = FindInput.parse(input);
+    if (!parsed.confirmed) {
+      throw mcp(McpErrorCode.INVALID_INPUT, `This research run costs ${PRICE_CREDITS} credits. Tell the user the cost, get an explicit yes, then call again with confirmed: true.`);
+    }
+    try {
+      const idempotencyKey = deriveIdempotencyKey({
+        fingerprint: api.fingerprint(),
+        targetCountry: parsed.targetCountry,
+        categoryKey: parsed.categoryKey,
+        nowMs: Date.now()
+      });
+      const created = await api.postJson("/v1/product-research/runs", {
+        targetCountry: parsed.targetCountry,
+        categoryKey: parsed.categoryKey,
+        idempotencyKey
+      });
+      const waitSeconds = parsed.waitSeconds ?? 0;
+      let run = created;
+      if (waitSeconds > 0 && !TERMINAL2.has(created.status)) {
+        try {
+          run = await pollUntilTerminal(api, created.id, waitSeconds);
+        } catch {
+          run = created;
+        }
+      }
+      const notice = created.reused ? `
+
+_Esta llamada no cobr\xF3 cr\xE9ditos: se reutiliz\xF3 una investigaci\xF3n reciente con los mismos par\xE1metros. Para investigar una categor\xEDa distinta, vuelve a llamar con un \`categoryKey\` expl\xEDcito \u2014 eso inicia una investigaci\xF3n NUEVA con un cargo NUEVO de ${PRICE_CREDITS} cr\xE9ditos, as\xED que pide confirmaci\xF3n expl\xEDcita al usuario antes de hacerlo._` : "";
+      return textResult(`${renderResearchReport(run)}${notice}`);
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
+  server.tool("get_product_research_run", "Devuelve el reporte completo de una investigaci\xF3n de productos ganadores: score, veredicto, confianza, razones, riesgos y evidencia de Meta Ads por producto. GRATIS y read-only. \xDAsalo cuando find_winning_products expir\xF3 la espera, o para releer un reporte anterior encontrado con list_product_research_runs.", GetInput.shape, async (input) => {
+    const parsed = GetInput.parse(input);
+    try {
+      const run = await api.getJson(`/v1/product-research/runs/${parsed.runId}`);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(run)
+          },
+          {
+            type: "text",
+            text: renderResearchReport(run)
+          }
+        ]
+      };
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
+  server.tool("list_product_research_runs", "Lista las investigaciones de productos ganadores ya pagadas por el usuario, de la m\xE1s reciente a la m\xE1s antigua. GRATIS y read-only. Cons\xFAltalo ANTES de lanzar una nueva: un reporte ya pagado se relee gratis con get_product_research_run.", ListInput.shape, async (input) => {
+    const parsed = ListInput.parse(input);
+    try {
+      const runs = await api.getJson(`/v1/product-research/runs?limit=${parsed.limit}`);
+      return textResult(JSON.stringify(runs));
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
+}
+__name(registerProductResearchTools, "registerProductResearchTools");
+
 // src/server.ts
 function createServer(opts) {
   const { apiKey, apiBaseUrl, proxyBaseUrl = null, transport = "http" } = opts;
@@ -9617,6 +10009,7 @@ function createServer(opts) {
   });
   const api = new ApiClient(apiBaseUrl, apiKey);
   registerProductCostingTools(server);
+  registerProductResearchTools(server, api);
   registerTaskTools(server, api, {
     proxyBaseUrl,
     transport

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "1.16.3",
+  "version": "1.17.0",
   "type": "module",
   "private": false,
   "description": "Product Maker MCP server — cost products, generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from Claude, ChatGPT, or Gemini.",
@@ -63,8 +63,9 @@
     "tsx": "^4.16.0",
     "typescript": "^7.0.2",
     "vitest": "^2.1.9",
-    "@packages/types": "0.1.0",
-    "@packages/product-economics": "0.1.0"
+    "@packages/product-economics": "0.1.0",
+    "@packages/product-research": "0.1.0",
+    "@packages/types": "0.1.0"
   },
   "publishConfig": {
     "access": "public"