The Playbook - PlatformDTC

The canonical autonomous flow, expressed in dtc_* tools. Each async step is followed by dtc_job_wait. Over the MCP server (https://api.platformdtc.com/mcp) every change gets an idempotency key automatically, so a retried call never runs twice. For a ready-made skill that walks an agent through setting up a store, see platformdtc.com/SKILL.md.

Build the store from a brief

dtc_create_store { name:"Aurora Skincare",
                   brief:"minimalist sage skincare, 6 products" }
  → { job_id:J1 }
dtc_job_wait { job_id:J1 } → { status:"succeeded", result:{ project_id:P1, preview_ready:true } }

“Make me a store like https://example.com”: add like_url:"https://example.com". The store is an exact clone of that site, for the merchant to replace its text and pictures before publishing.

Populate the catalog

dtc_bulk_import_products { products:[…6, each with options + variants…], approved_apply:true }   # after the merchant approves the list
  → { created_count:6, failed_count:0, results:[…] }   # check every item

Find products to add with dtc_search_catalog.

Publish to live (spend-adjacent)

dtc_publish_project { project_id:P1 } → J3
dtc_job_wait { job_id:J3 } → { result:{ production_url:"https://aurora.…" } }

Requires store:publish; may return pending_approval.

Connect ads

The merchant connects their ad accounts in the PlatformDTC dashboard. It needs them to sign in to the ad platform, so an agent can’t do this step.

Create & send a campaign (spend)

dtc_create_campaign { type:"EMAIL", name:"Launch", subject:…, email_html_content:… } → { campaign_id:C1 }
dtc_send_campaign { campaign_id:C1 }
  → { status:"queued" }                # or "pending_approval" → tell the user, wait

Monitor ROAS and decide

dtc_get_dashboard_analytics { range:"7D" } → { revenue, orders, ad_spend, roas }
dtc_get_ad_insights { range:"7D" }         → per-account spend / ROAS

Use the numbers to choose the next action (scale, pause, restock).

This is the same sequence the launch blog post walks through. Every tool here maps to a real endpoint in the API Reference.