@productmaker/mcp 10.3.0 → 11.1.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 +74 -63
- package/dist/http.js +1886 -1611
- package/dist/stdio.js +1875 -1600
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -130,69 +130,80 @@ 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` | **Hidden from the MCP since 9.0.0** (owner decision 2026-10-08, still on WhatsApp): use `create_animated_video` for a service video.
|
|
141
|
-
| `create_animated_video` |
|
|
142
|
-
| `generate_video_creative` | Standalone UGC video creative
|
|
143
|
-
| `generate_free_video` | One free-form video from an exact prompt/script, optionally with a reference image (async: returns a `taskId`)
|
|
144
|
-
| `generate_image_creatives` | Standalone image creatives (multiple variants)
|
|
145
|
-
| `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`
|
|
146
|
-
| `generate_landing` | Standalone landing page
|
|
147
|
-
| `get_video_script` | Read the pending video script when a task was created with script review paused (returns scenes + per-scene word limits)
|
|
148
|
-
| `approve_video_script` | Approve the video script (with optional per-scene edits); render starts and consumes credits
|
|
149
|
-
| `regenerate_video_script` | Re-roll the pending video script (optionally with a different narrative style)
|
|
150
|
-
| `resolve_pending_action` | Resolve a gate the pipeline is waiting on (product-reference confirmation or angle-review approval) when `get_task_status` returns `pendingUserAction`
|
|
151
|
-
| `estimate_creative_variant` | Free estimate of the credit range for an extra video / image / landing section inside an existing task. Call this first
|
|
152
|
-
| `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
|
|
153
|
-
| `create_creative_variant` | Create that extra creative in an existing task. **Paid action** — requires `confirm: true` plus an idempotent `clientRequestId`
|
|
154
|
-
| `list_shopify_shops` | List connected Shopify stores
|
|
155
|
-
| `list_shopify_products` | Search products in a connected Shopify store before choosing `targetProductId` for `publish_to_shopify`
|
|
156
|
-
| `list_meta_ad_accounts` | List connected Meta ad accounts
|
|
157
|
-
| `list_meta_destinations` | List Meta Business portfolios, ad accounts per portfolio, and Facebook Pages; use the returned IDs to choose the exact publication destination
|
|
158
|
-
| `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
|
|
159
|
-
| `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
|
|
160
|
-
| `list_tiktok_advertisers` | List connected TikTok Ads advertiser accounts
|
|
161
|
-
| `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.
|
|
162
|
-
| `verify_landing_commerce` | Free readback of a saved landing edit after manual Shopify/COD corrections; preserves pending provider notices and never changes money, inventory or SKU. Requires the existing taskId and editId and the editor’s current access permissions.
|
|
163
|
-
| `publish_to_meta` | Create a Meta Ads campaign from a task (always PAUSED) after selecting exact `portfolioId`, `adAccountId`, and `pageId` with `list_meta_destinations`
|
|
164
|
-
| `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
|
|
165
|
-
| `publish_to_tiktok` | Create a TikTok Ads campaign from a task (always created PAUSED). Same `angleIndexes` + `campaignConfig` shape as Meta
|
|
166
|
-
| `get_meta_campaign_status` | Read-only status + lifetime insights (spend/impressions/clicks/reach) of a Meta campaign
|
|
167
|
-
| `get_tiktok_campaign_status` | Read-only status + lifetime report of a TikTok campaign (requires `advertiserId`)
|
|
168
|
-
| `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
|
|
169
|
-
| `get_product_research_run` | Read the full report (score, verdict, confidence, reasons, risks, ad evidence) of a research run by `runId`. Free
|
|
170
|
-
| `list_product_research_runs` | List the user's past research runs, most recent first. Free
|
|
171
|
-
| `start_dropshipping_project` | Start or resume a guided dropshipping project. Idempotent, costs no credits
|
|
172
|
-
| `cost_dropshipping_project` | Save the project's costing inputs (the backend recomputes the canonical result and owns versioning)
|
|
173
|
-
| `guide_dropshipping_launch` | Read-only launch guidance: the project's phase and the single computed `nextAction`. Never activates Meta
|
|
174
|
-
| `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
|
|
175
|
-
| `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
|
|
176
|
-
| `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
|
|
177
|
-
| `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
|
|
178
|
-
| `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
|
|
179
|
-
| `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
|
|
180
|
-
| `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
|
|
181
|
-
| `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
|
|
182
|
-
| `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
|
|
183
|
-
| `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`
|
|
184
|
-
| `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
|
|
185
|
-
| `prepare_winning_product_image` | Prepare and show the exact photo of a user-selected winning-product candidate for free; securely stages it before the next photo choice.
|
|
186
|
-
| `get_product_control` | Read-only daily profitability verdicts and measurement status per store product. Incomplete samples or unmeasured delivered sales must remain explicit; never changes campaigns.
|
|
187
|
-
| `list_importable_products` | Read one page of store products eligible for financial control; preserve `hasNextPage` and already-imported markers.
|
|
188
|
-
| `import_product_controls` | Add selected store products to financial control. They remain `no_costing` until their real costs are saved.
|
|
189
|
-
| `set_product_costing` | Save seller-provided supplier cost, freight and estimated cancellation/return rates; store price stays canonical and missing costs cannot be invented.
|
|
190
|
-
| `report_product_counts` | Save only seller-observed daily counts as the final override. Omitted counts remain unmeasured; zero is an explicit observation.
|
|
191
|
-
| `get_actor_voice_capabilities` | Read whether custom voice cloning is enabled for an actor and which countries/presentations the draft may use. Read-only, free — call before `quote_actor_voice`
|
|
192
|
-
| `quote_actor_voice` | Quote the paid custom-voice preview for an actor from a voice `draft` (prompt, country, presentation, tone…). Read-only, free
|
|
193
|
-
| `generate_actor_voice_preview` | Start the paid contextual voice preview for a quoted draft (Gemini TTS reference → voice clone). Requires the fresh `acceptedQuoteId` and a unique `requestKey` for retry safety. Costs credits
|
|
194
|
-
| `get_actor_voice_preview` | Poll a voice preview `candidateId` until it is `ready` and returns the playable preview. Free
|
|
195
|
-
| `approve_actor_voice` | Bind a ready preview candidate as the actor's approved voice. Optimistic-lock: pass `expectedRevision` (candidate) and `expectedApprovedRevision` (current approved voice, or null). Videos using the actor then narrate in this voice
|
|
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` | **Hidden from the MCP since 9.0.0** (owner decision 2026-10-08, still on WhatsApp): use `create_animated_video` for a service video. |
|
|
141
|
+
| `create_animated_video` | Prepare a service URL for free with `action=prepare` (default); poll `status` or `cancel` using `websiteCaptureId`. Show its ready preview, format, duration, language and price range, then request explicit confirmation before `action=generate` with that ID and `confirmed=true`. Generation reuses the capture and may mix motion graphics with AI clips (including people speaking), up to the duration-based clip cap. The maximum price is charged at generation; unused AI clips are refunded at completion, and failure refunds everything. No uploaded files on MCP. Follow the returned `taskId` with `get_task_status` for progress and MP4. A blocked page requires another public URL; never request passwords. |
|
|
142
|
+
| `generate_video_creative` | Standalone UGC video creative |
|
|
143
|
+
| `generate_free_video` | One free-form video from an exact prompt/script, optionally with a reference image (async: returns a `taskId`) |
|
|
144
|
+
| `generate_image_creatives` | Standalone image creatives (multiple variants) |
|
|
145
|
+
| `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` |
|
|
146
|
+
| `generate_landing` | Standalone landing page |
|
|
147
|
+
| `get_video_script` | Read the pending video script when a task was created with script review paused (returns scenes + per-scene word limits) |
|
|
148
|
+
| `approve_video_script` | Approve the video script (with optional per-scene edits); render starts and consumes credits |
|
|
149
|
+
| `regenerate_video_script` | Re-roll the pending video script (optionally with a different narrative style) |
|
|
150
|
+
| `resolve_pending_action` | Resolve a gate the pipeline is waiting on (product-reference confirmation or angle-review approval) when `get_task_status` returns `pendingUserAction` |
|
|
151
|
+
| `estimate_creative_variant` | Free estimate of the credit range for an extra video / image / landing section inside an existing task. Call this first |
|
|
152
|
+
| `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 |
|
|
153
|
+
| `create_creative_variant` | Create that extra creative in an existing task. **Paid action** — requires `confirm: true` plus an idempotent `clientRequestId` |
|
|
154
|
+
| `list_shopify_shops` | List connected Shopify stores |
|
|
155
|
+
| `list_shopify_products` | Search products in a connected Shopify store before choosing `targetProductId` for `publish_to_shopify` |
|
|
156
|
+
| `list_meta_ad_accounts` | List connected Meta ad accounts |
|
|
157
|
+
| `list_meta_destinations` | List Meta Business portfolios, ad accounts per portfolio, and Facebook Pages; use the returned IDs to choose the exact publication destination |
|
|
158
|
+
| `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 |
|
|
159
|
+
| `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 |
|
|
160
|
+
| `list_tiktok_advertisers` | List connected TikTok Ads advertiser accounts |
|
|
161
|
+
| `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. |
|
|
162
|
+
| `verify_landing_commerce` | Free readback of a saved landing edit after manual Shopify/COD corrections; preserves pending provider notices and never changes money, inventory or SKU. Requires the existing taskId and editId and the editor’s current access permissions. |
|
|
163
|
+
| `publish_to_meta` | Create a Meta Ads campaign from a task (always PAUSED) after selecting exact `portfolioId`, `adAccountId`, and `pageId` with `list_meta_destinations` |
|
|
164
|
+
| `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 |
|
|
165
|
+
| `publish_to_tiktok` | Create a TikTok Ads campaign from a task (always created PAUSED). Same `angleIndexes` + `campaignConfig` shape as Meta |
|
|
166
|
+
| `get_meta_campaign_status` | Read-only status + lifetime insights (spend/impressions/clicks/reach) of a Meta campaign |
|
|
167
|
+
| `get_tiktok_campaign_status` | Read-only status + lifetime report of a TikTok campaign (requires `advertiserId`) |
|
|
168
|
+
| `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 |
|
|
169
|
+
| `get_product_research_run` | Read the full report (score, verdict, confidence, reasons, risks, ad evidence) of a research run by `runId`. Free |
|
|
170
|
+
| `list_product_research_runs` | List the user's past research runs, most recent first. Free |
|
|
171
|
+
| `start_dropshipping_project` | Start or resume a guided dropshipping project. Idempotent, costs no credits |
|
|
172
|
+
| `cost_dropshipping_project` | Save the project's costing inputs (the backend recomputes the canonical result and owns versioning) |
|
|
173
|
+
| `guide_dropshipping_launch` | Read-only launch guidance: the project's phase and the single computed `nextAction`. Never activates Meta |
|
|
174
|
+
| `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 |
|
|
175
|
+
| `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 |
|
|
176
|
+
| `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 |
|
|
177
|
+
| `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 |
|
|
178
|
+
| `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 |
|
|
179
|
+
| `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 |
|
|
180
|
+
| `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 |
|
|
181
|
+
| `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 |
|
|
182
|
+
| `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 |
|
|
183
|
+
| `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` |
|
|
184
|
+
| `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 |
|
|
185
|
+
| `prepare_winning_product_image` | Prepare and show the exact photo of a user-selected winning-product candidate for free; securely stages it before the next photo choice. |
|
|
186
|
+
| `get_product_control` | Read-only daily profitability verdicts and measurement status per store product. Incomplete samples or unmeasured delivered sales must remain explicit; never changes campaigns. |
|
|
187
|
+
| `list_importable_products` | Read one page of store products eligible for financial control; preserve `hasNextPage` and already-imported markers. |
|
|
188
|
+
| `import_product_controls` | Add selected store products to financial control. They remain `no_costing` until their real costs are saved. |
|
|
189
|
+
| `set_product_costing` | Save seller-provided supplier cost, freight and estimated cancellation/return rates; store price stays canonical and missing costs cannot be invented. |
|
|
190
|
+
| `report_product_counts` | Save only seller-observed daily counts as the final override. Omitted counts remain unmeasured; zero is an explicit observation. |
|
|
191
|
+
| `get_actor_voice_capabilities` | Read whether custom voice cloning is enabled for an actor and which countries/presentations the draft may use. Read-only, free — call before `quote_actor_voice` |
|
|
192
|
+
| `quote_actor_voice` | Quote the paid custom-voice preview for an actor from a voice `draft` (prompt, country, presentation, tone…). Read-only, free |
|
|
193
|
+
| `generate_actor_voice_preview` | Start the paid contextual voice preview for a quoted draft (Gemini TTS reference → voice clone). Requires the fresh `acceptedQuoteId` and a unique `requestKey` for retry safety. Costs credits |
|
|
194
|
+
| `get_actor_voice_preview` | Poll a voice preview `candidateId` until it is `ready` and returns the playable preview. Free |
|
|
195
|
+
| `approve_actor_voice` | Bind a ready preview candidate as the actor's approved voice. Optimistic-lock: pass `expectedRevision` (candidate) and `expectedApprovedRevision` (current approved voice, or null). Videos using the actor then narrate in this voice |
|
|
196
|
+
|
|
197
|
+
An animated video's capture ID plus its format, duration and language identifies
|
|
198
|
+
one paid generation across retries, including after the capture expires. An optional
|
|
199
|
+
`generationRequestId` UUID distinguishes another video explicitly requested and
|
|
200
|
+
confirmed by the user; preserve that UUID on retries and never rotate it
|
|
201
|
+
automatically after an error. Recover
|
|
202
|
+
a lost receipt using the same capture and choices; the API returns the existing
|
|
203
|
+
task without charging again. Fresh
|
|
204
|
+
unpaid generation still requires a matching, ready, unexpired capture. Ready
|
|
205
|
+
previews use native MCP image content with portable resource/text fallbacks;
|
|
206
|
+
image download failure does not hide the capture receipt.
|
|
196
207
|
|
|
197
208
|
### Uploading personal media from a remote chat
|
|
198
209
|
|