@jclvsh/dropspace 2.29.0 → 2.30.0

package/dist/commands/boosts.js

@@ -8,7 +8,8 @@ export function registerBoostCommands(program, client) {
         .requiredOption("-b, --daily-budget-cents <n>", "daily budget in cents (100 - 10000 = $1 - $100)")
         .requiredOption("-d, --duration-days <n>", "campaign duration in days (1 - 7)")
         .option("--platform <platform>", "ad platform: facebook | instagram", "facebook")
-        .option("--objective <objective>", "campaign objective (phase 1: engagement)", "engagement")
+        .option("--objective <objective>", "engagement | traffic (link clicks, facebook posts only)", "engagement")
+        .option("--max-cpc-cents <n>", "pause when the average cost per click passes this many cents")
         .option("--ad-account-id <id>", "explicit meta ad account id (e.g. 'act_123'); defaults to the first active one")
         .action(async (opts) => {
         try {
@@ -20,6 +21,8 @@ export function registerBoostCommands(program, client) {
             };
             if (opts.adAccountId)
                 body.ad_account_id = opts.adAccountId;
+            if (opts.maxCpcCents)
+                body.stop_rules = { max_cpc_cents: parseInt(opts.maxCpcCents, 10) };
             const result = await client.post(`/launches/${opts.launchId}/boost`, body);
             formatOutput(result, getFormat(program.opts()));
         }

package/dist/tools/boosts.d.ts

@@ -1,7 +1,7 @@
 /**
  * Launch boost MCP tools — paid amplification of organic Facebook launches.
  *
- * Phase 1: facebook only, engagement objective, auto-targeting. API key auth.
+ * Engagement or traffic objective, optional cost-per-click stop rule, auto-targeting. API key auth.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { DropspaceClient } from "../client.js";

package/dist/tools/boosts.js

@@ -1,13 +1,15 @@
 /**
  * Launch boost MCP tools — paid amplification of organic Facebook launches.
  *
- * Phase 1: facebook only, engagement objective, auto-targeting. API key auth.
+ * Engagement or traffic objective, optional cost-per-click stop rule, auto-targeting. API key auth.
  */
 import { z } from "zod";
 const platformSchema = z
     .enum(["facebook", "instagram"])
     .describe("ad platform — facebook or instagram (IG boost requires the IG business account linked to one of the user's facebook pages)");
-const objectiveSchema = z.literal("engagement").describe("campaign objective (phase 1: engagement only)");
+const objectiveSchema = z
+    .enum(["engagement", "traffic"])
+    .describe("engagement optimizes for reactions on the post; traffic optimizes for clicks on the link of a facebook link post (no photos or video)");
 const launchIdParam = z.string().uuid().describe("launch ID to boost — must have a successful facebook post");
 const boostIdParam = z.string().uuid().describe("boost ID");
 export function registerBoostTools(server, client) {
@@ -26,6 +28,13 @@ export function registerBoostTools(server, client) {
             .string()
             .optional()
             .describe("explicit meta ad account id (e.g. 'act_123'). defaults to the first active ad account."),
+        max_cpc_cents: z
+            .number()
+            .int()
+            .min(10)
+            .max(10000)
+            .optional()
+            .describe("pause the boost when its average cost per click passes this many cents. it also always pauses when click-through falls below half its first day"),
     }, async (args) => {
         try {
             const result = await client.post(`/launches/${args.launch_id}/boost`, {
@@ -34,6 +43,7 @@ export function registerBoostTools(server, client) {
                 duration_days: args.duration_days,
                 objective: args.objective ?? "engagement",
                 ...(args.ad_account_id ? { ad_account_id: args.ad_account_id } : {}),
+                ...(args.max_cpc_cents ? { stop_rules: { max_cpc_cents: args.max_cpc_cents } } : {}),
             });
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }

package/dist/types.d.ts

@@ -325,7 +325,7 @@ export interface Boost {
     platform: "facebook" | "instagram";
     post_id: string;
     status: "paused" | "active" | "completed" | "failed" | "canceled";
-    objective: "engagement";
+    objective: "engagement" | "traffic";
     daily_budget_cents: number;
     duration_days: number;
     meta_ad_account_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/dropspace",
-	"version": "2.29.0",
+	"version": "2.30.0",
 	"description": "MCP server and CLI for the Dropspace API",
 	"repository": {
 		"type": "git",