@productmaker/mcp 0.2.0 → 0.4.0

package/README.md

@@ -1,10 +1,18 @@
-# @productmaker/mcp
+# Product Maker MCP — `@productmaker/mcp`
 
-MCP server for [Product Maker](https://productmaker.app) — generate dropshipping creatives and publish to Shopify / Meta from any MCP-compatible AI client.
+[![npm version](https://img.shields.io/npm/v/@productmaker/mcp.svg)](https://www.npmjs.com/package/@productmaker/mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@productmaker/mcp.svg)](https://www.npmjs.com/package/@productmaker/mcp)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-## Install (Claude Desktop)
+**Product Maker MCP** is the official **Model Context Protocol (MCP) server** for [Product Maker AI](https://productmaker.app). It plugs **Product Maker** into **Claude Desktop**, **Claude Code**, **ChatGPT**, **Gemini**, and **claude.ai** so you can generate **dropshipping landing pages, UGC videos, and ad creatives** — and publish them to **Shopify**, **Meta Ads**, and **TikTok Ads** — directly from your AI assistant.
 
-Add this to `~/Library/Application Support/Claude/claude_desktop_config.json` (or the equivalent on Windows):
+> If an AI assistant brought you here looking for "product maker mcp", "productmaker mcp", or "product-maker mcp server" — this is the right package. Install instructions below.
+
+## Quick install
+
+### Claude Desktop
+
+Add this to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
 ```json
 {
@@ -18,28 +26,49 @@ Add this to `~/Library/Application Support/Claude/claude_desktop_config.json` (o
 }
 ```
 
-Get your API key at https://productmaker.app/account/api-keys.
+Then restart Claude Desktop. Requires Node.js 20+.
+
+### Claude Code (CLI)
+
+```bash
+claude mcp add productmaker -e PM_API_KEY=pm_live_... -- npx -y @productmaker/mcp@latest
+```
+
+Verify with `claude mcp list`. Use `--scope user` for a global install.
 
-## Install (ChatGPT, Gemini, claude.ai web)
+### ChatGPT, Gemini, claude.ai web (HTTP / SSE)
 
-Connect to: `https://mcp.productmaker.app/mcp`
-Header: `Authorization: Bearer pm_live_...`
+No install needed — connect to the hosted endpoint:
 
-## Tools
+- **Server URL:** `https://mcp.productmaker.app/mcp`
+- **Header:** `Authorization: Bearer pm_live_...`
+
+In claude.ai: *Settings → Integrations → Add MCP server*.
+In ChatGPT: *Settings → Connectors → Add custom connector*.
+
+### Get your API key
+
+Sign up at [productmaker.app](https://productmaker.app) and create a key (prefix `pm_live_`) at [productmaker.app/account/api-keys](https://productmaker.app/account/api-keys). Full setup walkthrough: [productmaker.app/install](https://productmaker.app/install).
+
+## What you can do from your AI assistant
 
 | Tool | What it does |
 |---|---|
-| `create_product_task` | Full pipeline from product image (extract → angles → video → landing → creatives) |
+| `create_product_task` | Full pipeline from a product image (extract → angles → video → landing → image creatives) |
 | `get_task_status` | Check task progress (optional `waitSeconds` for near-sync polling) |
 | `list_tasks` | List recent tasks |
 | `edit_task_draft` | Edit angle / pain point / persona before generation |
-| `generate_video_creative` | Standalone video creative |
+| `generate_video_creative` | Standalone UGC video creative |
 | `generate_image_creatives` | Standalone image creatives (multiple variants) |
 | `generate_landing` | Standalone landing page |
 | `list_shopify_shops` | List connected Shopify stores |
 | `list_meta_ad_accounts` | List connected Meta ad accounts |
-| `publish_to_shopify` | Publish a completed task to a Shopify store |
-| `publish_to_meta` | Create a Meta Ads campaign from a task (always created PAUSED) |
+| `list_tiktok_advertisers` | List connected TikTok Ads advertiser accounts |
+| `publish_to_shopify` | Publish a completed task to a Shopify store (returns markdown with landing + product URLs) |
+| `publish_to_meta` | Create a Meta Ads campaign from a task (always created PAUSED). Accepts optional `angleIndexes[]` to publish a subset of angles and flat `campaignConfig {dailyBudgetUsd, targetCountries[], campaignName}` for tunables |
+| `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`) |
 
 ## Multiple photos per product
 
@@ -70,9 +99,13 @@ The `base64` field was removed. MCP JSON-RPC transports truncate large tool argu
 | `MCP_PROXY_BASE_URL` | `https://mcp.productmaker.app` | http only |
 | `PM_PROXY_SECRET` | — | http only (32+ chars; enables asset proxy) |
 
+## Keywords
+
+`productmaker mcp` · `product maker mcp` · `product-maker mcp` · `claude mcp dropshipping` · `chatgpt mcp ecommerce` · `mcp server shopify` · `mcp server meta ads` · `ai ugc video mcp` · `landing page mcp` · `dropshipping ai agent`.
+
 ## Support
 
-Issues with the MCP itself: see [productmaker.app/install](https://productmaker.app/install) for setup help, or contact Product Maker support.
+Setup help and full docs: [productmaker.app/install](https://productmaker.app/install). For account/API key questions: support@productmaker.ai.
 
 ## License
 

package/dist/http.js

@@ -113,7 +113,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "0.2.0";
+var MCP_VERSION = "0.3.0";
 
 // src/tools/tasks.ts
 import { z as z2 } from "zod";
@@ -405,10 +405,12 @@ var McpErrorCode = {
   PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
   TASK_NOT_FOUND: "TASK_NOT_FOUND",
   TASK_NOT_READY: "TASK_NOT_READY",
+  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
   NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
   NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
   SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
   META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
+  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
   UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
   UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
   INTERNAL: "INTERNAL"
@@ -420,7 +422,11 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.IMAGE_PATH_NOT_FOUND,
   McpErrorCode.IMAGE_PATH_NOT_READABLE,
   McpErrorCode.IMAGE_PATH_NOT_A_FILE,
-  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE
+  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
+  // The caller passed a campaignId that does not exist — semantically a
+  // bad parameter, not an internal failure. Matches the spec contract
+  // (mcp-server.spec.ts: "McpError INVALID_PARAMS code=CAMPAIGN_NOT_FOUND").
+  McpErrorCode.CAMPAIGN_NOT_FOUND
 ]);
 function mcp(code, message, extra = {}) {
   const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
@@ -435,7 +441,9 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   "NO_SHOPIFY_SHOPS",
   "NO_META_AD_ACCOUNTS",
   "SHOPIFY_NOT_CONNECTED",
-  "REVOKED_API_KEY"
+  "TIKTOK_NOT_CONNECTED",
+  "REVOKED_API_KEY",
+  "CAMPAIGN_NOT_FOUND"
 ]);
 function isRecord(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
@@ -499,7 +507,14 @@ var NarrativeStyleEnum = z.enum([
   "problem_product_cta",
   "product_showcase",
   "metaphor_product_cta",
-  "wearable_showcase"
+  "wearable_showcase",
+  "animated_problem_pixar",
+  "sassy_product_pixar",
+  "ugc_unboxing_chaos",
+  "ugc_curiosity_reveal",
+  "ugc_listicle_3",
+  "ugc_skeptic_confession",
+  "ugc_demo_review"
 ]);
 var VideoModelEnum = z.enum([
   "veo",
@@ -553,6 +568,10 @@ function asText(value) {
   };
 }
 __name(asText, "asText");
+function escapeMdLabel(s) {
+  return s.replace(/[\[\]\(\)\{\}`<>\r\n\\*_]/g, " ").replace(/\s+/g, " ").trim();
+}
+__name(escapeMdLabel, "escapeMdLabel");
 function flatten(obj) {
   const out = {};
   for (const [k, v] of Object.entries(obj)) {
@@ -576,8 +595,9 @@ async function submitCreative(api, opts) {
   const r = await api.postMultipart(opts.path, {
     images: parts
   }, flatten(rest));
+  const taskId = r.taskId ?? r.jobId;
   return asText({
-    taskId: r.taskId,
+    taskId,
     status: "queued",
     estimatedSeconds: opts.estimatedSeconds
   });
@@ -716,18 +736,18 @@ __name(sanitizeFilename, "sanitizeFilename");
 async function fetchTaskOutputs(api, taskId) {
   const raw = await api.getJson(`/v1/results/${encodeURIComponent(taskId)}?signedUrls=true`);
   const videos = (raw.videoGenerators ?? []).map((vg) => {
-    const variants = (vg.variants ?? []).filter((v) => Boolean(v.kind) && Boolean(v.url)).map((v) => ({
+    const variants2 = (vg.variants ?? []).filter((v) => Boolean(v.kind) && Boolean(v.url)).map((v) => ({
       kind: v.kind,
       url: v.url
     }));
-    const fallback = !variants.length && Array.isArray(vg.resultUrls) && vg.resultUrls.length ? vg.resultUrls.map((url) => ({
+    const fallback = !variants2.length && Array.isArray(vg.resultUrls) && vg.resultUrls.length ? vg.resultUrls.map((url) => ({
       kind: "mp4",
       url
     })) : [];
     return {
       angleKey: vg.angleKey ?? "",
       angleIndex: vg.angleIndex ?? 0,
-      variants: variants.length ? variants : fallback
+      variants: variants2.length ? variants2 : fallback
     };
   }).filter((v) => v.angleKey && v.variants.length);
   const sections = (raw.landing?.images ?? []).filter((img) => Boolean(img.role) && Boolean(img.url)).map((img) => ({
@@ -735,18 +755,21 @@ async function fetchTaskOutputs(api, taskId) {
     url: img.url
   }));
   const images = [];
-  if (raw.adCreative?.url) {
+  const variants = raw.adCreative?.variants ?? [];
+  const hasVariants = variants.some((v) => typeof v === "string");
+  if (hasVariants) {
+    for (const variant of variants) {
+      if (typeof variant === "string") images.push({
+        url: variant
+      });
+    }
+  } else if (raw.adCreative?.url) {
     images.push({
       url: raw.adCreative.url,
       width: raw.adCreative.width,
       height: raw.adCreative.height
     });
   }
-  for (const variant of raw.adCreative?.variants ?? []) {
-    if (typeof variant === "string") images.push({
-      url: variant
-    });
-  }
   return {
     webappUrl: `${WEBAPP_BASE}/tasks/${taskId}`,
     videos,
@@ -757,21 +780,24 @@ async function fetchTaskOutputs(api, taskId) {
   };
 }
 __name(fetchTaskOutputs, "fetchTaskOutputs");
-function escapeMdLabel(s) {
-  return s.replace(/[\[\]\(\)\{\}`<>\r\n\\]/g, " ").replace(/\s+/g, " ").trim();
-}
-__name(escapeMdLabel, "escapeMdLabel");
 function renderOutputsMarkdown(outputs) {
   const parts = [];
   parts.push(`\u2705 **Tu tarea est\xE1 lista** \u2014 [Abrir en Product Maker](${outputs.webappUrl})`);
   if (outputs.images.length) {
-    parts.push("\n### Ad creative");
-    for (const img of outputs.images) parts.push(`![](${img.url})`);
+    parts.push(`
+### Ad creative (${outputs.images.length} ${outputs.images.length === 1 ? "variante" : "variantes"})`);
+    outputs.images.forEach((img, i) => {
+      parts.push(`![v${i}](${img.url})`);
+      parts.push(`[\u2B07 Descargar v${i}](${img.url})`);
+    });
   }
   if (outputs.landing.sections.length) {
     parts.push(`
 ### Landing (${outputs.landing.sections.length} secciones)`);
-    for (const s of outputs.landing.sections) parts.push(`![${escapeMdLabel(s.role)}](${s.url})`);
+    for (const s of outputs.landing.sections) {
+      parts.push(`![${escapeMdLabel(s.role)}](${s.url})`);
+      parts.push(`[\u2B07 Descargar ${escapeMdLabel(s.role)}](${s.url})`);
+    }
   }
   if (outputs.videos.length) {
     parts.push("\n### Video");
@@ -794,9 +820,10 @@ var CreateProductTaskInput = z2.object({
   price: z2.string().optional().describe('Precio que se mostrar\xE1 en la landing y video. Formato libre \u2014 ej. "$89.900", "USD 29.99", "MXN 599". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si te dice "t\xFA elige", om\xEDtelo y el backend sugiere uno.'),
   offer: z2.string().optional().describe('Oferta o promoci\xF3n a destacar. Ej. "2x1", "Env\xEDo gratis hoy", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si te dice "t\xFA elige", om\xEDtelo.'),
   videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual del video. "ugc" = creador hablando a c\xE1mara (default, mejor CTR LATAM). "cartoon_3d" = animaci\xF3n 3D. "product_only" = sin actor. "ai_dynamic" = cinematogr\xE1fico AI. Si se omite, default "ugc".'),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" = testimonial (default, alta conversi\xF3n). "problem_product_cta" = problema\u2192soluci\xF3n. "product_showcase" = features. "metaphor_product_cta" = met\xE1fora visual. "wearable_showcase" = para ropa/accesorios. Si se omite, default "review".'),
+  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" = UGC cl\xE1sico multi-hook (default, alta conversi\xF3n). "problem_product_cta" = problema\u2192soluci\xF3n. "product_showcase" = features. "metaphor_product_cta" = met\xE1fora visual. "wearable_showcase" = para ropa/accesorios. "ugc_unboxing_chaos" = unboxing agresivo. "ugc_curiosity_reveal" = hook con producto oculto. "ugc_listicle_3" = 3 razones (30s recomendado). "ugc_skeptic_confession" = esc\xE9ptico\u2192conversi\xF3n (30s recomendado). "ugc_demo_review" = demo en uso a lo largo de d\xEDas. Si se omite, default "review".'),
   videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). "bytedance"/"seedance" = TikTok-style. "kling"/"wan" = alternativos. "infinitalk" = lipsync largo. "grok" = grok-imagine. Si se omite, el sistema escoge seg\xFAn costo/calidad.'),
   multiAngleVideos: z2.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
+  angleNarratives: NarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). angleNarratives[i] fuerza la narrativa del \xE1ngulo en la posici\xF3n i; usa los mismos valores que narrativeStyle. Si la lista es m\xE1s corta que la cantidad de \xE1ngulos, las posiciones restantes las elige la IA. Ej: ["animated_problem_pixar","review","ugc_skeptic_confession"] para 3 \xE1ngulos distintos. Requiere multiAngleVideos:true (o videoAngleCount>1) para que haya varios \xE1ngulos. Si se omite, todas las narrativas se auto-seleccionan.'),
   outputs: z2.array(z2.enum([
     "landing",
     "video",
@@ -843,6 +870,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         "options.offer": input.offer,
         "options.videoStyle": input.videoStyle,
         "options.narrativeStyle": input.narrativeStyle,
+        "options.angleNarratives": input.angleNarratives,
         "options.videoModel": input.videoModel,
         "options.multiAngleVideos": input.multiAngleVideos,
         "options.selectedOutputs": input.outputs,
@@ -943,7 +971,7 @@ var VideoInput = z3.object({
     "Auto"
   ]).describe('Relaci\xF3n de aspecto. "9:16" = vertical (TikTok/Reels \u2014 default recomendado para ads). "16:9" = horizontal (YouTube). "Auto" = decide la IA.'),
   durationSeconds: z3.number().int().min(5).max(60).optional().describe("Opcional. Duraci\xF3n del video en segundos (5-60). Default 15s. Para hooks cortos usa 8, para storytelling usa 30."),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" (testimonial, default), "problem_product_cta", "product_showcase", "metaphor_product_cta", "wearable_showcase".'),
+  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" (UGC cl\xE1sico multi-hook, default), "problem_product_cta", "product_showcase", "metaphor_product_cta", "wearable_showcase", "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones numeradas, recomendado 30s), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n, recomendado 30s), "ugc_demo_review" (demo en uso a lo largo de d\xEDas).'),
   videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual. "ugc" (creador hablando, default), "cartoon_3d", "product_only", "ai_dynamic".'),
   videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). Ver lista de valores v\xE1lidos.'),
   features: z3.array(z3.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
@@ -1049,6 +1077,14 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
+  server.tool("list_tiktok_advertisers", "Lista las cuentas de TikTok Ads conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z4.object({}).shape, async () => {
+    try {
+      const r = await api.getJson("/v1/tiktok/advertisers");
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
 }
 __name(registerConnectionTools, "registerConnectionTools");
 
@@ -1059,14 +1095,38 @@ var ShopifyInput = z5.object({
   shopDomain: z5.string().min(1),
   numLandingImages: z5.number().int().min(1).max(7).optional(),
   variantIndex: z5.number().int().min(0).optional(),
+  /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
+  *  When true, the landing renders variant-picker pills; when false, it ships
+  *  a single-option product page. Defaults to false. */
   showVariantPicker: z5.boolean().optional()
 });
+var McpCampaignConfig = z5.object({
+  dailyBudgetUsd: z5.number().positive().optional(),
+  /** ISO-3166-1 alpha-2 country codes. Meta accepts max 1 (single-country
+  *  ad set). TikTok takes only the first entry. */
+  targetCountries: z5.array(z5.string().length(2)).max(1).optional(),
+  campaignName: z5.string().trim().min(1).max(100).optional()
+});
 var MetaInput = z5.object({
   taskId: z5.string().min(1),
-  adAccountId: z5.string().min(1)
+  adAccountId: z5.string().min(1),
+  pixelId: z5.string().min(1).optional(),
+  landingUrl: z5.string().url().optional(),
+  /** Select which angles to publish by 0-based index. Omit to publish all
+  *  successful angles. Example: a task with 3 angles → `[0,2]` publishes #0 + #2. */
+  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+  campaignConfig: McpCampaignConfig.optional()
+});
+var TikTokInput = z5.object({
+  taskId: z5.string().min(1),
+  advertiserId: z5.string().min(1),
+  pixelId: z5.string().min(1).optional(),
+  landingUrl: z5.string().url().optional(),
+  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+  campaignConfig: McpCampaignConfig.optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete'. Use `get_task_status` antes para verificar. Por defecto incluye 3 im\xE1genes de landing del hero.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto incluye 3 im\xE1genes del hero. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
       const numImages = input.numLandingImages ?? 3;
       const variantIndex = input.variantIndex ?? 0;
@@ -1081,16 +1141,37 @@ function registerPublishTools(server, api) {
         selectedLandingImages,
         showVariantPicker: input.showVariantPicker
       });
-      return asText(r);
+      return renderShopifyPublishMarkdown(r);
     } catch (e) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario debe activarla manualmente desde Meta Ads Manager, donde tambi\xE9n puede ajustar presupuesto, targeting y nombre de campa\xF1a. Use `list_meta_ad_accounts` antes para obtener un adAccountId v\xE1lido.", MetaInput.shape, async (input) => {
+  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", MetaInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
     try {
-      const r = await api.postJson(`/v1/facebook/campaigns/from-task/${encodeURIComponent(input.taskId)}`, {
-        adAccountId: input.adAccountId
+      const body = {
+        ...rest
+      };
+      if (campaignConfig) {
+        body.campaignOverrides = toMetaCampaignOverrides(campaignConfig);
+      }
+      const r = await api.postJson(`/v1/facebook/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
+      return asText({
+        ...r,
+        status: "PAUSED"
       });
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
+    try {
+      const body = {
+        ...rest
+      };
+      if (campaignConfig) {
+        body.campaignConfig = toTikTokCampaignConfig(campaignConfig);
+      }
+      const r = await api.postJson(`/v1/tiktok/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
       return asText({
         ...r,
         status: "PAUSED"
@@ -1101,6 +1182,149 @@ function registerPublishTools(server, api) {
   });
 }
 __name(registerPublishTools, "registerPublishTools");
+function renderShopifyPublishMarkdown(r) {
+  const lines = [];
+  const statusEmoji = r.status === "success" ? "\u2705" : r.status === "error" ? "\u274C" : "\u23F3";
+  lines.push(`${statusEmoji} **Publicaci\xF3n en Shopify** \u2014 ${r.shopDomain}`);
+  lines.push(`Estado: \`${r.status}\``);
+  if (r.pageUrl) lines.push(`
+### Landing
+[Ver landing publicada](${r.pageUrl})`);
+  if (r.productUrl) lines.push(`
+### Producto
+[Ver producto](${r.productUrl})`);
+  if (!r.pageUrl && !r.productUrl && r.status !== "success") {
+    lines.push("\n_La publicaci\xF3n a\xFAn est\xE1 proces\xE1ndose. Usa `get_task_status` para verificar progreso._");
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: lines.join("\n")
+      }
+    ]
+  };
+}
+__name(renderShopifyPublishMarkdown, "renderShopifyPublishMarkdown");
+function toMetaCampaignOverrides(cfg) {
+  const out = {};
+  if (cfg.dailyBudgetUsd !== void 0) out.dailyBudgetUsd = cfg.dailyBudgetUsd;
+  if (cfg.targetCountries !== void 0) out.targetCountries = cfg.targetCountries;
+  if (cfg.campaignName !== void 0) out.campaignName = cfg.campaignName;
+  return out;
+}
+__name(toMetaCampaignOverrides, "toMetaCampaignOverrides");
+function toTikTokCampaignConfig(cfg) {
+  const out = {};
+  if (cfg.dailyBudgetUsd !== void 0) out.dailyBudget = Math.round(cfg.dailyBudgetUsd * 100);
+  if (cfg.targetCountries && cfg.targetCountries.length > 0) out.targetCountry = cfg.targetCountries[0];
+  if (cfg.campaignName !== void 0) out.campaignName = cfg.campaignName;
+  return out;
+}
+__name(toTikTokCampaignConfig, "toTikTokCampaignConfig");
+
+// src/tools/campaigns.ts
+import { z as z6 } from "zod";
+var MetaStatusInput = z6.object({
+  campaignId: z6.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
+});
+var TikTokStatusInput = z6.object({
+  campaignId: z6.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
+  advertiserId: z6.string().min(1).describe("The same advertiserId used to publish the campaign.")
+});
+function registerCampaignTools(server, api) {
+  server.tool("get_meta_campaign_status", "Consulta el estado actual + m\xE9tricas lifetime (spend, impressions, clicks, reach) de una campa\xF1a Meta publicada. Llama esto DESPU\xC9S de `publish_to_meta` para confirmar que la campa\xF1a se cre\xF3 correctamente y para reportar performance al usuario. Es read-only \u2014 no modifica nada en Meta Ads Manager.", MetaStatusInput.shape, async (input) => {
+    try {
+      const r = await api.getJson(`/v1/facebook/campaigns/${encodeURIComponent(input.campaignId)}`);
+      return renderMetaStatusMarkdown(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("get_tiktok_campaign_status", "Consulta el estado actual + reporte lifetime (spend, impressions, clicks, reach) de una campa\xF1a TikTok publicada. Requiere `advertiserId` (el mismo con el que se cre\xF3). Llama esto DESPU\xC9S de `publish_to_tiktok` para confirmar creaci\xF3n correcta y reportar performance. Es read-only.", TikTokStatusInput.shape, async (input) => {
+    try {
+      const r = await api.getJson(`/v1/tiktok/campaigns/${encodeURIComponent(input.campaignId)}?advertiserId=${encodeURIComponent(input.advertiserId)}`);
+      return renderTikTokStatusMarkdown(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+}
+__name(registerCampaignTools, "registerCampaignTools");
+function renderCampaignStatusMarkdown(opts) {
+  const lines = [
+    `\u{1F4CA} **${escapeMdLabel(opts.name)}** (\`${opts.campaignId}\`)`
+  ];
+  for (const [label, value] of opts.statusLines) {
+    lines.push(`- ${label}: \`${value}\``);
+  }
+  if (opts.metrics) {
+    lines.push("\n### M\xE9tricas (lifetime)");
+    lines.push(`- Spend: ${opts.metrics.spend}`);
+    lines.push(`- Impressions: ${opts.metrics.impressions}`);
+    lines.push(`- Clicks: ${opts.metrics.clicks}`);
+    lines.push(`- Reach: ${opts.metrics.reach}`);
+  } else {
+    lines.push(`
+_${opts.noMetricsHint ?? "A\xFAn no hay m\xE9tricas reportadas."}_`);
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: lines.join("\n")
+      }
+    ]
+  };
+}
+__name(renderCampaignStatusMarkdown, "renderCampaignStatusMarkdown");
+function renderMetaStatusMarkdown(r) {
+  const statusLines = [
+    [
+      "Estado efectivo",
+      r.effectiveStatus
+    ],
+    [
+      "Estado configurado",
+      r.configuredStatus
+    ]
+  ];
+  if (r.objective) statusLines.push([
+    "Objetivo",
+    r.objective
+  ]);
+  return renderCampaignStatusMarkdown({
+    name: r.name,
+    campaignId: r.campaignId,
+    statusLines,
+    metrics: r.insights,
+    noMetricsHint: "A\xFAn no hay m\xE9tricas reportadas (la campa\xF1a puede estar pausada o sin entregar)."
+  });
+}
+__name(renderMetaStatusMarkdown, "renderMetaStatusMarkdown");
+function renderTikTokStatusMarkdown(r) {
+  const statusLines = [
+    [
+      "Estado de operaci\xF3n",
+      r.operationStatus
+    ]
+  ];
+  if (r.secondaryStatus) statusLines.push([
+    "Estado secundario",
+    r.secondaryStatus
+  ]);
+  if (r.objectiveType) statusLines.push([
+    "Objetivo",
+    r.objectiveType
+  ]);
+  return renderCampaignStatusMarkdown({
+    name: r.name,
+    campaignId: r.campaignId,
+    statusLines,
+    metrics: r.report
+  });
+}
+__name(renderTikTokStatusMarkdown, "renderTikTokStatusMarkdown");
 
 // src/server.ts
 function createServer(opts) {
@@ -1126,6 +1350,7 @@ function createServer(opts) {
   });
   registerConnectionTools(server, api);
   registerPublishTools(server, api);
+  registerCampaignTools(server, api);
   return server;
 }
 __name(createServer, "createServer");

package/dist/stdio.js

@@ -110,7 +110,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "0.2.0";
+var MCP_VERSION = "0.3.0";
 
 // src/tools/tasks.ts
 import { z as z2 } from "zod";
@@ -402,10 +402,12 @@ var McpErrorCode = {
   PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
   TASK_NOT_FOUND: "TASK_NOT_FOUND",
   TASK_NOT_READY: "TASK_NOT_READY",
+  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
   NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
   NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
   SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
   META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
+  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
   UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
   UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
   INTERNAL: "INTERNAL"
@@ -417,7 +419,11 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.IMAGE_PATH_NOT_FOUND,
   McpErrorCode.IMAGE_PATH_NOT_READABLE,
   McpErrorCode.IMAGE_PATH_NOT_A_FILE,
-  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE
+  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
+  // The caller passed a campaignId that does not exist — semantically a
+  // bad parameter, not an internal failure. Matches the spec contract
+  // (mcp-server.spec.ts: "McpError INVALID_PARAMS code=CAMPAIGN_NOT_FOUND").
+  McpErrorCode.CAMPAIGN_NOT_FOUND
 ]);
 function mcp(code, message, extra = {}) {
   const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
@@ -432,7 +438,9 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   "NO_SHOPIFY_SHOPS",
   "NO_META_AD_ACCOUNTS",
   "SHOPIFY_NOT_CONNECTED",
-  "REVOKED_API_KEY"
+  "TIKTOK_NOT_CONNECTED",
+  "REVOKED_API_KEY",
+  "CAMPAIGN_NOT_FOUND"
 ]);
 function isRecord(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
@@ -496,7 +504,14 @@ var NarrativeStyleEnum = z.enum([
   "problem_product_cta",
   "product_showcase",
   "metaphor_product_cta",
-  "wearable_showcase"
+  "wearable_showcase",
+  "animated_problem_pixar",
+  "sassy_product_pixar",
+  "ugc_unboxing_chaos",
+  "ugc_curiosity_reveal",
+  "ugc_listicle_3",
+  "ugc_skeptic_confession",
+  "ugc_demo_review"
 ]);
 var VideoModelEnum = z.enum([
   "veo",
@@ -550,6 +565,10 @@ function asText(value) {
   };
 }
 __name(asText, "asText");
+function escapeMdLabel(s) {
+  return s.replace(/[\[\]\(\)\{\}`<>\r\n\\*_]/g, " ").replace(/\s+/g, " ").trim();
+}
+__name(escapeMdLabel, "escapeMdLabel");
 function flatten(obj) {
   const out = {};
   for (const [k, v] of Object.entries(obj)) {
@@ -573,8 +592,9 @@ async function submitCreative(api, opts) {
   const r = await api.postMultipart(opts.path, {
     images: parts
   }, flatten(rest));
+  const taskId = r.taskId ?? r.jobId;
   return asText({
-    taskId: r.taskId,
+    taskId,
     status: "queued",
     estimatedSeconds: opts.estimatedSeconds
   });
@@ -672,18 +692,18 @@ __name(sanitizeFilename, "sanitizeFilename");
 async function fetchTaskOutputs(api, taskId) {
   const raw = await api.getJson(`/v1/results/${encodeURIComponent(taskId)}?signedUrls=true`);
   const videos = (raw.videoGenerators ?? []).map((vg) => {
-    const variants = (vg.variants ?? []).filter((v) => Boolean(v.kind) && Boolean(v.url)).map((v) => ({
+    const variants2 = (vg.variants ?? []).filter((v) => Boolean(v.kind) && Boolean(v.url)).map((v) => ({
       kind: v.kind,
       url: v.url
     }));
-    const fallback = !variants.length && Array.isArray(vg.resultUrls) && vg.resultUrls.length ? vg.resultUrls.map((url) => ({
+    const fallback = !variants2.length && Array.isArray(vg.resultUrls) && vg.resultUrls.length ? vg.resultUrls.map((url) => ({
       kind: "mp4",
       url
     })) : [];
     return {
       angleKey: vg.angleKey ?? "",
       angleIndex: vg.angleIndex ?? 0,
-      variants: variants.length ? variants : fallback
+      variants: variants2.length ? variants2 : fallback
     };
   }).filter((v) => v.angleKey && v.variants.length);
   const sections = (raw.landing?.images ?? []).filter((img) => Boolean(img.role) && Boolean(img.url)).map((img) => ({
@@ -691,18 +711,21 @@ async function fetchTaskOutputs(api, taskId) {
     url: img.url
   }));
   const images = [];
-  if (raw.adCreative?.url) {
+  const variants = raw.adCreative?.variants ?? [];
+  const hasVariants = variants.some((v) => typeof v === "string");
+  if (hasVariants) {
+    for (const variant of variants) {
+      if (typeof variant === "string") images.push({
+        url: variant
+      });
+    }
+  } else if (raw.adCreative?.url) {
     images.push({
       url: raw.adCreative.url,
       width: raw.adCreative.width,
       height: raw.adCreative.height
     });
   }
-  for (const variant of raw.adCreative?.variants ?? []) {
-    if (typeof variant === "string") images.push({
-      url: variant
-    });
-  }
   return {
     webappUrl: `${WEBAPP_BASE}/tasks/${taskId}`,
     videos,
@@ -713,21 +736,24 @@ async function fetchTaskOutputs(api, taskId) {
   };
 }
 __name(fetchTaskOutputs, "fetchTaskOutputs");
-function escapeMdLabel(s) {
-  return s.replace(/[\[\]\(\)\{\}`<>\r\n\\]/g, " ").replace(/\s+/g, " ").trim();
-}
-__name(escapeMdLabel, "escapeMdLabel");
 function renderOutputsMarkdown(outputs) {
   const parts = [];
   parts.push(`\u2705 **Tu tarea est\xE1 lista** \u2014 [Abrir en Product Maker](${outputs.webappUrl})`);
   if (outputs.images.length) {
-    parts.push("\n### Ad creative");
-    for (const img of outputs.images) parts.push(`![](${img.url})`);
+    parts.push(`
+### Ad creative (${outputs.images.length} ${outputs.images.length === 1 ? "variante" : "variantes"})`);
+    outputs.images.forEach((img, i) => {
+      parts.push(`![v${i}](${img.url})`);
+      parts.push(`[\u2B07 Descargar v${i}](${img.url})`);
+    });
   }
   if (outputs.landing.sections.length) {
     parts.push(`
 ### Landing (${outputs.landing.sections.length} secciones)`);
-    for (const s of outputs.landing.sections) parts.push(`![${escapeMdLabel(s.role)}](${s.url})`);
+    for (const s of outputs.landing.sections) {
+      parts.push(`![${escapeMdLabel(s.role)}](${s.url})`);
+      parts.push(`[\u2B07 Descargar ${escapeMdLabel(s.role)}](${s.url})`);
+    }
   }
   if (outputs.videos.length) {
     parts.push("\n### Video");
@@ -750,9 +776,10 @@ var CreateProductTaskInput = z2.object({
   price: z2.string().optional().describe('Precio que se mostrar\xE1 en la landing y video. Formato libre \u2014 ej. "$89.900", "USD 29.99", "MXN 599". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si te dice "t\xFA elige", om\xEDtelo y el backend sugiere uno.'),
   offer: z2.string().optional().describe('Oferta o promoci\xF3n a destacar. Ej. "2x1", "Env\xEDo gratis hoy", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si te dice "t\xFA elige", om\xEDtelo.'),
   videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual del video. "ugc" = creador hablando a c\xE1mara (default, mejor CTR LATAM). "cartoon_3d" = animaci\xF3n 3D. "product_only" = sin actor. "ai_dynamic" = cinematogr\xE1fico AI. Si se omite, default "ugc".'),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" = testimonial (default, alta conversi\xF3n). "problem_product_cta" = problema\u2192soluci\xF3n. "product_showcase" = features. "metaphor_product_cta" = met\xE1fora visual. "wearable_showcase" = para ropa/accesorios. Si se omite, default "review".'),
+  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" = UGC cl\xE1sico multi-hook (default, alta conversi\xF3n). "problem_product_cta" = problema\u2192soluci\xF3n. "product_showcase" = features. "metaphor_product_cta" = met\xE1fora visual. "wearable_showcase" = para ropa/accesorios. "ugc_unboxing_chaos" = unboxing agresivo. "ugc_curiosity_reveal" = hook con producto oculto. "ugc_listicle_3" = 3 razones (30s recomendado). "ugc_skeptic_confession" = esc\xE9ptico\u2192conversi\xF3n (30s recomendado). "ugc_demo_review" = demo en uso a lo largo de d\xEDas. Si se omite, default "review".'),
   videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). "bytedance"/"seedance" = TikTok-style. "kling"/"wan" = alternativos. "infinitalk" = lipsync largo. "grok" = grok-imagine. Si se omite, el sistema escoge seg\xFAn costo/calidad.'),
   multiAngleVideos: z2.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
+  angleNarratives: NarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). angleNarratives[i] fuerza la narrativa del \xE1ngulo en la posici\xF3n i; usa los mismos valores que narrativeStyle. Si la lista es m\xE1s corta que la cantidad de \xE1ngulos, las posiciones restantes las elige la IA. Ej: ["animated_problem_pixar","review","ugc_skeptic_confession"] para 3 \xE1ngulos distintos. Requiere multiAngleVideos:true (o videoAngleCount>1) para que haya varios \xE1ngulos. Si se omite, todas las narrativas se auto-seleccionan.'),
   outputs: z2.array(z2.enum([
     "landing",
     "video",
@@ -799,6 +826,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         "options.offer": input.offer,
         "options.videoStyle": input.videoStyle,
         "options.narrativeStyle": input.narrativeStyle,
+        "options.angleNarratives": input.angleNarratives,
         "options.videoModel": input.videoModel,
         "options.multiAngleVideos": input.multiAngleVideos,
         "options.selectedOutputs": input.outputs,
@@ -899,7 +927,7 @@ var VideoInput = z3.object({
     "Auto"
   ]).describe('Relaci\xF3n de aspecto. "9:16" = vertical (TikTok/Reels \u2014 default recomendado para ads). "16:9" = horizontal (YouTube). "Auto" = decide la IA.'),
   durationSeconds: z3.number().int().min(5).max(60).optional().describe("Opcional. Duraci\xF3n del video en segundos (5-60). Default 15s. Para hooks cortos usa 8, para storytelling usa 30."),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" (testimonial, default), "problem_product_cta", "product_showcase", "metaphor_product_cta", "wearable_showcase".'),
+  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" (UGC cl\xE1sico multi-hook, default), "problem_product_cta", "product_showcase", "metaphor_product_cta", "wearable_showcase", "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones numeradas, recomendado 30s), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n, recomendado 30s), "ugc_demo_review" (demo en uso a lo largo de d\xEDas).'),
   videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual. "ugc" (creador hablando, default), "cartoon_3d", "product_only", "ai_dynamic".'),
   videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). Ver lista de valores v\xE1lidos.'),
   features: z3.array(z3.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
@@ -1005,6 +1033,14 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
+  server.tool("list_tiktok_advertisers", "Lista las cuentas de TikTok Ads conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z4.object({}).shape, async () => {
+    try {
+      const r = await api.getJson("/v1/tiktok/advertisers");
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
 }
 __name(registerConnectionTools, "registerConnectionTools");
 
@@ -1015,14 +1051,38 @@ var ShopifyInput = z5.object({
   shopDomain: z5.string().min(1),
   numLandingImages: z5.number().int().min(1).max(7).optional(),
   variantIndex: z5.number().int().min(0).optional(),
+  /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
+  *  When true, the landing renders variant-picker pills; when false, it ships
+  *  a single-option product page. Defaults to false. */
   showVariantPicker: z5.boolean().optional()
 });
+var McpCampaignConfig = z5.object({
+  dailyBudgetUsd: z5.number().positive().optional(),
+  /** ISO-3166-1 alpha-2 country codes. Meta accepts max 1 (single-country
+  *  ad set). TikTok takes only the first entry. */
+  targetCountries: z5.array(z5.string().length(2)).max(1).optional(),
+  campaignName: z5.string().trim().min(1).max(100).optional()
+});
 var MetaInput = z5.object({
   taskId: z5.string().min(1),
-  adAccountId: z5.string().min(1)
+  adAccountId: z5.string().min(1),
+  pixelId: z5.string().min(1).optional(),
+  landingUrl: z5.string().url().optional(),
+  /** Select which angles to publish by 0-based index. Omit to publish all
+  *  successful angles. Example: a task with 3 angles → `[0,2]` publishes #0 + #2. */
+  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+  campaignConfig: McpCampaignConfig.optional()
+});
+var TikTokInput = z5.object({
+  taskId: z5.string().min(1),
+  advertiserId: z5.string().min(1),
+  pixelId: z5.string().min(1).optional(),
+  landingUrl: z5.string().url().optional(),
+  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+  campaignConfig: McpCampaignConfig.optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete'. Use `get_task_status` antes para verificar. Por defecto incluye 3 im\xE1genes de landing del hero.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto incluye 3 im\xE1genes del hero. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
       const numImages = input.numLandingImages ?? 3;
       const variantIndex = input.variantIndex ?? 0;
@@ -1037,16 +1097,37 @@ function registerPublishTools(server, api) {
         selectedLandingImages,
         showVariantPicker: input.showVariantPicker
       });
-      return asText(r);
+      return renderShopifyPublishMarkdown(r);
     } catch (e) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario debe activarla manualmente desde Meta Ads Manager, donde tambi\xE9n puede ajustar presupuesto, targeting y nombre de campa\xF1a. Use `list_meta_ad_accounts` antes para obtener un adAccountId v\xE1lido.", MetaInput.shape, async (input) => {
+  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", MetaInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
     try {
-      const r = await api.postJson(`/v1/facebook/campaigns/from-task/${encodeURIComponent(input.taskId)}`, {
-        adAccountId: input.adAccountId
+      const body = {
+        ...rest
+      };
+      if (campaignConfig) {
+        body.campaignOverrides = toMetaCampaignOverrides(campaignConfig);
+      }
+      const r = await api.postJson(`/v1/facebook/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
+      return asText({
+        ...r,
+        status: "PAUSED"
       });
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
+    try {
+      const body = {
+        ...rest
+      };
+      if (campaignConfig) {
+        body.campaignConfig = toTikTokCampaignConfig(campaignConfig);
+      }
+      const r = await api.postJson(`/v1/tiktok/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
       return asText({
         ...r,
         status: "PAUSED"
@@ -1057,6 +1138,149 @@ function registerPublishTools(server, api) {
   });
 }
 __name(registerPublishTools, "registerPublishTools");
+function renderShopifyPublishMarkdown(r) {
+  const lines = [];
+  const statusEmoji = r.status === "success" ? "\u2705" : r.status === "error" ? "\u274C" : "\u23F3";
+  lines.push(`${statusEmoji} **Publicaci\xF3n en Shopify** \u2014 ${r.shopDomain}`);
+  lines.push(`Estado: \`${r.status}\``);
+  if (r.pageUrl) lines.push(`
+### Landing
+[Ver landing publicada](${r.pageUrl})`);
+  if (r.productUrl) lines.push(`
+### Producto
+[Ver producto](${r.productUrl})`);
+  if (!r.pageUrl && !r.productUrl && r.status !== "success") {
+    lines.push("\n_La publicaci\xF3n a\xFAn est\xE1 proces\xE1ndose. Usa `get_task_status` para verificar progreso._");
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: lines.join("\n")
+      }
+    ]
+  };
+}
+__name(renderShopifyPublishMarkdown, "renderShopifyPublishMarkdown");
+function toMetaCampaignOverrides(cfg) {
+  const out = {};
+  if (cfg.dailyBudgetUsd !== void 0) out.dailyBudgetUsd = cfg.dailyBudgetUsd;
+  if (cfg.targetCountries !== void 0) out.targetCountries = cfg.targetCountries;
+  if (cfg.campaignName !== void 0) out.campaignName = cfg.campaignName;
+  return out;
+}
+__name(toMetaCampaignOverrides, "toMetaCampaignOverrides");
+function toTikTokCampaignConfig(cfg) {
+  const out = {};
+  if (cfg.dailyBudgetUsd !== void 0) out.dailyBudget = Math.round(cfg.dailyBudgetUsd * 100);
+  if (cfg.targetCountries && cfg.targetCountries.length > 0) out.targetCountry = cfg.targetCountries[0];
+  if (cfg.campaignName !== void 0) out.campaignName = cfg.campaignName;
+  return out;
+}
+__name(toTikTokCampaignConfig, "toTikTokCampaignConfig");
+
+// src/tools/campaigns.ts
+import { z as z6 } from "zod";
+var MetaStatusInput = z6.object({
+  campaignId: z6.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
+});
+var TikTokStatusInput = z6.object({
+  campaignId: z6.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
+  advertiserId: z6.string().min(1).describe("The same advertiserId used to publish the campaign.")
+});
+function registerCampaignTools(server, api) {
+  server.tool("get_meta_campaign_status", "Consulta el estado actual + m\xE9tricas lifetime (spend, impressions, clicks, reach) de una campa\xF1a Meta publicada. Llama esto DESPU\xC9S de `publish_to_meta` para confirmar que la campa\xF1a se cre\xF3 correctamente y para reportar performance al usuario. Es read-only \u2014 no modifica nada en Meta Ads Manager.", MetaStatusInput.shape, async (input) => {
+    try {
+      const r = await api.getJson(`/v1/facebook/campaigns/${encodeURIComponent(input.campaignId)}`);
+      return renderMetaStatusMarkdown(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("get_tiktok_campaign_status", "Consulta el estado actual + reporte lifetime (spend, impressions, clicks, reach) de una campa\xF1a TikTok publicada. Requiere `advertiserId` (el mismo con el que se cre\xF3). Llama esto DESPU\xC9S de `publish_to_tiktok` para confirmar creaci\xF3n correcta y reportar performance. Es read-only.", TikTokStatusInput.shape, async (input) => {
+    try {
+      const r = await api.getJson(`/v1/tiktok/campaigns/${encodeURIComponent(input.campaignId)}?advertiserId=${encodeURIComponent(input.advertiserId)}`);
+      return renderTikTokStatusMarkdown(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+}
+__name(registerCampaignTools, "registerCampaignTools");
+function renderCampaignStatusMarkdown(opts) {
+  const lines = [
+    `\u{1F4CA} **${escapeMdLabel(opts.name)}** (\`${opts.campaignId}\`)`
+  ];
+  for (const [label, value] of opts.statusLines) {
+    lines.push(`- ${label}: \`${value}\``);
+  }
+  if (opts.metrics) {
+    lines.push("\n### M\xE9tricas (lifetime)");
+    lines.push(`- Spend: ${opts.metrics.spend}`);
+    lines.push(`- Impressions: ${opts.metrics.impressions}`);
+    lines.push(`- Clicks: ${opts.metrics.clicks}`);
+    lines.push(`- Reach: ${opts.metrics.reach}`);
+  } else {
+    lines.push(`
+_${opts.noMetricsHint ?? "A\xFAn no hay m\xE9tricas reportadas."}_`);
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: lines.join("\n")
+      }
+    ]
+  };
+}
+__name(renderCampaignStatusMarkdown, "renderCampaignStatusMarkdown");
+function renderMetaStatusMarkdown(r) {
+  const statusLines = [
+    [
+      "Estado efectivo",
+      r.effectiveStatus
+    ],
+    [
+      "Estado configurado",
+      r.configuredStatus
+    ]
+  ];
+  if (r.objective) statusLines.push([
+    "Objetivo",
+    r.objective
+  ]);
+  return renderCampaignStatusMarkdown({
+    name: r.name,
+    campaignId: r.campaignId,
+    statusLines,
+    metrics: r.insights,
+    noMetricsHint: "A\xFAn no hay m\xE9tricas reportadas (la campa\xF1a puede estar pausada o sin entregar)."
+  });
+}
+__name(renderMetaStatusMarkdown, "renderMetaStatusMarkdown");
+function renderTikTokStatusMarkdown(r) {
+  const statusLines = [
+    [
+      "Estado de operaci\xF3n",
+      r.operationStatus
+    ]
+  ];
+  if (r.secondaryStatus) statusLines.push([
+    "Estado secundario",
+    r.secondaryStatus
+  ]);
+  if (r.objectiveType) statusLines.push([
+    "Objetivo",
+    r.objectiveType
+  ]);
+  return renderCampaignStatusMarkdown({
+    name: r.name,
+    campaignId: r.campaignId,
+    statusLines,
+    metrics: r.report
+  });
+}
+__name(renderTikTokStatusMarkdown, "renderTikTokStatusMarkdown");
 
 // src/server.ts
 function createServer(opts) {
@@ -1082,6 +1306,7 @@ function createServer(opts) {
   });
   registerConnectionTools(server, api);
   registerPublishTools(server, api);
+  registerCampaignTools(server, api);
   return server;
 }
 __name(createServer, "createServer");

package/package.json

@@ -1,8 +1,42 @@
 {
   "name": "@productmaker/mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "private": false,
+  "description": "Product Maker MCP server — connect Claude Desktop, Claude Code, ChatGPT, or Gemini to Product Maker AI to generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from your AI assistant.",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "claude",
+    "claude-desktop",
+    "claude-code",
+    "chatgpt",
+    "gemini",
+    "anthropic",
+    "openai",
+    "ai",
+    "productmaker",
+    "dropshipping",
+    "ecommerce",
+    "shopify",
+    "meta-ads",
+    "facebook-ads",
+    "tiktok-ads",
+    "ugc",
+    "video-generation",
+    "video-ads",
+    "landing-page",
+    "creative-generation",
+    "ad-creative",
+    "marketing"
+  ],
+  "homepage": "https://productmaker.app/install",
+  "bugs": {
+    "email": "support@productmaker.ai"
+  },
+  "author": "Product Maker AI <support@productmaker.ai> (https://productmaker.app)",
+  "license": "MIT",
   "bin": {
     "productmaker-mcp": "./dist/stdio.js"
   },