@productmaker/mcp 8.6.0 → 8.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -43
- package/dist/http.js +2651 -2046
- package/dist/stdio.js +2638 -2033
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -130,49 +130,56 @@ credential flow; loading the skill alone does not prove that the remote endpoint
|
|
|
130
130
|
is authorized. Public OpenAI/“With MCP” registration and OAuth readiness are a
|
|
131
131
|
separate release step.
|
|
132
132
|
|
|
133
|
-
| Tool | What it does
|
|
134
|
-
| ---------------------------- |
|
|
135
|
-
| `cost_product` | Estimate a safe Colombia/COP selling price for free, then reuse its `price` and `compareAtPrice` in `create_product_task`
|
|
136
|
-
| `create_product_task` | Full pipeline from a product image (extract → angles → video → landing → image creatives)
|
|
137
|
-
| `get_task_status` | Check task progress (optional `waitSeconds` for near-sync polling)
|
|
138
|
-
| `list_tasks` | List recent tasks
|
|
139
|
-
| `edit_task_draft` | Edit angle / pain point / persona before generation
|
|
140
|
-
| `create_service_video` | Video for a _service_ built from its landing page URL. **Paid action** — `automatic` generates directly, `guided` returns concepts to approve via `resolve_pending_action`
|
|
141
|
-
| `generate_video_creative` | Standalone UGC video creative
|
|
142
|
-
| `generate_free_video` | One free-form video from an exact prompt/script, optionally with a reference image (async: returns a `taskId`)
|
|
143
|
-
| `generate_image_creatives` | Standalone image creatives (multiple variants)
|
|
144
|
-
| `edit_image_creative` | Fix ONE already-generated image of a creatives task (pick it with `variantIndex`, describe the change in `instruction`) without regenerating the whole set. **Paid action** — charges a single image; requires the task to be `done`
|
|
145
|
-
| `generate_landing` | Standalone landing page
|
|
146
|
-
| `get_video_script` | Read the pending video script when a task was created with script review paused (returns scenes + per-scene word limits)
|
|
147
|
-
| `approve_video_script` | Approve the video script (with optional per-scene edits); render starts and consumes credits
|
|
148
|
-
| `regenerate_video_script` | Re-roll the pending video script (optionally with a different narrative style)
|
|
149
|
-
| `resolve_pending_action` | Resolve a gate the pipeline is waiting on (product-reference confirmation or angle-review approval) when `get_task_status` returns `pendingUserAction`
|
|
150
|
-
| `estimate_creative_variant` | Free estimate of the credit range for an extra video / image / landing section inside an existing task. Call this first
|
|
151
|
-
| `estimate_market_study_cost` | Free quote of the same video / combined task WITHOUT and WITH the market study. The study is off unless the user accepts it; call this before asking and show both totals
|
|
152
|
-
| `create_creative_variant` | Create that extra creative in an existing task. **Paid action** — requires `confirm: true` plus an idempotent `clientRequestId`
|
|
153
|
-
| `list_shopify_shops` | List connected Shopify stores
|
|
154
|
-
| `list_shopify_products` | Search products in a connected Shopify store before choosing `targetProductId` for `publish_to_shopify`
|
|
155
|
-
| `list_meta_ad_accounts` | List connected Meta ad accounts
|
|
156
|
-
| `list_meta_destinations` | List Meta Business portfolios, ad accounts per portfolio, and Facebook Pages; use the returned IDs to choose the exact publication destination
|
|
157
|
-
| `request_media_upload` | Open the consumer-neutral inline file picker for ProductMaker tasks, image/video creatives, landings, and Meta; supports image, video, or mixed sessions, ChatGPT file references, an explicit OK chat handoff, and `/upload-media` only as fallback
|
|
158
|
-
| `check_media_upload` | Return verified owner-scoped opaque asset IDs and media kinds from a universal upload session; no bytes, token, file name, or private URL reaches the model
|
|
159
|
-
| `list_tiktok_advertisers` | List connected TikTok Ads advertiser accounts
|
|
160
|
-
| `publish_to_shopify` | Publish a completed task to Shopify; preserves existing calls and returns typed recovery when seller input is required. Optional `commerceCorrection` requires explicit `confirmed: true`. Success includes landing + product URLs.
|
|
161
|
-
| `publish_to_meta` | Create a Meta Ads campaign from a task (always PAUSED) after selecting exact `portfolioId`, `adAccountId`, and `pageId` with `list_meta_destinations`
|
|
162
|
-
| `publish_creatives_to_meta` | Group task creatives or user media into ONE paused Meta campaign; user media is staged on ProductMaker's CDN and removed after successful publication or TTL expiry
|
|
163
|
-
| `publish_to_tiktok` | Create a TikTok Ads campaign from a task (always created PAUSED). Same `angleIndexes` + `campaignConfig` shape as Meta
|
|
164
|
-
| `get_meta_campaign_status` | Read-only status + lifetime insights (spend/impressions/clicks/reach) of a Meta campaign
|
|
165
|
-
| `get_tiktok_campaign_status` | Read-only status + lifetime report of a TikTok campaign (requires `advertiserId`)
|
|
166
|
-
| `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
|
|
167
|
-
| `get_product_research_run` | Read the full report (score, verdict, confidence, reasons, risks, ad evidence) of a research run by `runId`. Free
|
|
168
|
-
| `list_product_research_runs` | List the user's past research runs, most recent first. Free
|
|
169
|
-
| `start_dropshipping_project` | Start or resume a guided dropshipping project. Idempotent, costs no credits
|
|
170
|
-
| `cost_dropshipping_project` | Save the project's costing inputs (the backend recomputes the canonical result and owns versioning)
|
|
171
|
-
| `guide_dropshipping_launch` | Read-only launch guidance: the project's phase and the single computed `nextAction`. Never activates Meta
|
|
172
|
-
| `list_actors` | List the user's saved personajes (AI-generated people who can star in videos and images). Returns the `id` to pass as `actorId`. Read-only, free
|
|
173
|
-
| `get_daily_control` | Read-only daily profitability traffic-light per product (light + verdict). Never pauses/activates ad campaigns. Optional `projectId` narrows the report to one project. A product with `status !== "ok"` has no metrics — including `no_campaign_linked` (no campaign tied to the project, so there is no spend and no cost per sale). Days marked `returnedSource: "estimated"` are not measured; `cancelledSource: "shopify_settling"` is measured but not yet closed
|
|
174
|
-
| `link_campaign_to_project` | Link an ad campaign the user launched outside ProductMaker to a project, so its spend feeds `get_daily_control`. Only associates an identifier — never creates/pauses/activates a real campaign. For Meta the ad account is derived server-side, not taken from the input
|
|
175
|
-
| `report_daily_returns` | Report how many orders of a product were returned on a given day — the one signal ProductMaker cannot see on its own
|
|
133
|
+
| Tool | What it does |
|
|
134
|
+
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
135
|
+
| `cost_product` | Estimate a safe Colombia/COP selling price for free, then reuse its `price` and `compareAtPrice` in `create_product_task` |
|
|
136
|
+
| `create_product_task` | Full pipeline from a product image (extract → angles → video → landing → image creatives) |
|
|
137
|
+
| `get_task_status` | Check task progress (optional `waitSeconds` for near-sync polling) |
|
|
138
|
+
| `list_tasks` | List recent tasks |
|
|
139
|
+
| `edit_task_draft` | Edit angle / pain point / persona before generation |
|
|
140
|
+
| `create_service_video` | Video for a _service_ built from its landing page URL. **Paid action** — `automatic` generates directly, `guided` returns concepts to approve via `resolve_pending_action` |
|
|
141
|
+
| `generate_video_creative` | Standalone UGC video creative |
|
|
142
|
+
| `generate_free_video` | One free-form video from an exact prompt/script, optionally with a reference image (async: returns a `taskId`) |
|
|
143
|
+
| `generate_image_creatives` | Standalone image creatives (multiple variants) |
|
|
144
|
+
| `edit_image_creative` | Fix ONE already-generated image of a creatives task (pick it with `variantIndex`, describe the change in `instruction`) without regenerating the whole set. **Paid action** — charges a single image; requires the task to be `done` |
|
|
145
|
+
| `generate_landing` | Standalone landing page |
|
|
146
|
+
| `get_video_script` | Read the pending video script when a task was created with script review paused (returns scenes + per-scene word limits) |
|
|
147
|
+
| `approve_video_script` | Approve the video script (with optional per-scene edits); render starts and consumes credits |
|
|
148
|
+
| `regenerate_video_script` | Re-roll the pending video script (optionally with a different narrative style) |
|
|
149
|
+
| `resolve_pending_action` | Resolve a gate the pipeline is waiting on (product-reference confirmation or angle-review approval) when `get_task_status` returns `pendingUserAction` |
|
|
150
|
+
| `estimate_creative_variant` | Free estimate of the credit range for an extra video / image / landing section inside an existing task. Call this first |
|
|
151
|
+
| `estimate_market_study_cost` | Free quote of the same video / combined task WITHOUT and WITH the market study. The study is off unless the user accepts it; call this before asking and show both totals |
|
|
152
|
+
| `create_creative_variant` | Create that extra creative in an existing task. **Paid action** — requires `confirm: true` plus an idempotent `clientRequestId` |
|
|
153
|
+
| `list_shopify_shops` | List connected Shopify stores |
|
|
154
|
+
| `list_shopify_products` | Search products in a connected Shopify store before choosing `targetProductId` for `publish_to_shopify` |
|
|
155
|
+
| `list_meta_ad_accounts` | List connected Meta ad accounts |
|
|
156
|
+
| `list_meta_destinations` | List Meta Business portfolios, ad accounts per portfolio, and Facebook Pages; use the returned IDs to choose the exact publication destination |
|
|
157
|
+
| `request_media_upload` | Open the consumer-neutral inline file picker for ProductMaker tasks, image/video creatives, landings, and Meta; supports image, video, or mixed sessions, ChatGPT file references, an explicit OK chat handoff, and `/upload-media` only as fallback |
|
|
158
|
+
| `check_media_upload` | Return verified owner-scoped opaque asset IDs and media kinds from a universal upload session; no bytes, token, file name, or private URL reaches the model |
|
|
159
|
+
| `list_tiktok_advertisers` | List connected TikTok Ads advertiser accounts |
|
|
160
|
+
| `publish_to_shopify` | Publish a completed task to Shopify; preserves existing calls and returns typed recovery when seller input is required. Optional `commerceCorrection` requires explicit `confirmed: true`. Success includes landing + product URLs. |
|
|
161
|
+
| `publish_to_meta` | Create a Meta Ads campaign from a task (always PAUSED) after selecting exact `portfolioId`, `adAccountId`, and `pageId` with `list_meta_destinations` |
|
|
162
|
+
| `publish_creatives_to_meta` | Group task creatives or user media into ONE paused Meta campaign; user media is staged on ProductMaker's CDN and removed after successful publication or TTL expiry |
|
|
163
|
+
| `publish_to_tiktok` | Create a TikTok Ads campaign from a task (always created PAUSED). Same `angleIndexes` + `campaignConfig` shape as Meta |
|
|
164
|
+
| `get_meta_campaign_status` | Read-only status + lifetime insights (spend/impressions/clicks/reach) of a Meta campaign |
|
|
165
|
+
| `get_tiktok_campaign_status` | Read-only status + lifetime report of a TikTok campaign (requires `advertiserId`) |
|
|
166
|
+
| `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 |
|
|
167
|
+
| `get_product_research_run` | Read the full report (score, verdict, confidence, reasons, risks, ad evidence) of a research run by `runId`. Free |
|
|
168
|
+
| `list_product_research_runs` | List the user's past research runs, most recent first. Free |
|
|
169
|
+
| `start_dropshipping_project` | Start or resume a guided dropshipping project. Idempotent, costs no credits |
|
|
170
|
+
| `cost_dropshipping_project` | Save the project's costing inputs (the backend recomputes the canonical result and owns versioning) |
|
|
171
|
+
| `guide_dropshipping_launch` | Read-only launch guidance: the project's phase and the single computed `nextAction`. Never activates Meta |
|
|
172
|
+
| `list_actors` | List the user's saved personajes (AI-generated people who can star in videos and images). Returns the `id` to pass as `actorId`. Read-only, free |
|
|
173
|
+
| `get_daily_control` | Read-only daily profitability traffic-light per product (light + verdict). Never pauses/activates ad campaigns. Optional `projectId` narrows the report to one project. A product with `status !== "ok"` has no metrics — including `no_campaign_linked` (no campaign tied to the project, so there is no spend and no cost per sale). Days marked `returnedSource: "estimated"` are not measured; `cancelledSource: "shopify_settling"` is measured but not yet closed |
|
|
174
|
+
| `link_campaign_to_project` | Link an ad campaign the user launched outside ProductMaker to a project, so its spend feeds `get_daily_control`. Only associates an identifier — never creates/pauses/activates a real campaign. For Meta the ad account is derived server-side, not taken from the input |
|
|
175
|
+
| `report_daily_returns` | Report how many orders of a product were returned on a given day — the one signal ProductMaker cannot see on its own |
|
|
176
|
+
| `sync_shopify_orders` | Pull the store's orders into the ledger as a FOURTH source. It does not replace the provider's report: the store cannot know whether a cash-on-delivery order arrived, so its orders stay in transit unless the money is already collected. Where the provider covered that product on that day, the provider wins. Without dates, from the 1st of the month to today |
|
|
177
|
+
| `import_orders_file` | Read the provider's spreadsheet from an ABSOLUTE path on the caller's machine and store its orders. **stdio only** — on the hosted server a path points at OUR disk, so it fails closed. Start with `dryRun: true` and tell the seller what it contains (how many orders, between which dates, which rows could not be read) before writing anything. No column with buyer data is ever read |
|
|
178
|
+
| `create_operation` | Create the business of one country. The currency is derived from the country, never asked. Needed before anything else about the month: with no operation there is nothing for `get_finances` to assemble. Someone selling in a single country has one and never hears the word again |
|
|
179
|
+
| `merge_products` | Merge two records of the same product into one. The two ids come from `get_product_control` — never invent them. The source DISAPPEARS and its orders move to the target, so confirm by NAME which one stays. It cannot be undone |
|
|
180
|
+
| `get_finances` | Read-only monthly P&L: gross and delivered sales, freight, merchandise cost, gross profit, ad spend, fixed costs and NET profit **before taxes**, plus each rate against its target. Grouped on purpose: a model that needs six calls to answer "how am I doing?" assembles the picture itself between trips, and that is where it invents. `adSpendKnown: false` means ad spend could not be read and the profit is INCOMPLETE; `adSpendSource: "user"` means she corrected it by hand; `unconfirmedExpenses > 0` is inherited from last month and unreviewed. With one operation the server resolves it; with several it returns `operation_ambiguous` with the list |
|
|
181
|
+
| `set_monthly_expense` | Save one FIXED cost of the month (rent, salaries, accountant). Writing the same label again REPLACES the amount — it does not add a second expense. Without fixed costs written, the month's profit always reads HIGHER than it is. Not for ad spend: that is `set_ad_spend` |
|
|
182
|
+
| `set_ad_spend` | Correct by hand what was spent on ads that month. `amount: 0` ASSERTS "I did not advertise"; `null` WITHDRAWS the correction and gives the campaigns back the say. They are not the same |
|
|
176
183
|
|
|
177
184
|
### Uploading personal media from a remote chat
|
|
178
185
|
|
|
@@ -269,6 +276,16 @@ The `base64` field was removed. MCP JSON-RPC transports truncate large tool argu
|
|
|
269
276
|
|
|
270
277
|
## Version history
|
|
271
278
|
|
|
279
|
+
### 8.7.0 — Control financiero en beta cerrada
|
|
280
|
+
|
|
281
|
+
- Operaciones por país, importación de pedidos, sincronización Shopify, gastos fijos, publicidad y P&L usan las mismas rutas canónicas protegidas para administradores y colaboradores beta.
|
|
282
|
+
- Los importes se expresan en unidades mayores de la moneda de la operación y conservan decimales; un costo ausente mantiene la utilidad incompleta.
|
|
283
|
+
- La importación de archivos está disponible solo en stdio, con límite validado antes de decodificar; el catálogo y las anotaciones de publicación están sincronizados.
|
|
284
|
+
|
|
285
|
+
### 8.6.1 — Sin cambios en la superficie MCP
|
|
286
|
+
|
|
287
|
+
- Versión patch de esta rama, sincronizada con ProductMaker; no se agregan herramientas ni cambian esquemas MCP.
|
|
288
|
+
|
|
272
289
|
### 8.6.0 — Narrativas storyteller + estilo de animación
|
|
273
290
|
|
|
274
291
|
- `create_product_task`, `generate_video_creative` y el slot `narrativeStyle` de `resolve_pending_action` aceptan la familia storyteller (`animated_storyteller`, `animated_inner_journey`, `animated_object_soul`, `animated_timeline`) y sus presets animados.
|