@productmaker/mcp 2.4.0 → 2.9.1

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` | Start secure staging for up to ten mixed image/video files from the user's laptop; accepts an optional `maxFiles` limit, ChatGPT can pass optional top-level `files` references from the same message into the inline App bridge, other MCP App hosts use the inline picker, and the external ProductMaker page remains fallback only |
+| `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,36 @@ 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 directly. Call `request_meta_media_upload`
+with its default `mediaKind: "mixed"`. The primary path is the inline MCP App:
+in ChatGPT, the same user message may contribute top-level `files` references;
+in other MCP App hosts, the user can still pick the files from the inline
+widget. The inline device picker sends `File` objects directly to ProductMaker's
+private staging CDN; it does not upload them to the host first. ProductMaker
+treats any `files` references only as UI bridge metadata:
+it never downloads those URLs itself, never forwards them to the API, and never
+asks the user for a CDN URL, local path, bytes, or base64.
+
+If the host lacks the bridge/picker capabilities, fall back to the external
+ProductMaker upload page returned by the tool. Once the user finishes staging,
+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`: