@productmaker/mcp 2.4.0 → 2.8.3

package/README.md

@@ -85,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`) |
@@ -100,6 +103,30 @@ Sign up at [productmaker.app](https://productmaker.app) and create a key (prefix
 | `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
 
 `create_product_task` and `generate_video_creative` accept `durationSeconds`: