@productmaker/mcp 5.0.0 → 6.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 +42 -39
- package/dist/http.js +1446 -696
- package/dist/stdio.js +1437 -687
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -110,45 +110,48 @@ credential flow; loading the skill alone does not prove that the remote endpoint
|
|
|
110
110
|
is authorized. Public OpenAI/“With MCP” registration and OAuth readiness are a
|
|
111
111
|
separate release step.
|
|
112
112
|
|
|
113
|
-
| Tool | What it does
|
|
114
|
-
| ---------------------------- |
|
|
115
|
-
| `cost_product` | Estimate a safe Colombia/COP selling price for free, then reuse its `price` and `compareAtPrice` in `create_product_task`
|
|
116
|
-
| `create_product_task` | Full pipeline from a product image (extract → angles → video → landing → image creatives)
|
|
117
|
-
| `get_task_status` | Check task progress (optional `waitSeconds` for near-sync polling)
|
|
118
|
-
| `list_tasks` | List recent tasks
|
|
119
|
-
| `edit_task_draft` | Edit angle / pain point / persona before generation
|
|
120
|
-
| `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`
|
|
121
|
-
| `generate_video_creative` | Standalone UGC video creative
|
|
122
|
-
| `generate_free_video` | One free-form video from an exact prompt/script, optionally with a reference image (async: returns a `taskId`)
|
|
123
|
-
| `generate_image_creatives` | Standalone image creatives (multiple variants)
|
|
124
|
-
| `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`
|
|
125
|
-
| `generate_landing` | Standalone landing page
|
|
126
|
-
| `get_video_script` | Read the pending video script when a task was created with script review paused (returns scenes + per-scene word limits)
|
|
127
|
-
| `approve_video_script` | Approve the video script (with optional per-scene edits); render starts and consumes credits
|
|
128
|
-
| `regenerate_video_script` | Re-roll the pending video script (optionally with a different narrative style)
|
|
129
|
-
| `resolve_pending_action` | Resolve a gate the pipeline is waiting on (product-reference confirmation or angle-review approval) when `get_task_status` returns `pendingUserAction`
|
|
130
|
-
| `estimate_creative_variant` | Free estimate of the credit range for an extra video / image / landing section inside an existing task. Call this first
|
|
131
|
-
| `create_creative_variant` | Create that extra creative in an existing task. **Paid action** — requires `confirm: true` plus an idempotent `clientRequestId`
|
|
132
|
-
| `list_shopify_shops` | List connected Shopify stores
|
|
133
|
-
| `list_shopify_products` | Search products in a connected Shopify store before choosing `targetProductId` for `publish_to_shopify`
|
|
134
|
-
| `list_meta_ad_accounts` | List connected Meta ad accounts
|
|
135
|
-
| `list_meta_destinations` | List Meta Business portfolios, ad accounts per portfolio, and Facebook Pages; use the returned IDs to choose the exact publication destination
|
|
136
|
-
| `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
|
|
137
|
-
| `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
|
|
138
|
-
| `list_tiktok_advertisers` | List connected TikTok Ads advertiser accounts
|
|
139
|
-
| `publish_to_shopify` | Publish a completed task to a Shopify store (returns markdown with landing + product URLs)
|
|
140
|
-
| `publish_to_meta` | Create a Meta Ads campaign from a task (always PAUSED) after selecting exact `portfolioId`, `adAccountId`, and `pageId` with `list_meta_destinations`
|
|
141
|
-
| `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
|
|
142
|
-
| `publish_to_tiktok` | Create a TikTok Ads campaign from a task (always created PAUSED). Same `angleIndexes` + `campaignConfig` shape as Meta
|
|
143
|
-
| `get_meta_campaign_status` | Read-only status + lifetime insights (spend/impressions/clicks/reach) of a Meta campaign
|
|
144
|
-
| `get_tiktok_campaign_status` | Read-only status + lifetime report of a TikTok campaign (requires `advertiserId`)
|
|
145
|
-
| `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
|
|
146
|
-
| `get_product_research_run` | Read the full report (score, verdict, confidence, reasons, risks, ad evidence) of a research run by `runId`. Free
|
|
147
|
-
| `list_product_research_runs` | List the user's past research runs, most recent first. Free
|
|
148
|
-
| `start_dropshipping_project` | Start or resume a guided dropshipping project. Idempotent, costs no credits
|
|
149
|
-
| `cost_dropshipping_project` | Save the project's costing inputs (the backend recomputes the canonical result and owns versioning)
|
|
150
|
-
| `guide_dropshipping_launch` | Read-only launch guidance: the project's phase and the single computed `nextAction`. Never activates Meta
|
|
151
|
-
| `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
|
|
113
|
+
| Tool | What it does |
|
|
114
|
+
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
115
|
+
| `cost_product` | Estimate a safe Colombia/COP selling price for free, then reuse its `price` and `compareAtPrice` in `create_product_task` |
|
|
116
|
+
| `create_product_task` | Full pipeline from a product image (extract → angles → video → landing → image creatives) |
|
|
117
|
+
| `get_task_status` | Check task progress (optional `waitSeconds` for near-sync polling) |
|
|
118
|
+
| `list_tasks` | List recent tasks |
|
|
119
|
+
| `edit_task_draft` | Edit angle / pain point / persona before generation |
|
|
120
|
+
| `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` |
|
|
121
|
+
| `generate_video_creative` | Standalone UGC video creative |
|
|
122
|
+
| `generate_free_video` | One free-form video from an exact prompt/script, optionally with a reference image (async: returns a `taskId`) |
|
|
123
|
+
| `generate_image_creatives` | Standalone image creatives (multiple variants) |
|
|
124
|
+
| `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` |
|
|
125
|
+
| `generate_landing` | Standalone landing page |
|
|
126
|
+
| `get_video_script` | Read the pending video script when a task was created with script review paused (returns scenes + per-scene word limits) |
|
|
127
|
+
| `approve_video_script` | Approve the video script (with optional per-scene edits); render starts and consumes credits |
|
|
128
|
+
| `regenerate_video_script` | Re-roll the pending video script (optionally with a different narrative style) |
|
|
129
|
+
| `resolve_pending_action` | Resolve a gate the pipeline is waiting on (product-reference confirmation or angle-review approval) when `get_task_status` returns `pendingUserAction` |
|
|
130
|
+
| `estimate_creative_variant` | Free estimate of the credit range for an extra video / image / landing section inside an existing task. Call this first |
|
|
131
|
+
| `create_creative_variant` | Create that extra creative in an existing task. **Paid action** — requires `confirm: true` plus an idempotent `clientRequestId` |
|
|
132
|
+
| `list_shopify_shops` | List connected Shopify stores |
|
|
133
|
+
| `list_shopify_products` | Search products in a connected Shopify store before choosing `targetProductId` for `publish_to_shopify` |
|
|
134
|
+
| `list_meta_ad_accounts` | List connected Meta ad accounts |
|
|
135
|
+
| `list_meta_destinations` | List Meta Business portfolios, ad accounts per portfolio, and Facebook Pages; use the returned IDs to choose the exact publication destination |
|
|
136
|
+
| `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 |
|
|
137
|
+
| `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 |
|
|
138
|
+
| `list_tiktok_advertisers` | List connected TikTok Ads advertiser accounts |
|
|
139
|
+
| `publish_to_shopify` | Publish a completed task to a Shopify store (returns markdown with landing + product URLs) |
|
|
140
|
+
| `publish_to_meta` | Create a Meta Ads campaign from a task (always PAUSED) after selecting exact `portfolioId`, `adAccountId`, and `pageId` with `list_meta_destinations` |
|
|
141
|
+
| `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 |
|
|
142
|
+
| `publish_to_tiktok` | Create a TikTok Ads campaign from a task (always created PAUSED). Same `angleIndexes` + `campaignConfig` shape as Meta |
|
|
143
|
+
| `get_meta_campaign_status` | Read-only status + lifetime insights (spend/impressions/clicks/reach) of a Meta campaign |
|
|
144
|
+
| `get_tiktok_campaign_status` | Read-only status + lifetime report of a TikTok campaign (requires `advertiserId`) |
|
|
145
|
+
| `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 |
|
|
146
|
+
| `get_product_research_run` | Read the full report (score, verdict, confidence, reasons, risks, ad evidence) of a research run by `runId`. Free |
|
|
147
|
+
| `list_product_research_runs` | List the user's past research runs, most recent first. Free |
|
|
148
|
+
| `start_dropshipping_project` | Start or resume a guided dropshipping project. Idempotent, costs no credits |
|
|
149
|
+
| `cost_dropshipping_project` | Save the project's costing inputs (the backend recomputes the canonical result and owns versioning) |
|
|
150
|
+
| `guide_dropshipping_launch` | Read-only launch guidance: the project's phase and the single computed `nextAction`. Never activates Meta |
|
|
151
|
+
| `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 |
|
|
152
|
+
| `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 |
|
|
153
|
+
| `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 |
|
|
154
|
+
| `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 |
|
|
152
155
|
|
|
153
156
|
### Uploading personal media from a remote chat
|
|
154
157
|
|