@productmaker/mcp 2.3.2 → 2.8.3

package/README.md

@@ -70,9 +70,11 @@ Sign up at [productmaker.app](https://productmaker.app) and create a key (prefix
 | `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 |
+| `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` |
 | `generate_video_creative` | Standalone UGC video creative |
 | `generate_free_video` | One free-form video from an exact prompt/script, optionally with a reference image (async: returns a `taskId`) |
 | `generate_image_creatives` | Standalone image creatives (multiple variants) |
+| `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` |
 | `generate_landing` | Standalone landing page |
 | `get_video_script` | Read the pending video script when a task was created with script review paused (returns scenes + per-scene word limits) |
 | `approve_video_script` | Approve the video script (with optional per-scene edits); render starts and consumes credits |
@@ -83,10 +85,13 @@ Sign up at [productmaker.app](https://productmaker.app) and create a key (prefix
 | `list_shopify_shops` | List connected Shopify stores |
 | `list_shopify_products` | Search products in a connected Shopify store before choosing `targetProductId` for `publish_to_shopify` |
 | `list_meta_ad_accounts` | List connected Meta ad accounts |
+| `list_meta_destinations` | List Meta Business portfolios, ad accounts per portfolio, and Facebook Pages; use the returned IDs to choose the exact publication destination |
+| `request_meta_media_upload` | Create a one-click ProductMaker upload page for up to ten mixed image/video files on the user's laptop; ChatGPT may attach optional `files` references for the UI bridge, but the MCP never downloads them and still uses the secure ProductMaker page |
+| `check_meta_media_upload` | Check whether the user finished the browser upload and return every owner-scoped staged asset with its media kind |
 | `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_creatives_to_meta` | Group creatives from several tasks (or raw media) into ONE paused Meta campaign across multiple ad sets |
+| `publish_to_meta` | Create a Meta Ads campaign from a task (always PAUSED) after selecting exact `portfolioId`, `adAccountId`, and `pageId` with `list_meta_destinations` |
+| `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 |
 | `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`) |
@@ -96,6 +101,31 @@ Sign up at [productmaker.app](https://productmaker.app) and create a key (prefix
 | `start_dropshipping_project` | Start or resume a guided dropshipping project. Idempotent, costs no credits |
 | `cost_dropshipping_project` | Save the project's costing inputs (the backend recomputes the canonical result and owns versioning) |
 | `guide_dropshipping_launch` | Read-only launch guidance: the project's phase and the single computed `nextAction`. Never activates Meta |
+| `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 |
+
+### Uploading personal media from a remote chat
+
+When a user says “sube estos archivos de mi Desktop a Meta”, the hosted MCP
+cannot open the laptop filesystem. Call `request_meta_media_upload` with its
+default `mediaKind: "mixed"`; it returns a secure one-click ProductMaker page
+for up to ten images and videos. In ChatGPT the tool may also receive top-level
+`files` references from the host, but ProductMaker treats them only as UI
+bridge metadata: it never downloads those URLs and it still requires the user
+to complete the secure upload page. Ask the user to select the files there,
+then call `check_meta_media_upload` with the returned `sessionId`. For every
+reported entry in `assets[]`, use its `mediaKind` as the creative `type` and
+its `stagingAssetId` as:
+
+```json
+{ "type": "staged", "stagingAssetId": "..." }
+```
+
+inside `publish_creatives_to_meta`. A partial batch may include only the assets
+that `assets[]` actually reports as uploaded. The browser uploads directly to
+the presigned CDN object; the chat never receives file bytes, base64, or a
+local path, and ProductMaker deletes the staging object after a successful
+paused Meta publication (or via the 24-hour TTL cleanup if the flow is
+abandoned).
 
 ## Video duration and winner review